Claude Code 命令速查表 - Anthropic AI 编码代理 CLI 全参数
Claude Code 面向需要在终端里让 AI 直接读代码、改文件并执行命令的开发者，以及希望把编码代理接入 CI 的自动化工程师，它的定位是官方原生的 Agent 型编码工具，与 ChatGPT 式纯问答不同。它能以 -p 打印模式 + --output-format json 无头驱动流水线，也能在交互式 REPL 里多轮迭代；本表帮你快速定位安装认证、会话续接、权限模式与 MCP 扩展的关键命令，读完即可上手实际项目。
典型使用场景
Claude Code 最常用在两处：一是需要 AI 直接改动仓库代码的日常编码（重构模块、修 bug、补测试、写新功能），开发者用交互式 REPL 让模型读取文件、定位问题并落地修改；二是把编码交给脚本/CI 的自动化，用 -p 打印模式配合 --output-format json 完成一次性审查、注释或代码生成。它特别适合当作"结对工程师"理解项目结构的场景，尤其是把构建/测试/lint 命令写进 CLAUDE.md、并用 @file 引用上下文时，能显著减少无效往返。对不想让模型乱改文件的场景，可先用 /plan 只读规划、确认后再放权限执行。
安装与认证 7
npm install -g @anthropic-ai/claude-codeclaude --versionnpm update -g @anthropic-ai/claude-codeclaude updateclaude auth loginclaude auth statusclaude auth logout启动与运行 6
claudeclaude "重构 user-auth 模块使用新的 session API"cat error.log | claude -p "解释这个错误并给出修复"claude -cclaude -r "abc123" "继续完成 PR"claude -c -p "检查类型错误"CLI 标志位 13
claude -p -m claude-sonnet-4 "写一个解析 CSV 的 Python 函数"claude -p --output-format json "列出本项目所有 TODO 注释"claude -p --max-turns 5 "重构 auth 模块"claude --max-budget-usd 2 "实现登录页"claude --add-dir ../frontend ../backendclaude --system-prompt "你是一名安全审计员"claude --append-system-prompt "使用 TypeScript 严格模式"claude --permission-mode planclaude --dangerously-skip-permissionsclaude -w feat/loginclaude --effort high "设计缓存层架构"claude --bg "跑测试套件"claude --verbose会话管理斜杠命令 7
/clear/compact/context/resume/branch/rewind/exit项目与开发斜杠命令 10
/init/memory/mcp/agents/permissions/hooks/plan/model/diff/code-review --fixMCP 服务器管理 7
claude mcp add --transport http <name> <url>claude mcp add <name> -- <args...>claude mcp add-json '<json>'claude mcp listclaude mcp get <name>claude mcp remove <name>claude mcp add-from-claude-desktop提示词内文件引用 3
Review @./src/components/Button.tsxCompare @src/old.js with @src/new.jsExplain the structure of @./src命令示例
打印模式修复失败的测试
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 可在会话中调用这些工具。
由 巧匠 维护
公开更新于 2026年8月5日，内容持续校对官方文档。