Claude Code 命令清单

基于 Claude Code 官方最新稳定版,涵盖 CLI 全局参数、会话内斜杠命令、内置快捷键、隐藏别名、高阶技巧与最佳实践,全量无遗漏。


目录

  1. 终端全局启动参数
  2. 终端子命令
  3. 会话内斜杠命令
  4. 键盘快捷键
  5. 隐藏别名与等价指令
  6. 高阶使用技巧
  7. 配置与环境变量
  8. 常见问题速查

一、终端全局启动参数

执行 claude [参数] 时传入的全局选项,决定会话初始状态。

1.1 基础通用

参数长参数说明示例
claude—默认启动交互式会话,加载当前目录上下文claude
<prompt>—直接携带文本启动会话,执行后进入交互claude "分析当前目录结构"
-p--prompt <text>单次执行模式,问答完成直接退出(非交互)claude -p "生成 README"
-h--help展示全部 CLI 帮助文档claude --help
-v--version查看当前 Claude Code 版本号claude -v

1.2 会话恢复与管理

参数长参数说明示例
-c--continue恢复最近一次历史会话claude -c
-r--resume <id|name>指定 ID 或名称恢复特定会话claude -r "项目重构"
—--list-sessions列出所有本地会话列表claude --list-sessions
—--new强制新建会话,不恢复历史claude --new

1.3 模型与能力配置

参数长参数说明可选值示例
—--model <name>指定运行模型opus / sonnet / haikuclaude --model sonnet
—--effort <level>设置推理强度low / medium / high / maxclaude --effort high
—--no-thinking关闭模型深度思考,提速降 token—claude --no-thinking
—--max-tokens <num>限制单次输出最大 token 数正整数claude --max-tokens 4096
—--temperature <num>控制输出随机性0.0 ~ 1.0claude --temperature 0.2

1.4 目录与权限

参数长参数说明示例
—--dir <path>指定工作目录(非当前目录启动)claude --dir ~/projects/api
—--add-dir <path>额外挂载多个工作目录claude --add-dir ~/shared-lib
—--no-sandbox关闭沙箱限制,允许本地运行脚本/命令claude --no-sandbox
—--sandbox强制开启沙箱(默认安全模式)claude --sandbox
—--allow-tools自动允许所有工具调用(免确认)claude --allow-tools
—--no-auto-commits禁用自动提交 Git 变更claude --no-auto-commits

1.5 输出与日志

参数长参数说明示例
—--jsonJSON 结构化输出(适配脚本调用)claude -p "分析" --json
—--quiet静默模式,减少冗余日志claude --quiet
—--verbose详细日志模式(排错用)claude --verbose
—--log-file <path>将运行日志写入指定文件claude --log-file ./claude.log
—--no-color禁用终端彩色输出claude --no-color

1.6 网络与代理

参数长参数说明示例
—--proxy <url>指定网络代理地址claude --proxy http://127.0.0.1:7890
—--no-proxy禁用代理claude --no-proxy
—--timeout <seconds>设置网络请求超时claude --timeout 60

二、终端子命令

claude <子命令> 形式,执行独立功能,不进入交互会话。

2.1 版本管理

子命令说明示例
claude update在线升级到最新版本claude update
claude install [version]安装/重装指定版本,不带版本则装最新claude install / claude install 0.2.0
claude uninstall卸载 Claude Codeclaude uninstall
claude doctor一键诊断环境、依赖、权限、网络问题claude doctor

2.2 账号管理

子命令说明示例
claude login登录账号/授权凭证claude login
claude logout退出登录、清除本地凭证claude logout
claude whoami查看当前登录账号信息claude whoami

2.3 配置管理

子命令说明示例
claude config配置管理(交互式)claude config
claude config list列出所有全局配置项claude config list
claude config set <key> <value>修改配置claude config set model sonnet
claude config get <key>查看单项配置claude config get model
claude config reset重置全局配置为默认claude config reset
claude config path显示配置文件路径claude config path

2.4 MCP 工具服务管理

子命令说明示例
claude mcpMCP 工具服务管理(交互式)claude mcp
claude mcp list列出已安装 MCP 服务claude mcp list
claude mcp add <name>添加 MCP 服务claude mcp add filesystem
claude mcp remove <name>移除 MCP 服务claude mcp remove filesystem
claude mcp start <name>启动 MCP 服务claude mcp start filesystem
claude mcp stop <name>停止 MCP 服务claude mcp stop filesystem
claude mcp status查看 MCP 服务状态claude mcp status

2.5 IDE 集成管理

子命令说明示例
claude ideIDE 集成管理(交互式)claude ide
claude ide install安装 VS Code 等 IDE 插件claude ide install
claude ide uninstall卸载 IDE 集成claude ide uninstall
claude ide status查看 IDE 集成状态claude ide status

三、会话内斜杠命令

进入交互会话后,输入 / 调用。按 Tab 可自动补全。

3.1 会话生命周期

命令说明示例
/clear清空当前对话历史,新建会话/clear
/reset同 /clear(别名)/reset
/new同 /clear(别名)/new
/exit退出交互式会话/exit
/quit同 /exit(别名)/quit

3.2 历史回溯与会话分支

命令说明示例
/rewind回退到上一条对话节点,可多次执行/rewind
/undo同 /rewind(别名)/undo
/checkpoint同 /rewind(别名)/checkpoint
/branch基于当前对话分叉出新会话/branch
/resume [name|id]在当前会话内恢复其他历史会话/resume "重构方案"
/continue [name|id]同 /resume(别名)/continue

3.3 会话编辑与导出

命令说明示例
/rename <name>给当前会话设置自定义名称/rename "API 重构方案"
/copy将模型最后一条回复复制到系统剪贴板/copy
/export [path]导出完整对话到本地文件;无路径则复制到剪贴板/export ./session.md
/compact [note]压缩上下文历史,精简冗余内容降低 token 占用/compact "保留核心设计思路"

3.4 项目与文件操作

命令说明示例
/init在当前目录自动生成 CLAUDE.md 项目规则文件/init
/add-dir <path>临时追加目录到当前会话上下文/add-dir ../shared
/diff查看本地文件未提交的代码变更、差异对比/diff
/review [pr-url|path]评审本地 PR / 代码变更集/review / /review https://github.com/...
/file <path>快速读取单个文件内容/file src/main.ts
/find <pattern>在项目中搜索匹配内容/find "TODO:"
/grep <pattern>同 /find,类 grep 搜索/grep "class.*Service"

3.5 模型与参数动态调整

命令说明示例
/model <name>会话内动态切换模型/model opus
/effort <level>会话内修改推理强度/effort high
/thinking切换深度思考开关/thinking
/no-thinking关闭深度思考/no-thinking
/context查看当前上下文占用、token 统计、优化建议/context
/cost查看本次会话累计 Token 用量、预估费用/cost
/status全量状态:工作目录、当前模型、推理强度、沙箱、MCP、记忆配置/status

3.6 目标与临时提问

命令说明示例
/goal <description>设置本次会话整体目标,模型会围绕目标执行/goal "重构用户认证模块"
/reset-goal清空已设置的会话目标/reset-goal
/btw <question>临时插话提问,不写入主对话历史/btw "这个函数是做什么的?"

3.7 工具与沙箱管理

命令说明示例
/sandbox切换沙箱开关,查看/切换当前沙箱状态/sandbox
/mcp会话内管理 MCP 工具、查看已加载工具列表/mcp
/ide查看当前 IDE 集成、快捷调用 IDE 功能/ide
/chrome配置/查看浏览器集成能力/chrome
/tools查看当前可用的工具列表/tools

3.8 批量与循环任务

命令说明示例
/loop <interval|times> <task>定时/次数循环执行指定任务/loop 5m "检查测试状态"
/batch <files> <instruction>对多个文件批量执行相同指令/batch "src/**/*.ts" "添加 JSDoc"

3.9 记忆与上下文

命令说明示例
/memory查看/管理长期记忆/memory
/memory add <text>添加长期记忆/memory add "项目使用 pnpm"
/memory clear清空长期记忆/memory clear

3.10 帮助指令

命令说明示例
/help会话内展示所有可用斜杠命令列表/help
/help <command>查看指定命令的详细帮助/help /compact

四、键盘快捷键

终端交互全局生效的快捷键。

快捷键功能
Ctrl + C强制中断当前模型生成、脚本执行
Ctrl + R重新生成上一轮模型回复
Ctrl + L清空终端屏幕(仅界面,不清除会话历史)
Ctrl + D退出交互式会话(同 /exit)
Esc关闭命令补全弹窗、取消当前输入
Tab命令/路径自动补全
Shift + Tab切换补全选项(反向)
↑ / ↓切换历史输入指令/对话
← / →移动光标
Home / End光标移动到行首/行尾
Ctrl + A光标移动到行首
Ctrl + E光标移动到行尾
Ctrl + K删除光标到行尾的内容
Ctrl + U删除光标到行首的内容
Ctrl + W删除光标前的一个单词
Ctrl + Y粘贴最近一次删除的内容
Ctrl + S暂停终端输出
Ctrl + Q恢复终端输出
Ctrl + Z挂起当前进程(后台运行)
Ctrl + \强制终止进程

五、隐藏别名与等价指令

官方原生兼容的等价写法,提升输入效率。

5.1 斜杠命令别名

主命令等价别名
/exit/quit
/clear/reset, /new
/rewind/undo, /checkpoint
/resume/continue

5.2 终端参数别名

长参数短参数
--continue-c
--resume-r
--prompt-p
--help-h
--version-v

六、高阶使用技巧

6.1 批量操作模式

# 单次执行模式:适合脚本化调用
claude -p "分析 package.json 中的依赖安全性" --json

# 多目录批量分析
claude --dir ./project-a --add-dir ./project-b -p "对比两个项目的依赖差异"

# 管道输入
cat README.md | claude -p "优化这段文档的表述"

6.2 会话管理最佳实践

# 查看所有会话
claude --list-sessions

# 恢复特定会话继续工作
claude -r "API 重构方案"

# 导出重要会话存档
claude -r "重要方案" -p "/export ./archives/方案-$(date +%Y%m%d).md"

6.3 模型选择策略

场景推荐模型推理强度
快速问答、简单查询haikulow
日常编码、代码审查sonnetmedium
复杂架构设计、深度重构opushigh
关键核心模块、安全审计opusmax

6.4 上下文优化技巧

# 大项目先压缩上下文
/compact "保留核心业务逻辑,移除示例代码"

# 定期查看上下文占用
/context

# 超出 token 限制时拆分会话
/branch

6.5 安全与沙箱

# 运行不可信代码时强制沙箱
claude --sandbox

# 本地脚本开发关闭沙箱
claude --no-sandbox --allow-tools

# 会话内临时切换沙箱状态
/sandbox

七、配置与环境变量

7.1 全局配置文件

# 查看配置文件路径
claude config path

# 常见配置项
claude config set model sonnet
claude config set effort medium
claude config set sandbox true
claude config set auto-commits false

7.2 环境变量

变量名说明示例
ANTHROPIC_API_KEYAPI 密钥export ANTHROPIC_API_KEY=sk-...
CLAUDE_MODEL默认模型export CLAUDE_MODEL=sonnet
CLAUDE_EFFORT默认推理强度export CLAUDE_EFFORT=high
HTTP_PROXYHTTP 代理export HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXYHTTPS 代理export HTTPS_PROXY=http://127.0.0.1:7890
NO_PROXY不走代理的地址export NO_PROXY=localhost,127.0.0.1

八、常见问题速查

问题解决方案
会话意外中断claude -c 恢复最近一次会话
Token 超出限制/compact 压缩上下文,或 /branch 分叉新会话
模型回复太慢/model haiku 切换轻量模型,或 /no-thinking 关闭深度思考
沙箱阻止脚本执行/sandbox 关闭沙箱,或启动时加 --no-sandbox
需要查看历史对话/export 导出完整对话
误操作回退/rewind 回退到上一步
多项目同时工作claude --add-dir 挂载额外目录
代理连接失败claude --proxy 或设置 HTTP_PROXY 环境变量
自动提交太频繁claude config set auto-commits false
MCP 工具不响应/mcp 检查服务状态,claude mcp restart <name>

附录:命令速查卡

┌─────────────────────────────────────────────────────────────┐
│                    Claude Code 速查卡                        │
├─────────────────────────────────────────────────────────────┤
│  启动                                                         │
│  claude              交互会话                                  │
│  claude -p "..."     单次执行                                  │
│  claude -c           恢复会话                                  │
│  claude --model X    指定模型                                  │
│                                                             │
│  会话内                                                       │
│  /clear              清空历史                                  │
│  /exit               退出会话                                  │
│  /rewind             回退一步                                  │
│  /branch             分叉会话                                  │
│  /compact            压缩上下文                                │
│  /export             导出对话                                  │
│  /context            查看 token                                │
│  /cost               查看费用                                  │
│  /status             全量状态                                  │
│                                                             │
│  快捷操作                                                     │
│  Ctrl+C              中断生成                                  │
│  Ctrl+R              重新生成                                  │
│  Ctrl+L              清屏                                      │
│  Tab                 自动补全                                  │
└─────────────────────────────────────────────────────────────┘

更多推荐