(2026年最新版)开发者人手一份的Claude Code命令手册

本文档整理了 Claude Code 命令行工具的完整命令、参数、快捷键和环境变量，覆盖日常开发、CI/CD 脚本、项目管理等全场景，方便开发者快速查阅。

一、CLI 启动命令（终端执行）

基础启动

| 命令 | 功能说明 | 示例 |
|---|---|---|
| claude | 启动交互式会话（当前目录） | claude |
| claude "query" | 启动会话并发送初始提示 | claude "解释这个项目结构" |
| claude -p "query" | 单次打印模式：执行查询后直接退出，不进入交互（适合脚本/CI） | claude -p "修复 auth.py 中的 bug" |
| cat file \| claude -p "query" | 管道输入处理 | cat logs.txt \| claude -p "分析错误日志" |

会话续接

| 命令 | 功能说明 | 示例 |
|---|---|---|
| claude -c / claude --continue | 继续当前目录最近一次对话 | claude -c |
| claude -c -p "query" | 续接会话并以打印模式执行 | claude -c -p "检查类型错误" |
| claude -r "session-id" "query" | 按 ID 或名称恢复指定会话 | claude -r "auth-refactor" "完成这个 PR" |
| claude --from-pr <pr> | 恢复关联 GitHub PR 的会话 | claude --from-pr 1234 |
| claude --fork-session | 恢复时创建新会话 ID（不修改原会话） | claude -r abc123 --fork-session |

认证与安装

| 命令 | 功能说明 | 示例 |
|---|---|---|
| claude auth login | 登录 Anthropic 账号 | claude auth login --console |
| claude auth logout | 登出账号 | claude auth logout |
| claude auth status | 查看认证状态（JSON 输出） | claude auth status --text |
| claude update | 更新到最新版本 | claude update |
| claude install [version] | 安装/重装指定版本 | claude install stable |
| claude setup-token | 生成 CI/脚本用的长效 OAuth Token | claude setup-token |

后台会话管理

| 命令 | 功能说明 | 示例 |
|---|---|---|
| claude agents | 打开代理视图，监控并行后台会话 | claude agents --json |
| claude attach <id> | 附加到指定后台会话 | claude attach 7c5dcf5d |
| claude stop <id> | 停止后台会话（别名 kill） | claude stop 7c5dcf5d |
| claude respawn <id> | 重启后台会话（保留对话） | claude respawn 7c5dcf5d |
| claude rm <id> | 从列表移除后台会话（转录保留） | claude rm 7c5dcf5d |
| claude logs <id> | 打印后台会话最近输出 | claude logs 7c5dcf5d |
| claude daemon status | 查看后台会话管理器状态 | claude daemon status |
| claude daemon stop --any | 停止后台会话管理器 | claude daemon stop --any --keep-workers |

其他子命令

| 命令 | 功能说明 |
|---|---|
| claude mcp | 配置 MCP（Model Context Protocol）服务器 |
| claude mcp login <name> | 运行 MCP 服务器 OAuth 认证流程 |
| claude mcp logout <name> | 清除 MCP 服务器 OAuth 凭证 |
| claude plugin / claude plugins | 管理 Claude Code 插件 |
| claude project purge [path] | 删除项目本地状态（转录、日志等） |
| claude remote-control | 启动远程控制服务器 |
| claude ultrareview [target] | 非交互式运行深度代码审查 |
| claude auto-mode defaults | 输出自动模式分类规则 JSON |
| claude gateway --config <file> | 启动自托管网关服务器（企业 SSO） |

二、CLI Flags 完整列表

模型与代理

| Flag | 功能说明 | 示例 |
|---|---|---|
| --model <name> | 指定模型（sonnet/opus/haiku 或完整名称） | claude --model opus |
| --fallback-model <name> | 主模型过载时的降级模型（逗号分隔） | claude --fallback-model sonnet,haiku |
| --agent <name> | 指定自定义代理 | claude --agent my-agent |
| --agents '<json>' | 动态定义子代理（JSON） | claude --agents '{"reviewer":{...}}' |
| --advisor <model> | 启用服务端顾问工具 | claude --advisor opus |
| --effort <level> | 设置推理强度（low/medium/high/xhigh/max） | claude --effort high |

系统提示词

| Flag | 功能说明 |
|---|---|
| --system-prompt "text" | 替换默认系统提示词 |
| --system-prompt-file <path> | 从文件加载系统提示词（仅打印模式） |
| --append-system-prompt "text" | 追加内容到默认系统提示词末尾 |
| --append-system-prompt-file <path> | 从文件追加系统提示词 |

工具与权限

| Flag | 功能说明 |
|---|---|
| --tools "Bash,Read,Edit" | 限制可用的内置工具 |
| --allowedTools "patterns" | 无需确认即可执行的工具（支持通配） |
| --disallowedTools "patterns" | 禁用的工具或工具调用 |
| --permission-mode <mode> | 启动时指定权限模式（default/plan/auto/acceptEdits/bypassPermissions） |
| --dangerously-skip-permissions | 跳过所有权限确认 ⚠️ |
| --allow-dangerously-skip-permissions | 启用跳过权限选项但不默认激活 |

预算与执行限制

| Flag | 功能说明 |
|---|---|
| --max-budget-usd <amount> | API 调用最大美元预算（仅打印模式） |
| --max-turns <n> | 限制代理轮次（仅打印模式） |
| --json-schema <schema> | 输出符合 JSON Schema 的结构化结果 |

会话与输出

| Flag | 功能说明 |
|---|---|
| --add-dir <paths> | 添加额外工作目录 |
| --bare | 极简模式：跳过钩子、技能、插件、MCP，启动更快 |
| --bg / --background | 以后台代理方式启动会话 |
| --chrome | 启用 Chrome 浏览器集成 |
| --cloud | 在 claude.ai 创建云端会话 |
| --debug [categories] | 启用调试模式，可指定类别过滤 |
| --debug-file <path> | 调试日志写入指定文件 |
| --output-format <format> | 输出格式（text/json/stream-json） |
| --input-format <format> | 输入格式（text/stream-json） |
| --verbose | 启用详细日志输出 |
| --init | 打印模式下运行 init 钩子 |
| --init-only | 仅运行 Setup 和 SessionStart 钩子后退出 |

三、交互模式斜杠命令（会话内使用）

在 Claude Code 交互会话中，以 / 开头的命令。输入 / 可查看全部可用命令。

基础控制

| 命令 | 功能说明 |
|---|---|
| /help | 查看帮助和所有可用命令 |
| /exit / /quit | 退出 CLI（后台会话仅分离） |
| /clear / /reset / /new | 清空上下文，开启新对话 |
| /compact [instructions] | 压缩对话历史，释放上下文空间 |
| /btw <question> | 快速旁问，不增加对话历史 |
| /recap | 生成当前会话一句话摘要 |

模型与配置

| 命令 | 功能说明 |
|---|---|
| /model [model] | 切换会话使用的模型 |
| /effort [level] | 设置推理强度 |
| /config / /settings | 打开设置界面 |
| /theme | 切换颜色主题 |
| /color [color\|default] | 设置提示栏颜色 |
| /fast [on\|off] | 切换快速模式 |
| /tui [default\|fullscreen] | 设置终端 UI 渲染模式 |

上下文与会话

| 命令 | 功能说明 |
|---|---|
| /context [all] | 可视化当前上下文占用情况 |
| /add-dir <path> | 添加工作目录 |
| /resume [session] | 恢复指定会话 |
| /branch [name] / /fork | 创建对话分支 |
| /rename [name] | 重命名当前会话 |
| /export [filename] | 导出对话为纯文本 |
| /copy [N] | 复制最近第 N 条回复到剪贴板 |

代码审查与质量

| 命令 | 功能说明 |
|---|---|
| /diff | 打开交互式 diff 查看器 |
| /code-review [level] | Skill：审查当前 diff 的正确性问题 |
| /review [PR] | 审查本地或 GitHub PR |
| /security-review | 专门做安全漏洞审查 |
| /simplify [target] | 仅做代码清理简化，不找 bug |
| /ultrareview [PR] | 云端多代理深度代码审查 |
| /verify | Skill：构建并运行应用验证改动效果 |
| /run | Skill：启动并驱动应用，直观查看改动效果 |

代理与并行

| 命令 | 功能说明 |
|---|---|
| /agents | 管理代理配置 |
| /background [prompt] / /bg | 分离当前会话为后台代理 |
| /batch <instruction> | Skill：大规模并行代码库改造 |
| /tasks / /bashes | 列出并管理后台任务 |
| /goal [condition] | 设置目标，Claude 持续工作直到达成 |
| /loop [interval] [prompt] | Skill：循环执行提示词 |

项目初始化

| 命令 | 功能说明 |
|---|---|
| /init | 生成项目 CLAUDE.md 引导文件 |
| /memory | 编辑 CLAUDE.md 记忆文件，管理自动记忆 |
| /mcp | 管理 MCP 服务器连接 |
| /permissions / /allowed-tools | 管理工具权限规则 |
| /skills | 列出已安装技能 |
| /hooks | 查看钩子配置 |

调试与诊断

| 命令 | 功能说明 |
|---|---|
| /doctor | 诊断安装健康和版本状态 |
| /debug [description] | Skill：启用调试日志并排查问题 |
| /rewind / /undo / /checkpoint | 回退对话和代码到检查点 |
| /heapdump | 输出 JavaScript 堆快照（排查内存问题） |
| /status | 查看版本、模型、账号、连接状态 |
| /usage / /cost / /stats | 查看会话费用和用量统计 |

其他实用命令

| 命令 | 功能说明 |
|---|---|
| /plan [description] | 进入计划模式，先思考再编码 |
| /ultraplan <prompt> | 云端生成详细执行计划 |
| /autofix-pr [prompt] | 云端会话自动修复 PR 的 CI 失败 |
| /teleport / /tp | 将云端会话拉取到本地终端 |
| /remote-control / /rc | 启用远程控制 |
| /desktop / /app | 在桌面应用中继续会话 |
| /ide | 管理 IDE 集成 |
| /focus | 切换专注视图 |
| /feedback / /bug / /share | 提交反馈或报告 bug |
| /insights | 生成会话分析报告 |
| /team-onboarding | 生成团队上手指南 |
| /fewer-permission-prompts | 优化权限提示减少确认次数 |
| /release-notes | 查看版本更新日志 |
| /powerup | 交互式功能教程 |
| /keybindings | 打开快捷键配置文件 |
| /schedule / /routines | 创建定时例行任务 |
| /run-skill-generator | 生成项目专属的 run/verify 技能 |

四、键盘快捷键

全局控制

| 快捷键 | 功能 |
|---|---|
| Ctrl+C | 中断当前操作；无操作时第一次清空输入，第二次退出 |
| Ctrl+D | 退出 Claude Code |
| Ctrl+L | 重绘屏幕（清理显示异常） |
| Esc | 中断 Claude 响应/工具调用 |
| Esc + Esc | 清空输入草稿；输入为空时打开回退菜单 |
| Ctrl+G / Ctrl+X Ctrl+E | 在外部编辑器中编辑输入 |

文本编辑

| 快捷键 | 功能 |
|---|---|
| Ctrl+A | 光标移到行首 |
| Ctrl+E | 光标移到行尾 |
| Ctrl+K | 删除到行尾（可粘贴） |
| Ctrl+U | 删除到行首（可粘贴） |
| Ctrl+W | 删除前一个单词（可粘贴） |
| Ctrl+Y | 粘贴已删除文本 |
| Alt+B | 光标向后移动一个单词 |
| Alt+F | 光标向前移动一个单词 |
| Shift+Enter / Ctrl+J | 插入换行（多行输入） |

视图与模式

| 快捷键 | 功能 |
|---|---|
| Ctrl+O | 切换详细转录视图 |
| Ctrl+T | 切换任务清单 |
| Shift+Tab / Alt+M | 循环切换权限模式 |
| Alt+P / Option+P | 切换模型 |
| Alt+T / Option+T | 切换扩展思考模式 |
| Alt+O / Option+O | 切换快速模式 |
| Ctrl+R | 反向搜索命令历史 |
| Ctrl+B | 将运行中的任务移至后台 |

转录视图快捷键

| 快捷键 | 功能 |
|---|---|
| ? | 显示快捷键帮助 |
| { / } | 跳转到上/下一条用户提示 |
| Ctrl+E | 切换显示全部内容 |
| v | 在编辑器中打开对话 |
| q / Esc | 退出转录视图 |

前缀快捷语法

| 前缀 | 功能 | 示例 |
|---|---|---|
| ! | 直接执行 Shell 命令 | ! npm test |
| @ | 文件路径自动补全 | @src/utils/ |
| / | 斜杠命令 | /model opus |

五、常用环境变量精选

认证与 API

| 变量 | 功能 |
|---|---|
| ANTHROPIC_API_KEY | API Key 认证（替代订阅计费） |
| ANTHROPIC_BASE_URL | 自定义 API 端点（代理/网关） |
| ANTHROPIC_MODEL | 默认模型名称 |
| API_TIMEOUT_MS | API 请求超时（毫秒，默认 10 分钟） |
| CLAUDE_CODE_USE_BEDROCK | 使用 Amazon Bedrock（设为 1） |
| CLAUDE_CODE_USE_VERTEX | 使用 Google Vertex AI（设为 1） |

行为控制

| 变量 | 功能 |
|---|---|
| CLAUDE_CODE_SIMPLE | 极简模式：禁用技能/插件/MCP，启动更快 |
| CLAUDE_CODE_DISABLE_BACKGROUND_TASKS | 禁用后台任务功能 |
| CLAUDE_CODE_DISABLE_1M_CONTEXT | 禁用 1M 上下文窗口 |
| BASH_DEFAULT_TIMEOUT_MS | Bash 命令默认超时 |
| BASH_MAX_OUTPUT_LENGTH | Bash 输出最大字符数 |
| CLAUDE_CODE_EFFORT_LEVEL | 默认推理强度 |

检测与调试

| 变量 | 功能 |
|---|---|
| CLAUDECODE | Claude Code 子进程中设为 1，用于脚本检测 |
| CLAUDE_CODE_DEBUG_LOGS_DIR | 调试日志目录 |
| CLAUDE_AX_SCREEN_READER | 屏幕阅读器友好输出模式 |

六、实用场景示例

1. CI/CD 中非交互式代码审查

# 单次审查 PR 并输出 JSON 结果
claude -p "审查当前分支的代码改动，列出问题" \
  --dangerously-skip-permissions \
  --max-budget-usd 2.00 \
  --output-format json

2. 快速修复指定文件

# 极简模式，快速修复
claude --bare -p "修复 src/auth.js 中的 JWT 验证逻辑"

3. 管道处理日志

# 分析错误日志并给出修复建议
tail -n 100 app-error.log | claude -p "分析这些错误，给出根因和修复方案"

4. 后台运行大规模重构

# 后台执行，释放终端
claude --bg "将整个项目的 CommonJS 迁移到 ESM"

5. 指定工具权限自动化

# 允许 git 相关命令自动执行，其他需确认
claude --allowedTools "Bash(git *),Read" "查看 git 历史并总结改动"

6. 续接上次对话继续工作

# 恢复上次会话，继续开发
claude -c -p "继续完成用户认证模块的开发"

七、开发者最佳实践

新项目先跑 /init：生成 CLAUDE.md 项目指南，让 Claude 理解项目规范和架构
常用任务用 -p 脚本化：重复性工作封装成 shell 脚本，配合 --bare 提速
大改动先 /plan：进入计划模式确认方案后再动手，减少返工
长对话定期 /compact：避免上下文膨胀，保持响应质量和速度
CI 环境用 --dangerously-skip-permissions：配合 --max-budget-usd 控制成本
权限精细化配置：用 --allowedTools 白名单模式，只开放必要的 Bash 命令
并行任务用 /batch：跨文件大规模改造时，自动拆分并行执行效率更高