Claude Code 命令大全：完整参考指南 2025

最全面的 Claude Code 命令参考手册。掌握所有 60+ CLI 命令、斜杠命令、快捷键和参数，附带实用示例，提升 AI 编程效率。

2025年1月19日

ClaudeCode.Guide Team

命令参考CLI快捷键效率

Claude Code 命令大全：完整参考指南 2025

掌握 Claude Code 的每一个命令。无论你是初学者还是高级用户，本指南涵盖了所有 CLI 命令、斜杠命令、快捷键和参数，助你高效进行 AI 驱动的开发。

快速入门命令

安装与设置

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 在当前目录启动 Claude Code
claude

# 带任务启动
claude "修复登录 bug"

# 在指定目录启动
claude --cwd /path/to/project

基础命令

命令	说明
`claude`	启动交互模式
`claude --help`	显示所有可用选项
`claude --version`	查看安装版本
`claude config`	打开配置设置

斜杠命令（交互模式）

在 Claude Code 交互会话中使用斜杠命令。输入 / 查看所有可用命令。

导航与会话管理

命令	说明
`/help`	显示帮助和可用命令
`/clear`	清除当前对话上下文
`/compact`	压缩对话历史以节省 token
`/exit` 或 `/quit`	退出 Claude Code
`/status`	显示当前会话状态

文件与代码操作

命令	说明
`/add <文件>`	将文件添加到对话上下文
`/drop <文件>`	从上下文中移除文件
`/files`	列出当前上下文中的所有文件
`/diff`	显示待处理的更改
`/undo`	撤销上一次文件更改

Git 集成

命令	说明
`/commit`	使用 AI 生成的消息创建 git 提交
`/pr`	创建 Pull Request
`/branch <名称>`	创建并切换到新分支
`/status`	显示 git 状态

模式切换

命令	说明
`/chat`	切换到纯聊天模式（不编辑文件）
`/code`	切换到代码编辑模式
`/plan`	进入规划模式，用于复杂任务

高级命令

命令	说明
`/config`	打开设置配置
`/model`	切换 Claude 模型
`/cost`	显示 token 使用量和成本估算
`/history`	查看对话历史
`/resume`	恢复之前的会话
`/checkpoint`	创建回滚检查点
`/rollback`	回滚到之前的检查点

CLI 参数与选项

执行模式

# 交互模式（默认）
claude

# 执行单个命令后退出
claude -p "解释这个函数"

# 管道模式 - 从 stdin 读取
echo "修复这段代码" | claude -p

# 从上次会话继续
claude --resume

# 恢复特定会话
claude --resume <session-id>

配置参数

参数	说明
`--cwd <路径>`	设置工作目录
`--model <模型>`	指定 Claude 模型（opus, sonnet, haiku）
`--max-tokens <n>`	设置最大响应 token 数
`--temperature <n>`	设置温度（0-1）
`--no-git`	禁用 git 集成
`--verbose`	启用详细输出
`--quiet`	最小输出模式

输出控制

# JSON 输出格式
claude -p "列出所有函数" --output-format json

# Markdown 输出
claude -p "解释架构" --output-format markdown

# 流式输出（默认）
claude -p "写一个测试" --stream

# 禁用流式输出
claude -p "写一个测试" --no-stream

安全与权限

# 自动批准所有文件编辑（谨慎使用）
claude --dangerously-skip-permissions

# 演示运行 - 显示将要执行的操作但不实际执行
claude --dry-run

# 沙盒模式 - 限制文件访问
claude --sandbox

键盘快捷键

交互会话中

快捷键	操作
`Ctrl+C`	取消当前操作
`Ctrl+D`	退出 Claude Code
`Ctrl+L`	清屏
`↑` / `↓`	浏览命令历史
`Tab`	自动补全命令/文件
`Esc`	取消当前输入

快捷操作

快捷键	操作
`!<命令>`	直接执行 bash 命令
`@<文件>`	快速添加文件到上下文
`#<标签>`	添加上下文标签

感叹号命令 (!)

直接执行 shell 命令而无需离开 Claude Code：

# 运行任何 bash 命令
!ls -la

# 运行测试
!npm test

# Git 操作
!git status
!git diff

# 构建命令
!npm run build

MCP（模型上下文协议）命令

命令	说明
`/mcp list`	列出可用的 MCP 服务器
`/mcp connect <服务器>`	连接到 MCP 服务器
`/mcp disconnect`	断开 MCP 服务器连接
`/mcp status`	显示 MCP 连接状态

配置命令

# 在编辑器中打开配置
claude config

# 设置 API 密钥
claude config set api_key <密钥>

# 设置默认模型
claude config set model sonnet

# 启用/禁用功能
claude config set auto_commit true
claude config set show_cost true

# 查看当前配置
claude config list

会话管理

# 列出之前的会话
claude sessions list

# 恢复上次会话
claude --resume

# 恢复特定会话
claude --resume abc123

# 删除会话
claude sessions delete <id>

# 导出会话
claude sessions export <id> > session.json

高级用法示例

自动化工作流

# 修复所有 TypeScript 错误
claude -p "修复 src/ 中的所有 TypeScript 错误"

# 为文件生成测试
claude -p "为 src/utils.ts 编写完整的测试"

# 按特定指令重构
claude -p "将这个类重构为使用依赖注入" --add src/service.ts

# 代码审查
claude -p "审查这个 PR 的安全问题" --add $(git diff --name-only main)

与 CI/CD 集成

# 在脚本中使用
claude -p "根据最近的提交生成变更日志" --output-format markdown > CHANGELOG.md

# 自动代码修复
claude -p "修复 lint 错误" --dangerously-skip-permissions

# 生成文档
claude -p "生成 API 文档" --output-format markdown > docs/API.md

环境变量

变量	说明
`ANTHROPIC_API_KEY`	你的 Anthropic API 密钥
`CLAUDE_CODE_MODEL`	默认使用的模型
`CLAUDE_CODE_CONFIG`	配置文件路径
`CLAUDE_CODE_CACHE`	缓存目录路径
`NO_COLOR`	禁用彩色输出

故障排除命令

# 检查安装
claude --version

# 验证 API 连接
claude --check-api

# 重置配置
claude config reset

# 清除缓存
claude cache clear

# 调试模式
claude --debug

# 显示详细日志
claude --verbose

快速参考卡

最常用命令

命令	功能
`claude`	启动交互会话
`/clear`	重新开始，清除上下文
`/add <文件>`	将文件加入对话
`!git status`	快速查看 git 状态
`/commit`	AI 辅助提交
`/undo`	撤销上一次更改
`Ctrl+C`	停止当前操作

专业技巧

频繁使用 /clear - 开始新任务时重新开始，避免上下文污染
善用 ! 命令 - 执行快速 shell 命令而不中断流程
选择性添加文件 - 只添加与当前任务相关的文件
使用 --model haiku - 对于快速、简单的任务以节省成本
创建检查点 - 在重大重构操作之前