OkayStudy
ZH English 한국어 日本語 中文 हिन्दी বাংলা اردو Español Português Français Deutsch Русский العربية Bahasa Indonesia Tiếng Việt ไทย Türkçe

如何开启通知

此浏览器或网址无法使用通知。请使用支持通知的浏览器，通过安全连接访问SONUB。

如果通知被屏蔽，请在浏览器设置中允许通知。

  1. 打开地址栏旁的站点设置或浏览器的站点设置，将此网站的通知设为允许。
  2. 在设备设置中允许浏览器发送通知，并检查勿扰模式或专注模式。
  3. 返回SONUB，刷新页面，然后通过铃铛开启通知。

在iPhone或iPad上，将SONUB添加到主屏幕，从主屏幕打开后允许通知。

Claude Code — 在终端中工作的 Anthropic 智能体式编程工具

安装 ，完成第一项任务，再通过四个阶段标签逐步提高。复制适合你电脑的安装，马上开始。

进阶 — 每天的习惯：指令文件、权限、上下文

已经安装好并完成了第一个任务 — 现在来养成每天都会用到的习惯。学习项目指令（）、许多 一起读取的 、和模式、保持整洁、好好提问，最后动手练习。 其中最先要做的是连接 — 让 自己打开并检查改过的页面。

浏览器连接 — 让 Claude 自己打开并检查改过的页面

做网页相关的工作时， 在连接浏览器的状态下表现最好。它修改、打开 、通过点击和输入走完流程、读取控制台错误和 ，再修好出错的地方 — 整个循环不需要你插手。不只相信 "测试通过" 这句话，而是在真实页面上确认 — 这就是一定要使用浏览器连接的原因。

Claude 会打开工作（每个归入一个标签页组），并直接使用你浏览器的登录状态。所以不用另外连接 ，也能在你已经登录的管理后台、Google Docs、Gmail 等里工作。它可以在哪些网站上点击和输入，由 的网站权限决定。

  • 实时 — 直接读取控制台错误和 DOM 状态，修改导致问题的代码。
  • 检查设计 — 打开页面，看是否与一致，在宽屏和窄屏上是否会错乱。
  • 测试网页应用 — 把校验、登录、下单等用户流程一直走到最后。
  • 在已登录的网站上工作 — 修改后台设置、填写表单、上传你电脑里的文件、从页面提取并保存为文件。
  • 记录 — 把做过的操作录成 ，或把保存为文件，附在报告里。
claude --chrome

# inside Claude Code
/chrome    # Status: Enabled · Extension: Installed · "Enabled by default"
/mcp       # claude-in-chrome → View tools

I changed the login form validation. Open localhost:3000/login,
submit it with an empty email, and check that the error message
appears and the console has no errors. Fix anything that is wrong.

@browser go to localhost:3000 and check the console for errors

没反应时，在 /chrome 里选择 Reconnect extension。如果扩展和 Claude Code 登录的是不同的账号或组织，会出现 "Browser extension is not connected"（用 /status 查看组织）。会挡住浏览器 — 请自己关掉，再告诉 Claude 继续。浏览器工具会一直加载，所以会多占一点上下文，但做网页工作时一直开着要好得多。

模型和努力程度 — 该用哪个(推荐：Opus 5.5，High)

截至2026年11月，开发请用 Opus 5.5，强度选 High。它的默认强度是 medium，所以请按下面的方法设置，或运行 / opus 和 /effort high。所有模型和强度，以及什么时候调低、什么时候调高，都在工具大师的“推荐用法”里。

~/.claude/settings.json
{
  "model": "opus",
  "effortLevel": "high"
}
Terminal
claude --model opus --effort high

# inside Claude Code
/model opus
/effort high

CLAUDE.md — 每次会话都会读取的项目指令

CLAUDE.md 是 Claude Code 每次会话开始时都会读取的 文件。把你懒得反复说的内容写进去：构建和、代码、绝对不能做的事。运行 ，它会阅读项目并写出第一版 CLAUDE.md。放在多个位置的 CLAUDE.md 不会互相覆盖 — 它们会被一起读取。

  • ~/.claude/CLAUDE.md — 适用于所有项目的个人指令
  • ./CLAUDE.md 或 ./.claude/CLAUDE.md — 团队共享的项目指令（到 ）
  • ./CLAUDE.local.md — 只有你在这个项目里使用的指令（加入 ）。但只要有一个，AGENTS.md 就不会被读取
  • 里的 CLAUDE.md — Claude 读取或编辑该文件夹里的文件时也会读取。.claude/rules/ 里的规则文件可以用 paths 只对特定文件生效
CLAUDE.md
# My App

## Commands
- Install: npm install
- Test: npm test
- Lint: npm run lint

## Rules
- TypeScript strict mode. Do not use `any`.
- Put new API routes in src/routes/.
- Never edit files in vendor/.
- Run the tests before you say a task is done.

@docs/architecture.md

保持简短（官方文档建议少于 行）。它每次都会被读取，太长的文件会占用空间，还会把重要的规则淹没。/memory 会显示已加载的指令文件并打开它们供你编辑，@path（比如 @docs/architecture.md）可以引入另一个文件。如果你同时使用多个 AI，最好在项目里只放 AGENTS.md，而不是 CLAUDE.md — 请看紧接着的下一节。

只用 AGENTS.md — 让所有 AI 按同一份指令工作

为什么要这样做？如果一个项目在 Claude Code 之外还用 、、 等其他 AI，每个工具各自的指令文件很快就会变得不一致。AGENTS.md 是许多都会读取的开放格式。把规则在 AGENTS.md 里写一次，无论你用哪个 AI，大家都遵守同样的指令。下面的方法正是为此而存在 — 让一个项目里的多个 AI 通过 AGENTS.md 使用同一份指令。

Claude Code 也能直接读取 AGENTS.md（v2.1.277 或更高），但方式和 CLAUDE.md 不太一样。

  • 在默认设置下，只有当工作文件夹及其上层任何文件夹里都没有 CLAUDE.md、./CLAUDE.md 或 时，它才会读取 AGENTS.md。只要为个人笔记加一个 CLAUDE.local.md，AGENTS.md 就不再被读取（~/.claude/CLAUDE.md 和 .claude/rules/ 在这里不算）。
  • 子文件夹里的 AGENTS.md 只有在 Claude 用 Read 工具打开那里的文件时才会被读取。如果它直接往那个文件夹写新文件，可能还不知道那些规则。子文件夹里的 CLAUDE.md 在读取、写入和编辑时都会被读取。
  • AGENTS.local.md、 和 ./ 文件夹下的文件都不会被读取，用 --add-dir 添加的文件夹里的 AGENTS.md 也不会。

最好的方法是在项目文件夹里完全不用 CLAUDE.md，只用 AGENTS.md。这样，你的指令 ~/.claude/CLAUDE.md 仍会默认被读取，而在项目文件夹里使用的是 AGENTS.md。Codex 等其他 AI 也读取同一个 AGENTS.md，所以规则只需在一个地方修改 — AGENTS.md。

但只要你在任何一个地方使用 CLAUDE.md — 项目文件夹、、或子文件夹 — 就必须在所有文件夹里都使用 CLAUDE.md。只要工作文件夹或其上级有一个 CLAUDE.md，Claude Code 就不会读取 AGENTS.md，所以混着用会导致有些文件夹的规则被读取，有些文件夹的规则被漏掉。这种情况下如果仍想使用 AGENTS.md，只要在每个 CLAUDE.md 里加一行 @AGENTS.md 即可。@path 是把文件内容引入到该位置的语法，官方文档也说明，这种引入绝不会让 Claude 把 AGENTS.md 读两遍。

  1. 在项目顶层的 AGENTS.md 里写共享规则（安装和测试命令、代码规则、不能做的事）。也可以用 Codex 的 /init 来创建它。
  2. 不要在项目里（当前文件夹、上级文件夹、子文件夹都不行）创建 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md。
  3. 把你用于所有项目的个人指令放在 ~/.claude/CLAUDE.md — 它总是和 AGENTS.md 一起被读取。
  4. 如果某个子文件夹有自己的规则（比如 api/），也在那里放一个 AGENTS.md。
  5. 在 Claude Code 里打开 /memory，确认 AGENTS.md 已加载。如果你决定使用 CLAUDE.md，还要确认每个文件夹的 CLAUDE.md 里都有一行 @AGENTS.md。
Best — AGENTS.md only
~/.claude/CLAUDE.md    ← your personal rules (still loaded by default)

my-project/
├── AGENTS.md          ← shared rules for every AI (Claude Code, Codex, Cursor, Gemini …)
└── api/
    └── AGENTS.md      ← rules only for api/

(no CLAUDE.md anywhere in the project)
If you use CLAUDE.md anywhere — put one in every folder
my-project/
├── AGENTS.md
├── CLAUDE.md          ← @AGENTS.md
└── api/
    ├── AGENTS.md
    └── CLAUDE.md      ← @AGENTS.md
CLAUDE.md
@AGENTS.md

值得了解的事和其他方法。① 只用 AGENTS.md 时，子文件夹的 AGENTS.md 会在 Claude 用 Read 打开该文件夹里的文件时被读取。② 在 /config 里把 Project instructions 设为 claude-md-and-agents-md，每个文件夹的 AGENTS.md 会紧接着它的 CLAUDE.md 被读取。③ （ln -s AGENTS.md CLAUDE.md）也可以，但如果有人用 ，一行 @AGENTS.md 更安全。

权限和模式 — 决定哪些事不用问就能做

Claude Code 在编辑文件或运行命令之前会先问你。如果每次批准同样的事情让你觉得麻烦，就把它变成规则，并根据工作切换模式。

  • — 切换模式：default（每次都问）→ （编辑文件不用问）→ plan（只读并展示计划）。如果你是以 auto 模式启动的，第一次按下会切换到 default。
  • /permissions — 查看和编辑 allow、ask、deny 规则，以及每条规则来自哪个文件。
  • 放团队共享的规则（提交它），.claude/settings.local.json 放只有你用的规则，~/.claude/settings.json 放适用于你所有项目的规则。
  • 规则按 deny → ask → allow 的顺序检查。在任何地方被 deny 的事，在别处都无法 allow，所以要用 deny 挡住 这样的机密文件。
.claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

（--dangerously-skip-permissions）会关闭所有检查。只在出问题也无所谓的地方使用，比如不能上网的或。

管理上下文 — 当对话变长时

Claude 一次能看到的量（）是固定的。对话、读过的文件和命令输出都会堆积在那里，满了之后前面的部分会被总结。对话越长，前面的指令就越模糊，所以要养成整理的习惯。

  • /context — 用彩色方块查看是什么占用了上下文、占了多少。
  • /compact — 总结到目前为止的对话来腾出空间。你可以说明要保留什么（比如 /compact 重点保留登录 的修复）。
  • — 开始不相关的工作时，开启一个全新的对话。
  • claude -c 继续这个文件夹里的上一次对话，claude -r 或 可以选一个更早的对话继续。
  • 按两次 （或 /rewind）— 从列表中选一个更早的时间点，把对话和代码都过去。用 删除或移动的文件不会恢复，所以它不能代替 Git 提交。

一个对话只做一件事。工作换了，用 /clear 重新开始是最简单的整理方法。

节省上下文 — SONUB 标准：约 400k 时自动压缩，基础上下文不超过 6%

每次你提出请求，Claude 都会重新读取当前的整个上下文。上下文越大，每次请求花的 就越多。所以用 (自动压缩)，只用约 400k token 工作，而不是用满 1M，并把对话开始前就已占用的基础上下文(默认、技能、 等)保持在 6% 以下。这样可以大幅减少用量。 约 400k 和 6% 是 SONUB 自己定的经验标准，不是官方推荐值——官方文档只说明设置方法。

  • /autocompact 444k — 上下文达到 444k token 时自动压缩。它会保存到当前模型的用户设置中，用 /autocompact auto 恢复。
  • 要用于所有模型，就在 ~/.claude/settings.json 中加入 "autoCompactWindow": 444000(见下例)。只用一次时，用 claude --autocompact 444k 启动。
  • 打开新对话后立刻运行 /context。还没提任何请求就已占用的部分 — 系统提示词、系统工具、MCP 工具、技能、(CLAUDE.md · AGENTS.md)— 就是基础上下文，合计应不超过 6%。
  • 超过 6% 就精简 — 在 /mcp 中关闭不用的 ，删掉不用的技能和，CLAUDE.md · AGENTS.md 只留下真正需要的规则。
~/.claude/settings.json
{
  "autoCompactWindow": 444000
}

基础上下文会随每次请求一起发送，所以哪怕只省几个百分点，也会在整段对话中累积，大幅减少用量。即使还没压缩，工作一换就用 /clear 重新开始，是最大的节省。

好好提问 — 在哪里、做什么、怎么检查

好的请求有三个部分：在哪里（文件和文件夹）、做什么（你想要的行为）、怎么检查（测试、命令、画面）。这三点越清楚，Claude 就越少走弯路，也越会自己检查结果。

  • 模糊的请求：“修一下登录”
  • 清楚的请求：“在 @app//Controllers/LoginController.php 里，密码错误时会出现 500 错误。改成返回 422 和，在 tests/Feature/LoginTest.php 里加一个测试，并确认测试通过。”
  • 输入 @ 选择文件并附加到请求里（@src/login.ts）。
  • 错误画面和设计稿，可以粘贴或拖入截图。
  • 大任务先说“先阅读，只给我看计划 — 暂时什么都不要改”，或者用 /plan 进入。
  • 遇到难题时，在 /model 里提高模型和，或者在请求里写上 ，让它只在这一轮更深入地思考。
  • <终点线> — 不用再提新请求，Claude 会一轮接一轮地工作，直到达到终点线（例：/goal tests/ 里的测试全部通过, or stop after 20 ）。只输入 /goal 查看状态，/goal clear 删除。

最佳实践 — Anthropic 推荐的 Claude Code 用法

简单说：给 Claude 一个能自己检查的办法，难的事先做计划，请求要具体，CLAUDE.md 要简短，任务之间清空上下文。两份官方指南里的六个好习惯，以及 Claude Code 和 Codex 的命令，都在“推荐用法”里。

常见错误 — 以及如何纠正

官方指南警告了五种失败模式——什么都塞的会话、反复纠正、过长的 CLAUDE.md、不检查就相信、没完没了地探索。两份指南里的十个常见错误及改正方法，都在“推荐用法”里。

进阶练习 — 在你自己的项目里试试

  1. 在你的项目顶层创建 AGENTS.md，写上测试命令和三条规则，并确认项目里没有 CLAUDE.md。
  2. 打开 /memory，确认 AGENTS.md 和 ~/.claude/CLAUDE.md 都已加载。
  3. 在 .claude/settings.json 里 allow 一个测试命令、deny .env，然后用 /permissions 确认。
  4. 在计划模式下请求一个小功能，阅读并调整计划，然后批准。
  5. 用 /context 查看用了多少，用 /compact 压缩后再看一次。

五项都做完了？进入 [高级] 标签。

官方文档

已于 2026-10-19 对照官方文档核实。这些工具变化很快 — 如果命令不起作用，请查看官方文档。

Claude Code 实践 Sonub Lab — Claude Code 实践 一边阅读 Claude Code 指南，一边在旁边的终端里练习。可以用 Sonub Lab 服务器上免费、无需安装的 Sonub 编程智能体，或你电脑上的 Claude Code。
继续前进

请选择要取消的待付款预约。每次取消都需要确认。

你所在国家的时间:

关闭