巧匠开发者速查手册

Claude Code 命令速查表 - Anthropic AI 编码代理 CLI 全参数

Claude Code 面向需要在终端里让 AI 直接读代码、改文件并执行命令的开发者，以及希望把编码代理接入 CI 的自动化工程师，它的定位是官方原生的 Agent 型编码工具，与 ChatGPT 式纯问答不同。它能以 -p 打印模式 + --output-format json 无头驱动流水线，也能在交互式 REPL 里多轮迭代；本表帮你快速定位安装认证、会话续接、权限模式与 MCP 扩展的关键命令，读完即可上手实际项目。

AI 命令行·共 53 条命令·最后更新 2026-08-05
claude-codeclaudeanthropicaicliagent编码代理

典型使用场景

面向在终端里做结对编程、以及要把 Claude 接入流水线的开发者。核心是分清交互 REPL 与 -p 打印模式：前者是人机对话，后者是脚本/CI 的一等公民，务必搭配 --output-format json 才能被程序解析。本表覆盖的几类高频问题——怎么控制失控（--max-turns 与 --max-budget-usd 双保险）、怎么控制权限（--permission-mode plan 先规划后执行、--add-dir 授权额外目录）、怎么给足上下文（@file / @dir 引用而非粘贴内容）、以及 MCP 服务器的四种添加方式。会话级斜杠命令（/compact、/context、/rewind）和项目级命令（/init、/plan、/code-review --fix）也在内。

安装与认证 7

npm install -g @anthropic-ai/claude-code
通过 npm 全局安装 Claude Code
claude --version
查看已安装版本号
npm update -g @anthropic-ai/claude-code
升级到最新版本
claude update
在 CLI 内一键更新到最新版
claude auth login
交互式登录 Anthropic 账号
claude auth status
查看当前认证状态
claude auth logout
退出登录

启动与运行 6

claude
在当前目录启动交互式 REPL
claude "重构 user-auth 模块使用新的 session API"
带初始提示启动会话
cat error.log | claude -p "解释这个错误并给出修复"
管道传入内容，打印模式处理（不进交互）
claude -c
继续当前目录最近一次对话（--continue）
claude -r "abc123" "继续完成 PR"
按会话 ID 恢复指定对话（--resume）
claude -c -p "检查类型错误"
以打印模式继续最近对话，适合自动化

CLI 标志位 13

claude -p -m claude-sonnet-4 "写一个解析 CSV 的 Python 函数"
-m 指定模型并以打印模式运行
claude -p --output-format json "列出本项目所有 TODO 注释"
脚本中输出 JSON，便于程序解析
claude -p --max-turns 5 "重构 auth 模块"
限制 Agent 轮次上限，防止失控操作
claude --max-budget-usd 2 "实现登录页"
限制 -p 模式下的 API 花费上限
claude --add-dir ../frontend ../backend
授权额外工作目录供 Claude 访问
claude --system-prompt "你是一名安全审计员"
替换整个系统提示词
claude --append-system-prompt "使用 TypeScript 严格模式"
在默认系统提示词后追加指令
claude --permission-mode plan
以 plan 模式启动（只读规划，不改动文件）
claude --dangerously-skip-permissions
跳过所有权限确认（仅限可信环境，慎用）
claude -w feat/login
在独立 git worktree 中启动（--worktree）
claude --effort high "设计缓存层架构"
设置推理强度 low/medium/high/xhigh/max
claude --bg "跑测试套件"
作为后台 Agent 启动并立即返回
claude --verbose
显示逐轮工具执行详情

会话管理斜杠命令 7

/clear
清空对话历史，切换到全新任务
/compact
总结对话释放上下文窗口空间
/context
可视化上下文窗口用量与优化建议
/resume
从选择器或按名称重开历史会话
/branch
派生对话尝试不同方向
/rewind
把代码和对话回滚到检查点
/exit
退出 REPL

项目与开发斜杠命令 10

/init
为项目生成 starter CLAUDE.md
/memory
编辑 CLAUDE.md 并管理自动记忆
/mcp
交互式管理 MCP 服务器连接
/agents
配置子代理（subagent）设置
/permissions
设置工具允许/询问/拒绝规则
/hooks
查看 Hook 配置
/plan
进入 plan 模式，大改动前先规划
/model
切换当前激活模型
/diff
打开交互式 diff 查看器
/code-review --fix
对当前 diff 做代码审查（可自动修复）

MCP 服务器管理 7

claude mcp add --transport http <name> <url>
添加 HTTP 传输的 MCP 服务器（推荐方式）
claude mcp add <name> -- <args...>
添加 stdio 类型 MCP 服务器，命令接在 -- 后
claude mcp add-json '<json>'
从 JSON 配置添加复杂 MCP 服务器
claude mcp list
列出已配置的 MCP 服务器
claude mcp get <name>
查看某 MCP 服务器配置
claude mcp remove <name>
移除某个 MCP 服务器
claude mcp add-from-claude-desktop
从 Claude Desktop 导入已配置的 MCP 服务器

提示词内文件引用 3

Review @./src/components/Button.tsx
在提示词中用 @ 引用单个文件
Compare @src/old.js with @src/new.js
同时引用多个文件进行对比
Explain the structure of @./src
引用整个目录让 Claude 理解结构

参数矩阵

参数作用示例
-p打印模式，不进交互，供脚本与 CI 使用claude -p "列出本项目所有 TODO 注释"
--output-format json以 JSON 输出，便于程序解析claude -p --output-format json "列出 TODO"
-m <model>指定模型claude -p -m claude-sonnet-4 "写一个解析 CSV 的函数"
--max-turns <n>限制 Agent 轮次上限，防止失控操作claude -p --max-turns 5 "重构 auth 模块"
--max-budget-usd <n>限制打印模式下的 API 花费上限claude --max-budget-usd 2 "实现登录页"
--add-dir <dir>授权额外工作目录供访问claude --add-dir ../frontend ../backend
--permission-mode plan只读规划模式，不改动文件claude --permission-mode plan
--dangerously-skip-permissions跳过所有权限确认，仅限可信环境claude --dangerously-skip-permissions
-c / -r <id>继续最近一次会话 / 恢复指定会话claude -r "abc123" "继续完成 PR"
-w <branch>在独立 git worktree 中启动claude -w feat/login
--system-prompt <s>替换整个系统提示词claude --system-prompt "你是一名安全审计员"
--append-system-prompt <s>在默认系统提示词后追加指令claude --append-system-prompt "使用 TypeScript 严格模式"
--effort <lvl>设置推理强度 low/medium/high/xhigh/maxclaude --effort high "设计缓存层架构"
--bg作为后台 Agent 启动并立即返回claude --bg "跑测试套件"
--verbose显示逐轮工具执行详情claude --verbose
mcp add --transport http添加 HTTP 传输的 MCP 服务器（推荐）claude mcp add --transport http docs https://example.com/mcp
mcp add <name> -- <args...>添加 stdio 类型 MCP 服务器claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem .
mcp add-json <json>从 JSON 配置添加复杂 MCP 服务器claude mcp add-json '{"name":"x"}'
@./path在提示词里引用文件或目录作为上下文Review @./src/components/Button.tsx

易错点与避坑指南

现象CI 脚本里读不到结果，进程像是只打印了内容就退出

原因没有加 -p，命令进了交互式 REPL，在非 TTY 环境里拿不到稳定的输出通道。

处置一律用 claude -p，需要结构化结果时再加 --output-format json。

现象自动化任务把仓库改得面目全非，或者无限循环地改同一个文件

原因Agent 轮次与花费都没有上限，遇到难点时会持续尝试。

处置用 --max-turns 5 和 --max-budget-usd 2 双保险；大改动前先用 --permission-mode plan 只出方案。

现象模型说看不到相邻目录或上层目录里的文件

原因默认只在当前工作目录内授权，跨目录访问被拦下。

处置用 --add-dir ../frontend ../backend 显式授权需要访问的目录。

现象长会话后半程开始忽略早期约束，响应变慢

原因上下文窗口被历史对话占满，工具输出又特别占额度。

处置用 /context 查看占用情况，/compact 总结压缩；任务真正换了主题就直接 /clear。

现象提示词越写越长、文件内容粘贴进去后模型仍然答错

原因手抄的内容丢失了上下文，也难以维护；大段粘贴反而稀释了指令权重。

处置改用 @./src 这类文件引用让工具按需读取，既准确又便于在仓库里版本化。

现象命令改了文件但没有回到可回退的状态，改坏了难以撤销

原因没有检查点，缺少版本控制兜底。

处置用 /rewind 回滚到检查点，或在独立 worktree 中启动（-w feat/login），保证主分支干净。

现象MCP 服务器配了但工具不生效

原因stdio 类型把命令写在了 -- 之前，或 HTTP 类型缺少 --transport http 导致配置类型不匹配。

处置用 claude mcp list 与 claude mcp get <name> 核对，必要时用 claude mcp add-json 直接贴完整 JSON 配置。

排障路径

  1. 1确认安装与认证状态

    claude --version && claude auth status

    版本和登录两项都正常才可能进入会话；未登录用 claude auth login 补上。

  2. 2用 JSON 输出验证非交互调用链路

    claude -p --output-format json "列出本项目所有 TODO 注释"

    能拿到可解析的 JSON 说明 -p 模式与模型调用均正常，便于后续接脚本。

  3. 3管道喂入上下文并只取打印结果

    cat error.log | claude -p "解释这个错误并给出修复"

    同时验证管道输入与打印模式，错误日志会作为上下文进入会话。

  4. 4用有限预算的低成本调用试探改动规模

    claude --max-budget-usd 2 "实现登录页"

    超预算会自动中止并已花费的金额可查，适合在本地先做成本预估。

  5. 5检查 MCP 服务器注册情况

    claude mcp list

    列出已配置服务器，某个名字缺失就说明添加命令没生效。

  6. 6在独立 worktree 里试运行改动

    claude -w feat/login "实现登录页"

    改动隔离在单独工作树里，主分支不受影响，验证通过再合并。

命令示例

打印模式修复失败的测试

claude -p --output-format json "运行测试，根据失败信息定位根因并给出修复方案" cat log.txt | claude -p "分析这个错误的根因并给出修复步骤"

-p 只输出结果后退出，加 --output-format json 便于脚本直接解析，是自动化调用的事实标准。

输出

{"status":"root cause identified","cause":"user-auth 模块未处理空 token","fix":"在 session 校验前补充 null 检查"}

恢复上次会话继续重构

claude -c echo "错误日志" | claude -c -p "检查类型错误"

用 -c（最近会话）或 -r <session-id>（指定会话）在终端重启后即可无痛续接。

输出

（进入 REPL，恢复上文中的上下文与已做改动，可继续对话或改文件）

大改动前用只读模式规划

claude --permission-mode plan "重构支付模块，先给出改动清单和风险点"

plan 模式下模型只做读与分析，确认方案后再按默认权限执行，能显著降低返工。

输出

（仅输出规划报告，不修改任何文件）

接入 Postgres MCP 服务器

claude mcp add --transport http my-pg http://localhost:8080/mcp claude mcp list

接入后可在会话里让 Claude 直接查询数据库并基于结果写代码，省去手动复制查询结果。

输出

✔ Added MCP server "my-pg" (HTTP)

常见坑与注意事项

  • --dangerously-skip-permissions 会跳过所有权限确认，模型可直接改文件与执行命令，务必仅在可信容器或一次性环境使用。
  • --max-budget-usd 只对 -p 打印模式生效；交互式 REPL 的扣费上限需要另用预算机制控制，别指望它拦住长会话。
  • 改动前后会展示 diff，但若你修改了 CLAUDE.md/AGENTS.md 或项目依赖，会改变模型后续行为，改动前先确认这些记忆文件。
  • MCP stdio 服务器由 claude 子进程拉起，若其异常退出可能拖累 Agent，卡顿时用 /mcp 检查连接状态。

提示

  • 脚本与 CI 中首选 claude -p --output-format json 组合：打印模式 + JSON 输出是自动化调用的事实标准。
  • 长任务或受限预算用 --max-turns 和 --max-budget-usd 双保险，避免 Agent 失控刷爆 API 额度。
  • 给 Claude 更多上下文用 @file / @dir 直接引用，比把文件内容粘进提示词更准、更易维护。
  • 大改动前先 /plan 进入只读规划模式确认方案，再放权限执行，能显著降低返工率。

常见问题

Claude Code 的 -p（打印模式）和交互式 REPL 有什么区别？

交互式 REPL 适合探索性开发，可多轮对话并修改文件；-p 打印模式适合脚本和流水线，命令一次性执行后直接输出结果并退出，可配合 --output-format json 便于程序解析。

如何让 Claude Code 自动批准所有操作而不弹确认？

可使用 --dangerously-skip-permissions 跳过所有权限确认，或用 --permission-mode 设为 acceptEdits / bypassPermissions。仅限可信环境使用，因为跳过后 Agent 可直接改动文件与执行命令。

Claude Code 如何接入 MCP 服务器扩展能力？

通过 /mcp 斜杠命令交互式管理连接，或用 claude mcp add <name> <command> 添加外部 MCP 服务器（如数据库、文件系统、API）。接入后 Agent 可在会话中调用这些工具。

相关速查表

6 份相关速查表

Codex CLI 命令速查表 - OpenAI 终端编码代理全参数OpenAI 开源的 Rust 终端编码代理 Codex CLI 命令手册：安装认证、交互与非交互 codex exec、会话管理、模型与配置、沙箱批准模式、MCP 与 Codex Cloud 接入。Gemini CLI 命令速查表 - Google 终端 AI 代理全参数Google 开源（Apache 2.0）终端 AI 代理 Gemini CLI 命令手册：安装认证、运行模式与全局标志、会话斜杠命令、MCP/扩展管理、GEMINI.md 项目记忆，可发挥 2M 长上下文。Cursor 编辑器 CLI 速查表 - 新窗口 -n 与 Agent 参数Cursor 命令行速查表：用 cursor -n 在新窗口打开项目、-r 复用窗口、diff 与扩展管理、远程开发调试，以及 cursor-agent 非交互调用与 git core.editor 集成。Aider 命令速查表 - 开源终端 AI 结对编程全参数开源 Apache 2.0 终端 AI 结对编程工具 Aider 的命令手册：安装、模型与推理、文件与上下文、聊天模式、Git 与运行、会话工具与高级用法，覆盖自动 git 提交及 /add、/architect、--lint-cmd 等真实命令。OpenCode 命令速查表 - 开源 TUI AI 编码代理全参数开源 TUI 终端 AI 编码代理 OpenCode 的命令手册：启动与续接、CLI 标志、会话与子命令（agent/auth/github/mcp/run/serve/web）、交互斜杠命令，覆盖 -c/-s/--fork/--model/--agent 等真实命令。Goose CLI 命令速查表 - Block/Linux 基金会 AAIF 代理全参数Linux Foundation AAIF 开源通用终端 AI 代理 Goose（Rust/Apache-2.0）的命令手册：安装、会话、运行、配置、扩展与诊断，覆盖 goose session/run/configure/cook/doctor、--resume 与 70+ MCP 扩展接入。

官方参考来源

下方为命令对应的官方权威文档，供你核对最新用法与深入查阅。

由 巧匠 维护

公开更新于 2026年8月5日，内容持续校对官方文档。

联系我们

命令或描述有误？提交反馈、商务合作或产品建议都可发送邮件给我们。

联系我们