Claude Code 完全实用手册：从入门到批量并行，一篇讲透

这是一篇非常扎实的实战文档，已经具备了高质量技术博文的所有要素：痛点精准、场景分类清晰、命令实用、有对比有避坑。

我帮你把原文整理成一篇结构更清晰、排版更适合发布的文章。保留了你的全部干货内容，只优化了层级、代码块标注和阅读节奏。

Claude Code 完全实用手册：从入门到批量并行，一篇讲透

别再只会 claude 一条命令走天下了

最近发现身边一堆人用 Claude Code，就会一个 claude 命令，进去了全靠嘴。

要么上下文撑爆了 不知道咋压，要么想换模型 不知道在哪换，要么脚本里想调用 不知道怎么非交互运行，要么每次改文件都弹一堆权限确认框烦死了。

更别说会话分叉、批量并行、自动修复 PR 这些高级玩法，基本上没几个人知道。

整理这篇的原因就一个：把最刚需的命令，配上真实使用场景，一次说清楚，省得你到处查。

看完这篇，你能学到：

✅ 5 种启动姿势，不同场景怎么选
✅ 上下文撑爆了怎么压，/clear 和 /compact 别再用错
✅ 模型和思考深度怎么动态调，省钱又好用
✅ 权限弹窗怎么彻底消停，三种方案对应三种场景
✅ 让 Claude 永远记住你的编码规范，再也不用重复交代
✅ /batch 并行干大活、/autofix-pr 躺着等绿灯
✅ CI 和脚本里怎么嵌进去用，管道、JSON 输出、批量处理全有
✅ 出了问题怎么排查，调试命令一套

一、打开终端，第一件事：5 种启动姿势

场景不一样，用的命令就不一样，别全用 claude 一条走。

场景一：直接开干，进交互会话

bash 复制代码

claude

最朴素的用法，进去之后就是一个对话界面，适合什么任务还没想好、先看看再说的时候。

场景二：进去就想开始一个具体任务

bash 复制代码

claude "帮我看看这个项目的整体结构，给我一个概览"

带上初始 prompt 启动，进去直接干活，不用再手打一遍。

场景三：昨天聊了一半，今天接着搞

你昨天花了半小时跟 Claude 交代清楚了背景、需求、限制条件，今天不想再说一遍：

bash 复制代码

claude -c

-c 是 continue，继承上次这个目录里的对话，上下文全在。

如果你同时跑好几个任务，想恢复某个具体的：

bash 复制代码

claude -r "auth-refactor" "继续，把单元测试也补上"

按名字恢复，直接带上今天要干啥，不用先进去再打指令。

场景四：写脚本或 CI 里跑，不需要交互

bash 复制代码

cat error.log | claude -p "帮我分析这堆报错的根本原因，给出排查方向"

-p 是 print mode，执行完自动退出，不会等你输入。这是 Claude Code 在自动化场景里的正确用法。

场景五：隔离环境里折腾，不影响主分支

bash 复制代码

claude -w feature-auth

-w 是 worktree，Claude 会在独立的 git worktree 里工作，改啥都不影响主分支。

加 --tmux 还可以开一个专属 tmux 窗口：

bash 复制代码

claude -w feature-auth --tmux

二、上下文快撑爆了，但任务还没做完

用 Claude Code 干活久了一定会遇到：对话越来越长，响应越来越慢，甚至出现截断。

这时候很多人直接 /clear 重开，其实是错的。

保留对话，只压缩释放空间

bash 复制代码

/compact

Claude 把前面的对话压缩成一个摘要，继续往下聊。可以加说明，告诉它哪些是重点：

bash 复制代码

/compact 重点保留认证模块的讨论细节，接口设计不要压缩，其他可以压

彻底开新对话

bash 复制代码

/clear

上下文清空，全新开始。原来的对话随时可以 /resume 找回来。

/clear 和 /compact 的核心区别：一个是新建，一个是压缩同一个，别用错。

查看上下文占用

bash 复制代码

/context

弹出一个彩色格子可视化图，一眼看出哪些工具、哪些文件在吃上下文，还会给优化建议。

三、换模型 or 调思考深度

会话里临时换模型

bash 复制代码

/model

不带参数弹出选择器，上下键选，回车确认。也可以直接指定：

bash 复制代码

/model opus
/model claude-sonnet-4-6

启动时就指定模型

bash 复制代码

claude --model opus
claude --model claude-sonnet-4-6

调整努力级别（控制思考深度和 Token 消耗）

这个很多人不知道。--effort 可以控制 Claude 在这个任务上"花多大力气"：

bash 复制代码

claude --effort low      # 快速回答，适合简单问题
claude --effort high     # 深度分析，适合复杂架构问题
claude --effort xhigh    # 更深，适合难搞的 bug 排查

会话里也可以随时调：

bash 复制代码

/effort high
/effort

不带参数弹交互滑块，左右键调，实时生效。

同一个任务，low 和 xhigh 的回答质量差距很明显。遇到搞不定的问题先试试调高 effort，不要上来就换模型。

四、权限弹窗烦死了，彻底消停

场景一：完全信任这个任务

bash 复制代码

claude --dangerously-skip-permissions

跳过所有权限确认，Claude 想改啥就改啥。在你完全清楚任务范围时用。

场景二：先只让分析，不让动文件

bash 复制代码

claude --permission-mode plan

计划模式，Claude 只能读文件、思考、输出方案，零风险。会话里也用 /plan 进入。

场景三：细粒度控制

允许特定操作，其他还是要确认：

bash 复制代码

claude --allowedTools "Read" "Bash(git log *)" "Bash(git diff *)"

直接禁掉某些工具：

bash 复制代码

claude --disallowedTools "Bash(rm *)"

自动模式（日常最推荐）：

bash 复制代码

claude --permission-mode auto

auto 模式会自动减少弹窗，只在真正有风险的操作上提示。

五、让 Claude 永远记住你的编码规范

方法一：启动时追加规则

bash 复制代码

claude --append-system-prompt "所有代码用 TypeScript，禁止用 any，函数注释写中文"

规则多了写成文件：

bash 复制代码

claude --append-system-prompt-file ./team-coding-rules.txt

方法二：彻底替换系统提示

bash 复制代码

claude --system-prompt "你是一个专注 Java 后端的技术专家..."

完全替换，慎用。

方法三：初始化 CLAUDE.md（最推荐）

bash 复制代码

/init

Claude 帮你生成 CLAUDE.md 文件，放在项目根目录。以后每次启动自动读取，再也不用重复交代。

方法四：管理个人记忆

bash 复制代码

/memory

管理个人级别的记忆，可以跨项目记住你的个人偏好。

六、想看 Claude 改了什么

交互式 diff 查看器

bash 复制代码

/diff

弹出一个可视化的 diff 界面，比 git diff 可读性强多了。

回退到某个节点

bash 复制代码

/rewind

弹出对话历史，选一个节点回退，会话状态和代码改动都一起回退，是真正的"悔棋"。

对话分叉

bash 复制代码

/branch 试试用缓存层解决这个问题

从当前节点分叉出去，在分支里折腾，主线不动，两条路都可以走。

七、代码改完，质量把关

代码简化 / 重构审查

bash 复制代码

/simplify

并行跑三个审查 Agent，结果汇总之后直接帮你修。

聚焦某个方向：

bash 复制代码

/simplify focus on reducing duplication
/simplify focus on memory efficiency

安全审查

bash 复制代码

/security-review

自动分析当前分支的改动，找 SQL 注入、XSS、敏感数据泄露等问题。

Review PR

bash 复制代码

/review
/review 123
/review https://github.com/org/repo/pull/456

八、大规模并行改动：`/batch`

这是 Claude Code 里最被低估的功能。

场景：把整个项目从 CommonJS 改成 ESM

bash 复制代码

/batch migrate src/ from CommonJS to ESM

Claude 会先分析代码库，把任务拆成 5-30 个独立工作单元，每个单元各派一个后台 Agent 在独立的 git worktree 里并行执行，做完自动跑测试、开 PR。

其他适合的场景：全局替换 API 调用、批量补单元测试、统一日志调用、删除废弃 TODO......

查看后台任务

bash 复制代码

/tasks

九、CI 自动修复 PR

bash 复制代码

/autofix-pr

Claude 会在云端开一个 session，自动监听你这个 PR 的 CI 状态和 reviewer 评论，有失败就自动修，修完直接 push。

加限定条件：

bash 复制代码

/autofix-pr only fix lint and type errors, don't touch the logic

需要你装了 gh CLI，且账号有 Claude Code on the web 权限。

十、会话管理，同时跑多个任务

启动时起名

bash 复制代码

claude -n "订单模块重构"
claude --name "修复登录 bug"

会话里改名

bash 复制代码

/rename feature-auth-final

恢复具体会话

bash 复制代码

/resume

导出会话记录

bash 复制代码

/export
/export ./auth-refactor-notes.txt

十一、脚本和 CI 里用 Claude Code

基础非交互调用

bash 复制代码

# 管道输入
cat error.log | claude -p "分析这堆报错，给出优先级排序"

# 直接传文件内容
claude -p "review 这段代码的安全性：$(cat src/auth.ts)"

控制花费和轮次

bash 复制代码

claude -p --max-budget-usd 3.00 "帮我重构这个模块"
claude -p --max-turns 10 "自动修复所有 lint 错误"
claude -p --max-budget-usd 5.00 --max-turns 20 "分析整个项目"

裸模式，启动更快

bash 复制代码

claude --bare -p "检查这段代码有没有明显的 bug"

输出 JSON

bash 复制代码

claude -p "列出所有对外 API 接口" --output-format json

批量处理多个文件

bash 复制代码

for f in src/**/*.ts; do
  result=$(cat "$f" | claude -p "检查这个文件有没有安全漏洞")
  if [ -n "$result" ]; then
    echo "=== $f ===" >> security-report.txt
    echo "$result" >> security-report.txt
  fi
done

十二、几个小但有用的命令

问旁路问题，不污染主对话上下文

bash 复制代码

/btw 这里的 interface 和 type 在 TypeScript 里有啥本质区别

回答不会被计入主对话的上下文。

复制最后一条回复

bash 复制代码

/copy
/copy 2

有代码块时弹出选择器，可以只复制某个代码块。

查看当前会话花费

bash 复制代码

/usage

版本和更新

bash 复制代码

claude -v
claude update
claude install stable

登录和认证

bash 复制代码

claude auth login
claude auth login --console
claude auth status --text
claude auth logout

清理项目本地状态

bash 复制代码

claude project purge ~/work/repo --dry-run   # 预览
claude project purge ~/work/repo -y          # 执行
claude project purge --all -y                # 清所有

十三、调试和排查

开启详细日志

bash 复制代码

claude --verbose

调试模式，过滤分类

bash 复制代码

claude --debug
claude --debug "api,mcp"
claude --debug "!statsig"

日志写到文件

bash 复制代码

claude --debug-file /tmp/claude-debug.log

诊断安装和配置

bash 复制代码

/doctor

自动检测状态，按 f 可以让 Claude 自动修复。

这些命令基本覆盖了日常 95% 的使用场景，从简单的日常交互到 CI 自动化、并行批量改动全都有。

建议收藏，用到的时候回来查。

如果你正在准备面试，推荐 ddkk.com，涵盖一万多道 Java 面试题，几乎覆盖所有主流技术题，还有市面上最全的技术五百套和精品教程，免费提供。

Claude Code 完全实用手册：从入门到批量并行，一篇讲透