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 会直接读取 AGENTS.md。
除了你写的 CLAUDE.md，Claude Code 还会自动记录一些它学到的项目经验（自动记忆），输入 /memory 可以查看和管理。
先计划，再动手
改动较大的任务，推荐这个流程：
- 按
Shift + Tab切换到plan mode on，描述任务，让它调查并给出方案。 - 审查方案，有问题就直接提出修改意见。
- 方案确定后切换到
manual mode on或accept edits on，让它执行。 - 用
git diff检查改动，运行测试，满意后提交。
管理上下文
对话越长，模型要读的内容越多，速度越慢、花费越高，也越容易被前面的内容干扰。
/clear：开始新对话。换一件事时用它。/compact：把前面的对话压缩成摘要，保留要点、腾出空间。/context：查看当前上下文的使用情况。
接着上次继续
claude -c继续当前文件夹里最近的一次对话。
claude -r列出之前的对话，选一个继续。会话中也可以用 /resume。
单次命令
不进入交互界面，直接问一个问题、拿到结果：
claude -p "用一句话总结 README.md 的内容"适合写进脚本。注意 -p 模式下没有人可以点审批，需要的权限要提前用规则配置好。
常用命令速查
| 命令 | 作用 |
|---|---|
/help | 所有可用命令 |
/clear | 新对话 |
/compact | 压缩上下文 |
/resume | 恢复之前的对话 |
/rewind | 回退到之前的检查点 |
/model | 切换模型 |
/status | 查看登录方式、模型和配置来源 |
/config | 设置菜单 |
/permissions | 查看和编辑权限规则 |
/init | 生成 CLAUDE.md |
/memory | 查看自动记忆 |
/doctor | 自检 |
和 Git 配合
- 开始一项任务前，确认工作区是干净的（
git status），或者先提交一个存档。 - 让 Claude Code 做完一件事就提交一次，说明写清楚做了什么。
- 回退菜单只能撤销 Claude 用编辑工具做的修改；Git 能把任何改动恢复到上一次提交的样子，两者配合最稳妥。