Claude Code 常用命令速查手册

1. 启动与基本用法

claude                          # 启动交互式会话
claude "你的提示"                # 启动会话并发送初始提示
claude -p "提示"                # 非交互模式，输出后退出（适合管道）
claude -p "提示" | cat          # 管道用法
cat file.txt | claude -p "分析" # 将文件内容通过管道传入

2. CLI 常用选项

会话管理

选项	说明
-c, --continue	继续当前目录最近的对话
-r, --resume [id]	恢复指定会话，不带 id 则打开选择器
--from-pr [pr]	恢复与 PR 关联的会话
--fork-session	恢复时创建新会话 ID（配合 --resume / --continue）
-n, --name <name>	为当前会话设置显示名称
--session-id <uuid>	使用指定的会话 ID

模型与性能

选项	说明
--model <model>	指定模型（sonnet、opus、haiku 或完整名称）
--effort <level>	思考力度：low、medium、high、max
--fallback-model <model>	主模型过载时的备用模型（仅 --print）
--max-budget-usd <amount>	API 花费上限（仅 --print）

权限与安全

选项	说明
--permission-mode <mode>	权限模式：default、plan、auto、dontAsk、bypassPermissions
--allowedTools <tools>	允许的工具列表，如 "Bash(git:*) Edit"
--disallowedTools <tools>	禁止的工具列表
--dangerously-skip-permissions	跳过所有权限检查（仅限沙箱环境）

提示与输出

选项	说明
--system-prompt <prompt>	自定义系统提示
--append-system-prompt <prompt>	在默认系统提示后追加内容
--output-format <format>	输出格式：text（默认）、json、stream-json
--input-format <format>	输入格式：text（默认）、stream-json
--json-schema <schema>	结构化输出的 JSON Schema
--verbose	详细输出模式

工作区与代理

选项	说明
-w, --worktree [name]	在新的 git worktree 中启动会话
--tmux	为 worktree 创建 tmux 会话
--add-dir <dirs>	添加额外的可访问目录
--agent <agent>	指定当前会话使用的代理
--agents <json>	JSON 定义自定义代理
--tools <tools>	指定可用工具列表，"" 禁用所有

MCP 服务器

选项	说明
--mcp-config <configs>	从 JSON 文件加载 MCP 服务器配置
--strict-mcp-config	仅使用 --mcp-config 指定的 MCP 服务器

其他

选项	说明
-v, --version	显示版本号
-h, --help	显示帮助
-d, --debug [filter]	调试模式，可按类别过滤
--debug-file <path>	将调试日志写入文件
--brief	启用简洁的代理到用户通信
--chrome / --no-chrome	启用/禁用 Chrome 集成
--ide	自动连接 IDE

3. 子命令

claude auth — 认证管理

claude auth login           # 登录
claude auth logout          # 登出
claude auth status          # 查看认证状态

claude mcp — MCP 服务器管理

claude mcp list                                    # 列出所有 MCP 服务器
claude mcp add <name> <command> [args...]           # 添加 stdio 服务器
claude mcp add --transport http <name> <url>        # 添加 HTTP 服务器
claude mcp add -e API_KEY=xxx <name> -- npx <pkg>   # 带环境变量添加
claude mcp add-json <name> '<json>'                 # 用 JSON 字符串添加
claude mcp add-from-claude-desktop                  # 从 Claude Desktop 导入
claude mcp get <name>                               # 查看服务器详情
claude mcp remove <name>                            # 删除服务器
claude mcp reset-project-choices                    # 重置项目级 MCP 审批
claude mcp serve                                    # 启动 Claude Code 作为 MCP 服务器

claude plugin — 插件管理

claude plugin list                      # 列出已安装插件
claude plugin install <plugin>          # 安装插件
claude plugin uninstall <plugin>        # 卸载插件
claude plugin update <plugin>           # 更新插件
claude plugin enable <plugin>           # 启用插件
claude plugin disable [plugin]          # 禁用插件
claude plugin marketplace               # 管理插件市场
claude plugin validate <path>           # 验证插件

其他子命令

claude agents                # 列出已配置的代理
claude doctor                # 检查自动更新器健康状态
claude install [target]      # 安装原生构建（stable/latest/指定版本）
claude setup-token           # 设置长期认证 token
claude update                # 检查并安装更新

4. 会话内斜杠命令

命令	说明
/help	显示帮助信息
/clear	清除对话历史
/compact [指令]	压缩对话上下文，可附加压缩指令
/config	查看/修改配置
/cost	显示当前会话的 token 使用和费用
/doctor	检查 Claude Code 安装健康状况
/init	初始化项目，生成 CLAUDE.md
/login	切换 Anthropic 账户
/logout	登出当前账户
/memory	编辑 CLAUDE.md 记忆文件
/model	切换模型
/permissions	查看和管理权限
/resume	恢复历史会话
/review	请求代码审查
/status	查看账户和会话状态
/terminal-setup	配置终端（Shift+Enter 换行等）
/vim	切换 vim 模式
/fast	切换快速模式（同模型，更快输出）
/tasks	查看任务列表
/worktree	创建 git worktree 进行隔离开发

5. 键盘快捷键

快捷键	说明
Enter	发送消息
Shift+Enter	换行（需先 /terminal-setup）
Escape	取消当前输入 / 退出 vim 模式
Ctrl+C	中断当前操作
Ctrl+D	退出 Claude Code
Ctrl+L	清屏
Tab	自动补全文件路径
↑ / ↓	浏览历史输入

6. 常用组合技

非交互批处理

# 格式化输出为 JSON
claude -p "分析这段代码" --output-format json

# 限制预算
claude -p "重构代码" --max-budget-usd 5

# 使用特定模型
claude -p "快速回答" --model haiku

# 结构化输出
claude -p "提取信息" --json-schema '{"type":"object","properties":{"name":{"type":"string"}}}'

会话恢复

claude -c                    # 继续上次对话
claude -r                    # 选择历史会话恢复
claude -r "搜索词"            # 按关键词搜索历史会话
claude -r <session-id>       # 恢复指定 ID 的会话

Worktree 并行开发

claude -w feature-login      # 在名为 feature-login 的 worktree 中启动
claude -w bugfix --tmux      # worktree + tmux 会话

自定义权限启动

# 只允许读取和搜索
claude --tools "Read,Grep,Glob"

# Plan 模式（只规划不执行）
claude --permission-mode plan

# 全自动模式
claude --permission-mode auto

MCP 快速配置

# 添加 Figma MCP
claude mcp add --transport http figma https://figma.com/mcp

# 添加本地 MCP 服务器
claude mcp add my-server -- node /path/to/server.js

# 启动时临时加载 MCP 配置
claude --mcp-config mcp-config.json