Claude Code Manual

日常工作流

掌握这几个习惯,Claude Code 会越用越顺手:让它记住项目规矩、先计划后动手、及时清理上下文、随时接着上次继续。

CLAUDE.md:给项目立规矩

每次会话开始时,Claude Code 会读取 CLAUDE.md 文件,把里面的内容当作长期指令。适合写:

  • 项目是做什么的、目录结构;
  • 怎么运行、怎么测试;
  • 团队的约定,例如“回答用中文”“不要修改 migrations 目录”。
位置作用范围
~/.claude/CLAUDE.md你所有的项目
项目/CLAUDE.md 或 项目/.claude/CLAUDE.md这个项目,可以提交到 Git 与团队共享
项目/CLAUDE.local.md这个项目,只属于你,记得加进 .gitignore

在项目里运行 /init,Claude Code 会分析项目并生成一份 CLAUDE.md 草稿,你再按需修改。

如果项目里已经有给 Codex 等工具写的 AGENTS.md,并且工作目录及其上级目录都没有 CLAUDE.md,Claude Code(v2.1.277 及以上)会直接读取 AGENTS.md;两者都有时只读 CLAUDE.md,想同时用,就在 CLAUDE.md 里引用 AGENTS.md。/init 如果发现 Codex 或 Gemini CLI 的配置,会提示是否导入。

除了你写的 CLAUDE.md,Claude Code 还会自动记录一些它学到的项目经验(自动记忆)。输入 /memory 可以编辑 CLAUDE.md、开关自动记忆和查看记忆内容。

先计划,再动手

改动较大的任务,推荐这个流程:

  1. 按 Shift + Tab 切换到 plan mode on,描述任务,让它调查并给出方案。
  2. 审查方案,有问题就直接提出修改意见。
  3. 方案确定后切换到 manual mode on 或 accept edits on,让它执行。
  4. 用 git diff 检查改动,运行测试,满意后提交。

管理上下文

对话越长,模型要读的内容越多,速度越慢、花费越高,也越容易被前面的内容干扰。

  • /clear:开始新对话(别名 /new)。换一件事时用它;如果清错了,同一次运行 Claude Code 期间,可以在 /rewind 菜单顶部找回上一个会话。
  • /compact:把前面的对话压缩成摘要,保留要点、腾出空间。
  • /context:查看当前上下文的使用情况。
  • /autocompact:设置上下文占到多满时自动压缩。

接着上次继续

claude -c

继续当前文件夹里最近的一次对话。

claude -r

列出之前的对话,选一个继续。会话中也可以用 /resume。

持续工作与并行

  • /goal 所有测试通过,并且没有新的警告:每一轮结束后由模型检查条件是否已满足,没满足就继续下一轮,适合有明确验收标准的大任务。设定的条件要能被检查出来,写得越具体越好。
  • claude agents:打开 agent view,在一个界面里查看和派发多个后台会话,看到哪些在运行、哪些在等你回答。也可以用 claude --bg 直接启动一个后台会话。后台会话要走 XAI Router 时,把接入变量写进 settings.json,见凭证与接入 XAI Router。

这两项用量大、权限风险也更高,熟悉基本流程以后再用。

单次命令

不进入交互界面,直接问一个问题、拿到结果:

claude -p "用一句话总结 README.md 的内容"

适合写进脚本。注意 -p 模式下没有人可以点审批,需要的权限要提前用规则配置好。

常用命令速查

命令作用
/help所有可用命令
/clear新对话
/compact压缩上下文
/resume恢复之前的对话
/rewind回退到之前的检查点(别名 /undo)
/diff查看工作区里的改动
/usage查看本次会话的用量(/cost 是它的别名)
/goal 条件设定一个完成条件,Claude 会连续工作到条件满足
/tasks查看和管理当前会话里的后台任务
/model切换模型
/status查看登录方式、模型和配置来源
/config设置菜单
/permissions查看和编辑权限规则
/init生成 CLAUDE.md
/memory查看自动记忆
/doctor体检并提出修复建议

和 Git 配合

  • 开始一项任务前,确认工作区是干净的(git status),或者先提交一个存档。
  • 让 Claude Code 做完一件事就提交一次,说明写清楚做了什么。
  • 回退菜单只能撤销 Claude 用编辑工具做的修改;Git 能把任何改动恢复到上一次提交的样子,两者配合最稳妥。