• Claude directory
• Context window

目录和上下文窗口

1. 核心概念：两个存放位置

• 项目级 (your-project/.claude/)：这些设置仅对当前项目生效，通常会提交到 Git，方便团队成员共享相同的编码标准和工具。
• 全局级 (~/.claude/)：这些是你的个人偏好（如主题、编辑器设置、通用的个人插件），适用于你电脑上的所有项目，且不会分享给别人。

2. 目录下的关键文件及其作用

这篇文章通过一个“交互式浏览器”展示了目录结构：

• CLAUDE.md（核心指令）：
  • 作用：Claude 每次启动都会读取的最重要文件。
  • 内容：存放项目约定、常用构建命令、架构背景等。
  • 建议：保持在 200 行以内。
• settings.json（配置文件）：
  • 作用：控制 Claude 的行为，比如权限模式、是否启用自动记忆等。
• rules/ 文件夹（路径规则）：
  • 作用：存放特定目录或文件类型的规则。
  • 例子：比如 testing.md 专门规定如何写测试，只有当 Claude 处理测试文件时才会加载这些规则。
• skills/ 和 commands/（技能与命令）：
  • 作用：存放按需加载的自定义工作流。
  • 例子：/deploy（部署）或 /security-review（安全审查）。
• agents/（子智能体）：
  • 作用：定义专门处理特定任务的“小助手”，它们拥有独立的内存和指令。
• memory/（自动记忆）：
  • 作用：存放 Claude 自动学习到的关于项目的知识（如调试经验、你的偏好）。

3. 为什么这个目录很重要？

• 团队一致性：通过将 .claude/CLAUDE.md 提交到仓库，新加入项目的同事无需重复解释，Claude 就能立刻上手符合团队习惯的代码。
• 节省空间（上下文）：你不需要在聊天时反复叮嘱“别用这个库”，把规则写进文件，Claude 就会在需要时自动参考。
• 模块化控制：你可以根据需要只修改 CLAUDE.md 或 settings.json，其他文件夹（如 rules 或 skills）都是可选的，按需添加即可。

总结建议：

如果你是第一次配置，重点关注 CLAUDE.md 和 settings.json 即可。随着项目变复杂，再考虑将规则拆分到 rules/ 或封装成 skills/。

context-window

我帮你把这篇 context window 官方文档彻底“白话重写”，同时保留所有关键细节（包括你做开发必须知道的点）。

🧠 一句话理解 Context Window

👉 Context Window = AI 的“临时记忆（工作内存）”

不是训练数据，而是：

👉 AI 当前能“看到并记住”的所有内容

包括：

• 你之前说的话
• AI之前的回答
• 当前问题
• 以及它即将生成的内容 (Claude API Docs)

📦 一、Context Window 到底包含什么？

每一轮对话其实是这样工作的：

【输入】
= 历史对话 + 当前问题

【输出】
= AI回复（也会被加入历史）

👉 然后下一轮：

新输入 = 旧历史 + 新问题

📌 官方术语：

• Input tokens（输入）
• Output tokens（输出）

👉 全部都算进 context window (Claude API Docs)

📈 二、Context Window 是怎么增长的？

👉 有一个非常重要的机制：

✔ 线性增长（越来越大）

每聊一句：

• 不会丢历史
• 全部累加

👉 就像：

第1轮：10k tokens
第2轮：20k tokens
第3轮：30k tokens
...

📌 官方叫：

progressive accumulation（逐步累积） (Claude API Docs)

🚨 三、最大容量是多少？

默认：

👉 200,000 tokens（20万）

👉 大概相当于：

• 300~500页文档
• 几万行代码 (Claude API Docs)

高级版本（重点）

👉 1,000,000 tokens（100万）

但：

• 只在高权限 / 企业 / beta 开放
• 价格更贵 (Claude API Docs)

⚠️ 四、最关键的坑（很多人不知道）

❗不是越大越好

官方明确说：

👉 context 越大，效果可能变差（context rot） (Claude平台)

什么是 context rot？

👉 简单说：

内容太多 → AI开始“记混”

表现：

• 忘记前面重点
• 理解变模糊
• 输出变差

🔄 五、Context Window 满了会怎样？

新模型（重点）：

👉 ❌ 不会自动截断
👉 ❌ 不会偷偷删内容

👉 直接报错！

超出限制 → 请求失败 (Claude API Docs)

🧠 六、Extended Thinking（很多人忽略的点）

当你开启“深度思考”时：

👉 会多一部分隐藏内容：

• thinking tokens（思考过程）

关键机制：

✔ 会计费

👉 这些 tokens 会收费

✔ 但不会一直占空间（重点）

👉 旧的 thinking 会被自动删除：

不会进入下一轮 context (Claude API Docs)

👉 也就是说：

思考 = 用完就丢（节省空间）

🔧 七、Tool + Context（开发者必须懂）

如果你在用：

• MCP
• 工具调用（tool use）

👉 Context 会更复杂：

第一步：AI调用工具

输出包含：

• 思考
• 工具请求

第二步：你返回 tool result

👉 必须带上：

• 原始 thinking（不能改！）

否则：

❌ 会报错（签名校验失败） (Claude API Docs)

第三步：下一轮

👉 thinking 会被自动清掉

🧠 八、Context Awareness（新模型重点）

新模型（Claude 4.5）有个很重要能力：

👉 知道自己还剩多少“内存”

比如系统会告诉它：

Token usage: 35000/200000
Remaining: 165000

👉 好处：

• 不会乱写
• 会控制长度
• 更稳定完成长任务 (Claude API Docs)

🧩 九、为什么你会“突然变笨”？

你做开发时会遇到：

“刚开始很好，后面越来越乱”

👉 原因就是：

❗Context 太大了

比如：

• 大量日志
• 多文件代码
• 多轮对话

👉 官方结论：

内容质量 > 内容数量 (Claude平台)

🧪 十、开发者必须掌握的3个策略

（官方 + 实战总结）

1️⃣ 控制上下文（最重要）

👉 不要把所有东西都塞进去

✔ 保留：

• 当前任务相关代码

❌ 删除：

• 无关日志
• 旧对话

2️⃣ 分任务（非常关键）

👉 不要一次做太多事

❌ 错误：

• “帮我重构整个项目”

✔ 正确：

• 一次一个模块

3️⃣ 使用压缩（compaction）

👉 把历史总结成短内容

🧠 十一、终极理解（你一定要记住）

👉 Context Window 本质是：

AI的“RAM”，不是硬盘

对比一下：

🚀 给你的结论（结合你）

你是：

• PHP + 运维 + 自动化 + 交易系统

👉 你最容易踩的坑：

❗1. 日志太多

→ 一下吃掉 30% context

❗2. 多文件修改

→ 很快爆 200k

❗3. 长对话不清理

→ AI变“降智”

🧩 一句话总结

👉 Context Window =

AI当前能记住的所有信息（有限且会变差）

如果你愿意，我可以帮你做一套：

👉 《Claude Code 上下文管理实战方案（开发者版）》

• 如何不爆 200k
• 如何做多文件修改
• 如何做自动压缩（结合 Hooks）

这个对你做套利系统 + 自动化开发会非常关键。