# Claude Code 命令速查与实战手册 Claude Code 的功能日益丰富，命令体系也日趋完善。从基础交互模式到斜杠命令、CLI 参数、权限控制，再到多样化的工作流组合，熟练掌握这些工具才能真正将这款 AI 编程助手运用自如。本手册整理了日常最核心的操作方式，方便随时查阅，助你高效开发。 ## 一、基本模型 Claude Code 基本操作：

- 输入：Prompt + 文件（--file / stdin） - 上下文：session（--resume / --continue） - 执行：单次 / 交互 / 后台 - 输出：文本 / JSON / 流式 JSON / 文件 核心原则其实就三条： 1. 输入越精准、越细致，输出越稳定。但并非越多越好，恰到好处才是关键。 2. 上下文越清晰，结果越一致。尽量减少上下文中的杂质干扰，一次只处理一件事。 3. 任务越可验证，风险越低。如果任务能通过 Claude 自身来验证，那就更放心了。 ## 二、交互式斜杠命令（Slash Commands） 在交互模式下输入 `/` 开头的命令来控制会话行为，这是日常操作中最常用的命令集合。 ### 会话控制 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/help` | 显示所有可用命令 | 包含内置命令、自定义命令和 MCP 命令 | | `/clear` | 清除当前对话上下文 | 完全重置，适合切换任务 | | `/compact [指令]` | 压缩对话历史 | 可指定保留重点，比如 `/compact 保留错误处理模式` | | `/undo` | 撤销最近一次文件更改 | 仅回退上一步，多步回退用 git | | `/exit` | 退出会话 | 等同 Ctrl+D | ### 模式切换 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/plan` | 切换至计划模式 | Claude 先给出方案，等待确认后再执行 | | `/fast` | 切换至快速模式 | 同一模型的速度优化设置，约 2x 费用 | | `/model [名称]` | 切换模型 | `/model opus`、`/model sonnet`、`/model haiku` | | `/effort [级别]` | 设置推理深度 | `low` / `medium` / `high` / `max` | ### 模型选择策略 | 场景 | 推荐模型 | | --- | --- | | 简单探索、机械任务 | `/model haiku` | | 日常编码 | `/model sonnet` | | 复杂推理、架构设计、安全分析 | `/model opus` | ### 会话管理 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/resume` | 恢复历史会话 | 打开会话选择器 | | `/sessions` | 列出所有会话 | 查看会话历史 | | `/tasks` | 查看后台任务 | `/tasks ` 查看详情 | | `/name [名称]` | 命名当前会话 | 方便后续查找 | ### 工具与配置 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/config` | 查看/编辑配置 | 打开 settings.json | | `/permissions` | 管理权限设置 | 查看和修改工具权限 | | `/mcp` | 管理 MCP 服务器 | 添加、删除、查看 MCP 服务器 | | `/cost` | 查看费用统计 | 当前会话 token 和费用 | | `/keybindings` | 编辑快捷键配置 | 修改 `~/.claude/keybindings.json` | ### 项目与环境 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/init` | 初始化项目配置 | 创建 CLAUDE.md 等项目文件 | | `/add-dir <路径>` | 添加工作目录 | 允许访问额外目录 | | `/ide` | 连接 IDE | 自动连接 VS Code / JetBrains | | `/doctor` | 健康检查 | 诊断 Claude Code 安装和配置问题 | | `/status` | 查看状态 | 显示当前连接和配置状态 | ### 账户与安装 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/login` | 登录 | 认证 Anthropic 账户 | | `/logout` | 登出 | 清除认证信息 | | `/install-github-app` | 安装 GitHub App | 启用 PR 工作流集成 | | `/bug` | 报告问题 | 提交 bug 报告 | ### 高级功能 | 指令 | 功能 | 说明 | | --- | --- | --- | | `/listen` | 监听模式 | 监听外部输入 | | `/vim` | Vim 模式 | 启用 Vim 风格的键绑定 | | `/review` | 代码审查 | 审查当前变更 | | `/memory` | 管理记忆 | 查看/编辑 Claude 的持久记忆 | | `/terminal-setup` | 终端设置 | 配置终端集成 | | `!<命令>` | 执行 Shell 命令 | 比如 `!git status`，在当前会话中运行 | ### 自定义斜杠命令 在项目目录 `.claude/commands/` 或全局 `~/.claude/commands/` 下创建 `.md` 文件： ``` --- allowed-tools: Edit, Bash model: sonnet description: 审查当前分支的代码变更 --- 审查当前分支相对于 main 的所有变更： 1. 检查代码质量 2. 发现潜在 bug 3. 给出改进建议 $ARGUMENTS ``` 文件名就是命令名，使用 `$ARGUMENTS` 捕获命令后的参数。 ## 三、键盘快捷键 | 快捷键 | 功能 | 说明 | | --- | --- | --- | | Shift+Tab | 切换权限/计划模式 | 循环：default → acceptEdits → auto → plan | | Ctrl+C | 取消当前任务 | 停止执行但不退出会话 | | Ctrl+D | 退出会话 | 等同 `/exit` | | Ctrl+L | 清屏 | 清除终端显示，保留上下文 | | Ctrl+R | 搜索历史 | 搜索当前会话的命令历史 | | Ctrl+S | 暂存 Prompt | 暂存当前输入，提交其他内容后自动恢复 | | Escape | 中断生成 | 第一次中断，输入 "go" 可继续 | | Escape×2 | 回溯模式 | 进入回溯模式，用方向键浏览历史 | ### 自定义快捷键 运行 `/keybindings` 编辑 `~/.claude/keybindings.json`，修改后即时生效，无需重启。 ## 四、CLI 启动参数 ### 核心参数 | 参数 | 缩写 | 功能 | 示例 | | --- | --- | --- | --- | | `--print` | `-p` | 单次输出模式 | `claude -p "问题"` | | `--continue` | `-c` | 继续最近会话 | `claude -c` | | `--resume [id]` | `-r` | 恢复指定会话 | `claude -r abc123` | | `--model <模型>` | | 指定模型 | `claude --model opus` | | `--help` | `-h` | 显示帮助 | `claude -h` | | `--version` | `-v` | 显示版本 | `claude -v` | ### 输入与输出 | 参数 | 功能 | 示例 | | --- | --- | --- | | `--file <路径>` | 输入文件 | `claude --file src/api.ts "分析"` | | `--output-format <格式>` | 输出格式 | `text` / `json` / `stream-json` | | `--input-format <格式>` | 输入格式 | `text` / `stream-json` | | `--json-schema ` | 结构化输出验证 | 指定 JSON Schema | ### 会话与上下文 | 参数 | 功能 | 示例 | | --- | --- | --- | | `--add-dir <目录>` | 添加工作目录 | `claude --add-dir ../lib` | | `--name <名称>` | `-n` 命名会话 | `claude -n "feature-auth"` | | `--fork-session` | 分叉会话 | 恢复时创建新会话 ID | | `--from-pr [值]` | 从 PR 恢复 | `claude --from-pr 123` | | `--session-id ` | 指定会话 ID | 使用特定 UUID | | `--no-session-persistence` | 禁用会话持久化 | 仅与 `--print` 搭配 | | `--worktree [名称]` | `-w` 创建 git worktree | 隔离工作环境 | | `--tmux` | 创建 tmux 会话 | 需搭配 `--worktree` | ### 模型与行为 | 参数 | 功能 | 示例 | | --- | --- | --- | | `--effort <级别>` | 推理深度 | `low` / `medium` / `high` / `max` | | `--permission-mode <模式>` | 权限模式 | 见权限模式说明 | | `--fallback-model <模型>` | 降级模型 | 主模型过载时自动切换 | | `--max-budget-usd <金额>` | 费用上限 | 仅与 `--print` 搭配 | | `--verbose` | 详细日志 | 显示更多运行信息 | | `--debug [过滤]` | 调试模式 | `--debug "api,hooks"` | | `--debug-file <路径>` | 调试日志文件 | 写入指定路径 | ### 工具与权限 | 参数 | 功能 | 示例 | | --- | --- | --- | | `--allowedTools <工具>` | 允许的工具 | `"Bash(git:*) Edit"` | | `--disallowedTools <工具>` | 禁止的工具 | `"Bash(rm:*)"` | | `--tools <工具>` | 指定可用工具集 | `"Bash,Edit,Read"` 或 `""` 禁用所有 | | `--dangerously-skip-permissions` | 跳过所有权限检查 | 仅用于沙箱环境 | | `--allow-dangerously-skip-permissions` | 允许跳过权限选项 | 不默认跳过，仅开放选项 | ### Prompt 定制 | 参数 | 功能 | 示例 | | --- | --- | --- | | `--system-prompt <提示>` | 自定义系统提示 | 替换默认系统提示 | | `--append-system-prompt <提示>` | 追加系统提示 | 在默认提示后附加 | ### 集成与扩展 | 参数 | 功能 | 示例 | | --- | --- | --- | | `--agent <袋里>` | 指定袋里 | 覆盖 settings 中的 agent | | `--agents ` | 自定义袋里 | JSON 定义多个袋里 | | `--mcp-config <配置>` | MCP 服务器配置 | 加载 MCP JSON 配置 | | `--strict-mcp-config` | 严格 MCP 模式 | 仅使用指定的 MCP | | `--plugin-dir <路径>` | 加载插件目录 | 指定插件路径 | | `--settings <文件>` | 加载设置文件 | 额外的 settings.json | | `--ide` | 连接 IDE | 自动连接可用的 IDE | | `--chrome` | Chrome 集成 | 启用浏览器集成 | | `--bare` | 最小模式 | 跳过 hooks、LSP、插件等 | | `--disable-slash-commands` | 禁用斜杠命令 | 禁用所有 skills | ### 子命令 | 子命令 | 功能 | | --- | --- | | `claude doctor` | 健康检查，诊断安装问题 | | `claude auth` | 管理认证 | | `claude mcp` | 管理 MCP 服务器 | | `claude install [target]` | 安装指定版本（stable / latest / 版本号） | | `claude update` | 检查并安装更新 | | `claude agents` | 列出已配置的袋里 | | `claude auto-mode` | 查看 auto 模式分类器配置 | | `claude setup-token` | 设置长期认证 token | | `claude plugin` | 管理插件 | ## 五、权限模式 使用 `--permission-mode` 或 Shift+Tab 在会话中切换： | 模式 | 行为 | 适用场景 | | --- | --- | --- | | `default` | 每次操作需确认 | 谨慎操作，初次使用 | | `acceptEdits` | 自动接受文件编辑 | 信任代码修改 | | `plan` | 先计划再执行，修改需确认 | 复杂任务先审查方案 | | `auto` | 自动执行所有操作 | 快速迭代，信任环境 | | `dontAsk` | 不询问直接执行 | 自动化流水线 | | `bypassPermissions` | 跳过所有权限检查 | 沙箱/测试环境 | ## 六、运行模式 ### 1. 交互模式（默认） ``` claude ``` 特点：持续上下文，适合探索和迭代。 ### 2. 单次模式（Print） ``` claude -p "一个问题" ``` 特点：无状态，适合自动化和管道。 ### 3. 后台任务 ``` claude --background "运行测试" # 查看任务 /tasks # 查看详情 /tasks ``` 适用场景：测试、构建、长时间分析。 ## 七、输入与输出 ### 输入方式 ``` # 文件输入 claude < prompt.txt # 管道输入 cat diff.txt | claude -p "分析改动" # 组合输入 git diff | claude -p "代码审查" # 多文件分析 claude --file api.ts --file db.ts "分析依赖关系" # 精确行范围 claude --file src/api.ts:40-80 "是否存在逻辑错误" ``` ### 输出方式 ``` # JSON 输出 claude -p --output-format json "生成接口定义" # 流式 JSON claude -p --output-format stream-json "生成代码" # 结构化输出 claude -p --json-schema '{"type":"object","properties":{"name":{"type":"string"}}}' "提取信息" # 重定向 claude -p "生成代码" > main.ts ``` ## 八、工作流模板 ### 1. 多步骤执行 ``` claude "1. 设计数据库 2. 实现 API 3. 编写测试 4. 生成文档" ``` ### 2. 验证型工作流 ``` claude "步骤1：实现功能 验证：是否可运行 步骤2：编写测试 验证：是否通过 步骤3：覆盖率检查 验证：是否 >80%" ``` ### 3. Bug 修复流程 ``` 1. 描述问题 2. 分析日志 3. 定位代码 4. 修复问题 5. 编写测试 6. 回归验证 ``` ### 4. 重构流程 ``` 1. 识别问题 2. 提出重构方案 3. 重写代码 4. 保持行为一致 5. 验证测试 ``` ## 九、命令组合实践 ### 1. 代码审查 ``` # 交互式审查 claude --file main.go "1. 性能问题 2. 并发问题 3. 安全问题 4. 可维护性" # Git diff 审查 git diff main..HEAD | claude -p "审查代码变更，标注风险点" ``` ### 2. Bug 定位 ``` # 日志分析 claude --file logs.txt "找出错误原因" # 代码定位 claude --file api.ts:40-80 "这里是否有问题" ``` ### 3. Git 集成 ``` git diff | claude -p "审查代码" git log --oneline -20 | claude -p "分析变更趋势" ``` ### 4. CI/CD 集成 ``` # 自动审查（费用受控） git diff main..HEAD | claude -p \ --max-budget-usd 0.50 \ --output-format json \ "代码审查，输出 JSON 格式的问题列表" # 降级策略 claude -p --model sonnet --fallback-model haiku "生成接口" ``` ### 5. 批处理 ``` for file in src/*.ts; do claude -p --file "$file" "检查问题" done ``` ## 十、Compact 与上下文管理 长会话中上下文会逐渐膨胀，影响性能并增加费用。这是日常使用中很容易忽略但又非常关键的一点。 ### 使用策略 | 场景 | 操作 | | --- | --- | | 上下文使用 >80% | `/compact` 压缩历史 | | 切换完全不同的任务 | `/clear` 清空重来 | | 需要保留特定信息 | `/compact 保留 API 设计决策` | | 会话过长效果下降 | `/compact` 后继续 | ### 示例 ``` /compact 保留错误处理的修复方案和测试结果 ``` Claude 会压缩之前的对话，仅保留你指定的关键信息。 ## 十一、Plan 模式实践 Plan 模式让 Claude 在执行前先给出方案，这在处理复杂或高风险任务时尤其有用。 ### 启用方式 ``` # 启动时指定 claude --permission-mode plan # 会话中切换 /plan # 快捷键 Shift+Tab # 循环切换模式 ``` ### 适用场景 - 复杂重构：先看方案再执行 - 不熟悉的代码库：先探索再修改 - 高风险操作：数据库迁移、API 变更 - 团队协作：方案可以分享讨论 ## 十二、环境变量 | 变量 | 功能 | | --- | --- | | `ANTHROPIC_API_KEY` | API 密钥 | | `CLAUDE_CODE_SIMPLE` | 简单模式（`--bare` 自动设置） | | `CLAUDE_FORMAT` | 默认输出格式 | ## 十三、参数总览 | 参数 | 缩写 | 功能 | | --- | --- | --- | | `--print` | `-p` | 单次输出 | | `--continue` | `-c` | 继续最近会话 | | `--resume` | `-r` | 恢复指定会话 | | `--model` | | 指定模型 | | `--file` | | 输入文件 | | `--effort` | | 推理深度 | | `--output-format` | | 输出格式 | | `--permission-mode` | | 权限模式 | | `--allowedTools` | | 允许的工具 | | `--max-budget-usd` | | 费用上限 | | `--worktree` | `-w` | 创建 worktree | | `--verbose` | | 详细日志 | | `--debug` | `-d` | 调试模式 | | `--help` | `-h` | 帮助 | | `--version` | `-v` | 版本 | ## 十四、场景速查 | 场景 | 命令 | | --- | --- | | 快速问答 | `claude "问题"` | | 单次输出（管道） | `claude -p "问题"` | | 分析代码 | `claude --file src/api.ts "分析"` | | 精确分析 | `claude --file src/api.ts:40-80 "检查"` | | 继续上次 | `claude -c` | | 恢复会话 | `claude -r` | | 切换模型 | `/model opus` | | 压缩上下文 | `/compact` | | 计划模式 | `/plan` 或 Shift+Tab | | 快速模式 | `/fast` | | 低推理 | `/effort low` | | 后台任务 | `claude --background "任务"` | | 费用控制 | `--max-budget-usd 1.00` | | 自动化 | `-p --output-format json` | | 沙箱执行 | `--dangerously-skip-permissions` | | 健康检查 | `claude doctor` | | 命名会话 | `claude -n "my-feature"` | | 隔离开发 | `claude -w feature-x` | ## 十五、Prompt 编写规范 ### 推荐结构 ``` 目标： 约束： 输入： 输出： 验证： ``` 示例： ``` 目标：实现缓存 约束：Go + 并发安全 输出：完整代码 验证：包含测试 ``` ## 十六、最佳实践 1. Prompt 结构化 — 明确目标、约束、验证条件 2. 文件输入精确化 — 用行号范围而非整个文件 3. 善用会话管理 — `--continue` 和 `--resume` 保持上下文 4. 及时压缩上下文 — `/compact` 防止上下文膨胀 5. 按需选择模型 — Haiku 做简单任务，Opus 做复杂推理 6. Plan 模式审查 — 复杂变更先看方案再执行 7. 费用控制 — `--max-budget-usd` 限制自动化场景的费用 8. 输出 JSON 用于自动化 — `--output-format json` 便于脚本处理 9. 强制验证步骤 — Prompt 中包含验证条件 ## 十七、常见问题 ### 1. 输出质量不稳定 - 原因：Prompt 模糊 / 输入过多 - 解决：限制范围、增加约束、使用 `/effort high` ### 2. 上下文丢失 - 原因：未使用 session - 解决：使用 `--continue` 或 `--resume` ### 3. 分析结果不准确 - 原因：文件范围过大 - 解决：使用行号精确定位 `--file src/api.ts:40-80` ### 4. 上下文过长导致效果下降 - 原因：长会话积累过多历史 - 解决：使用 `/compact` 压缩，或 `/clear` 重新开始 ### 5. 费用超出预期 - 原因：Opus 模型 + 长会话 - 解决：简单任务用 `/model haiku`，CI 中用 `--max-budget-usd` ## 总结 Claude Code 的核心能力可以归结为几个关键词： - **准确的输入** — 尽量做细致清晰的描述 - **上下文管理** — `/compact`、`--resume`、`--continue` 三件套 - **模式切换** — `/plan`、`/fast`、`/model`、`/effort` 灵活搭配 - **可验证工作流** — 每一步都带着验证条件 - **自动化集成** — `-p` 配合 `--output-format json` 接入管道 使用方式的核心转变，是从“提问”到“构建整体执行流程”。理解了这一点，Claude Code 就不再只是一个问答工具，而是一个真正能嵌入开发工作流的编程伙伴。