Claude Code 中文使用手册

Claude Code 是 Anthropic 的编程代理。它以终端会话为核心，也可以连接 IDE、启动后台代理、创建 Worktree、使用 Chrome 或 Remote Control，并通过 MCP、技能、代理、Hooks 和插件扩展工作流。

SuperToken 中文整理版 · 核对日期 2026-07-15 · 当前模型 Fable 5 / Opus 4.8 / Sonnet 5 · 实测 CLI 2.1.209 · 非 Anthropic 官方译本

本版证据边界

本版已重新读取 Anthropic 当前 Model configuration、Desktop、VS Code 与 What's New 官方页面，并与本机 CLI 2.1.209 的 --help 交叉核对。模型是否出现在选择器中仍受账号、组织、provider、地区与数据保留策略影响，不能把一个账号的界面外推给所有用户。

先选对入口

入口	当前已确认能力	最适合	边界
Claude Desktop Code	Local、Remote、SSH、WSL、可视化 diff、终端、文件与 Browser pane	多会话、图形审查和本地/远程项目	订阅、组织策略与 Desktop 版本会影响入口和模式
CLI	交互、计划、权限、恢复、非交互、MCP、插件	本地仓库和终端工作流	需要你自己检查 Git diff 和命令输出
IDE 连接	`claude --ide` 在只有一个有效 IDE 时自动连接	编辑器项目与终端开发循环	当前帮助未说明选区怎样注入，本版不写未复核的面板按钮
Background agents	`claude --background` 与 `claude agents`	独立、可并行的后台任务	仍共享外部资源和权限边界
Worktree + tmux	`--worktree`，可配 `--tmux`	隔离 Git 修改和并行开发	不隔离数据库、端口、缓存或云账号
Remote Control	`--remote-control [name]`	订阅账号登录后的远程续接	当前 CLI 明确要求 claude.ai 订阅登录；可用性因账号而异
Chrome	`--chrome` / `--no-chrome`	使用登录态测试网页和读取控制台	站点授权与敏感动作仍需单独确认；第三方 provider 可用性不同
Ultrareview	云端多代理审查当前分支、PR 或基线	独立代码审查	属于云端能力，账号和网络可用性需单独确认

第一次使用建议从 CLI + plan 权限模式 开始。它最容易看清目录、命令、权限请求和验证结果。

当前模型基线

Anthropic 官方名称是 Fable 5，不是“Fable 5.0”。best 在组织有权限时选择 Fable 5，否则回退到最新 Opus；fable 明确选择 Fable 5；Anthropic API 下 opus 当前映射到 Opus 4.8，sonnet 当前映射到 Sonnet 5。第三方 provider 的别名映射可能不同，详见 Desktop、IDE 与远程接续。

10 分钟完成第一次任务

1. 在可信仓库启动

bash

cd /path/to/your-project
git status --short --branch
claude --permission-mode plan

第一次进入项目时，只信任来源明确、内容可审查的仓库。项目配置、Hooks、MCP 和技能都可能参与后续工作。

预期结果：Claude Code 进入 plan 模式；当前目录和原有未提交修改已经明确。

2. 只读建立事实

text

先不要修改文件。请检查这个项目并报告：
1. 产品目标、主要入口和模块边界；
2. 安装、测试、类型检查和构建命令分别来自哪里；
3. 当前 Git 状态中哪些改动已经存在；
4. 如果只修复 README 一处错别字，最小验证是什么。

不要读取或输出 .env、密钥和账号信息。结论引用具体文件。

提示词里的“不要读取”是行为要求，不是强制访问控制。仓库中确实存在密钥时，应把密钥移出工作区，或同时配置精确 deny 规则与外部文件隔离。

预期结果：Claude 先读文件和 Git 状态，没有产生新 diff；命令来自项目配置而不是猜测。

3. 确认计划再实现

text

只修复刚才确认的那一处错别字。
不要改写段落，不调整格式，不修改其他文件。
完成后显示完整 diff，运行最小验证，并报告实际执行的命令与结果。

切换到默认或合适的编辑权限前，先检查计划中的目标文件和命令。不要为了一个文档修改启用宽泛 Bash 或跳过所有权限。

4. 独立验收

bash

git diff -- README.md
git status --short

确认：

只有目标行发生变化。
原有未提交修改仍在，没有被覆盖或还原。
验证命令确实运行并返回结果。
Claude 明确区分已验证、人工检查和未验证项。

第一次不要这样做

不从主目录或包含多个项目的上级目录启动。
不把 --dangerously-skip-permissions 当成“减少弹窗”的普通选项。
不在没看 diff、没验证时让 Claude 自动提交、推送或发布。
不把整个 .env、Token、浏览器会话或客户数据交给提示词、MCP 或日志。
不在根因仍是猜测时连续修改生产代码。
不因为 Worktree 或后台代理存在，就假设数据库和外部服务已经隔离。

手册怎么读

你的目标	阅读
掌握安装、信任、权限、上下文、恢复和非交互	CLI 使用
使用 Desktop、IDE、Background、Worktree、Remote Control、Chrome 或 Ultrareview	Desktop、IDE 与远程接续
配置 CLAUDE.md、settings、MCP、Skills、Agents、Hooks 和 Plugins	项目与团队定制
跟着完整案例练习 Bug、功能、重构、审查和自动化	项目实战
解决安装、认证、权限、上下文、MCP、IDE 或网关错误	故障排除与速查

当前 `2.1.209` 能力地图

类别	已由本机 CLI 确认
会话	`--continue`、`--resume`、`--fork-session`、`--from-pr`、`--name`
认证	`auth login`、`auth logout`、`auth status`、`setup-token`
入口	`--ide`、`--chrome`、`--remote-control`、`--background`
隔离	`--worktree`、`--tmux`、`--add-dir`
权限	`manual`、`acceptEdits`、`plan`、`dontAsk`、`auto`、`bypassPermissions`
自动化	text / json / stream-json、JSON Schema、工具集合限制、allow/deny、预算上限、effort、Hook events
定制	CLAUDE.md、settings、MCP、skills、agents、plugins、Hooks
诊断	`doctor`、`auto-mode defaults/config`、`--safe-mode`、`--bare`、debug 日志
审查	本地提示词审查、`ultrareview` 云端多代理审查

一条成熟的日常工作流

确认仓库、分支、已有修改和权限模式。
在 plan 模式建立事实和复现路径。
明确目标、边界、修改文件、失败状态和验证命令。
小步实现，及时纠正越界修改。
检查完整 Git diff，不只看最终回答。
运行真实测试、类型检查、lint、构建或界面验证。
列出证据、失败、未验证项和剩余风险。
把稳定项目事实写进 CLAUDE.md，把重复流程放进技能或插件。

Claude Code 中文使用手册 ​

先选对入口 ​

10 分钟完成第一次任务 ​

1. 在可信仓库启动 ​

2. 只读建立事实 ​

3. 确认计划再实现 ​

4. 独立验收 ​

第一次不要这样做 ​

手册怎么读 ​

当前 2.1.209 能力地图 ​

一条成熟的日常工作流 ​

官方资料 ​