本文系统整理 Anthropic 官方命令行工具 Claude Code（终端里的 Claude）的全部常用命令、启动参数、斜杠命令、快捷键、配置文件、权限机制、MCP 与 Hook 用法，并附实战示例与 FAQ。收藏这一篇，日常开发基本不用再翻文档。

---

目录

1. 启动与退出
2. 核心启动参数（CLI Flags）
3. 子命令（Subcommands）
4. 会话内斜杠命令（Slash Commands）
5. 键盘快捷键
6. 配置文件与 CLAUDE.md
7. 权限与权限模式
8. MCP 工具配置
9. Hooks 钩子（自动化）
10. 实战场景示例
11. 效率技巧
12. 常见问题 FAQ

---

一、启动与退出

命令	作用
claude	进入交互式 REPL（最常用）
claude "一句话需求"	带着初始 prompt 启动
claude -p "..."	打印模式：执行后直接输出结果并退出，适合管道
claude -c / claude --continue	继续最近一次会话
claude -r / claude --resume	弹出历史会话列表，选择恢复
claude -v / claude --version	查看版本
claude -h / claude --help	查看完整帮助

退出会话

• 输入 exit 或 /exit
• 快捷键 Ctrl + D（发送 EOF）
• 或 Ctrl + C 多次中断后退出（部分环境）

小提示：交互模式下，连续两次 Ctrl + C 可中断当前 AI 执行。

---

二、核心启动参数（CLI Flags）

下面是日常最常用、也是最容易忘的参数，建议收藏。

参数	说明
-p, --print	打印模式，执行完直接输出并退出（非交互），适合脚本
-y, --yes	自动同意所有权限提示（等价于 --dangerously-skip-permissions）
--dangerously-skip-permissions	跳过所有权限确认，仅在你信任的环境使用
-m, --model <model>	指定本次会话模型，如 claude-sonnet-4-0 / claude-opus-4-0
--fallback-model <model>	主模型不可用时的备用模型
--output-format <fmt>	输出格式：text（默认）/ json / stream-json
--input-format <fmt>	输入格式：text（默认）/ stream-json
--verbose	输出详细日志
--permission-mode <mode>	权限模式：default / acceptEdits / bypassPermissions / plan
--allowedTools <tools>	逗号分隔，只允许指定工具（如 Bash,Edit,Read）
--disallowedTools <tools>	逗号分隔，禁用指定工具
--mcp-config <path>	指定 MCP 配置文件路径
--add-dir <dir>	额外授权可访问的目录（可多次）
--system-prompt <prompt>	覆盖系统提示词（可多次）
--append-system-prompt <prompt>	追加系统提示词（可多次）
--session-id <uuid>	指定会话 ID 以便恢复
--settings <json> / --settings-file <path>	注入 / 指定设置
--config-file <path>	指定配置来源
-d, --debug	调试模式
--no-color	关闭彩色输出

常见组合示例

# 跳过权限，用指定模型跑一条任务并直接退出（自动化神器）
claude -y -m claude-sonnet-4-0 -p "给 src/ 写单元测试"

# 只开放读写文件，禁止执行命令（更安全的自动化）
claude -p --allowedTools "Read,Edit,Write,Glob,Grep" "重构 utils.ts"

# 以 JSON 格式输出，方便被其他程序解析
claude -p --output-format json "解释 main.py 的入口逻辑"

# 把 Claude 当管道工具用
cat error.log | claude -p "这是一段报错，给出可能原因和修复方案"

⚠️ --dangerously-skip-permissions 会放行文件写入、命令执行等敏感操作。命令越长越易手滑，建议起个别名。例如在你的 ~/.zshrc 里加：

alias claude-skip="claude --dangerously-skip-permissions"

之后 claude-skip -p "..." 即可。

---

三、子命令（Subcommands）

除了交互模式，Claude Code 还带几个独立子命令，最常用的是 mcp 和 config。

claude mcp add <name> <command...>   # 添加一个 MCP 服务器
claude mcp add-json <name> <json>    # 用 JSON 添加 MCP 服务器
claude mcp list                      # 列出已配置的 MCP 服务器
claude mcp get <name>                # 查看某个 MCP 服务器详情
claude mcp remove <name>             # 移除 MCP 服务器

claude config get <key>              # 读取某项配置
claude config set <key> <value>      # 设置某项配置
claude config list                   # 列出全部配置

claude update                        # 更新到最新版
claude doctor                        # 诊断环境/配置问题

示例：

# 添加本地 stdio 型 MCP 服务器
claude mcp add my-tool -- npx -y my-mcp-server

# 查看某配置项
claude config get model

---

四、会话内斜杠命令（Slash Commands）

在 REPL 交互界面里输入 / 即可触发，是提效的关键武器。

命令	作用
/help	列出所有命令与用法
/clear	清空当前对话上下文（轻量重置）
/compact	压缩对话历史，释放上下文窗口
/config	修改会话级配置
/cost	查看本次会话的 token 消耗与花费
/doctor	诊断运行环境
/init	根据项目结构生成 CLAUDE.md 记忆文件
/login	登录 / 切换账号
/logout	退出登录
/memory	编辑长期记忆文件
/model	切换当前使用的模型
/permissions	查看 / 调整权限规则
/review	对改动做代码评审
/status	查看当前状态（模型、权限、目录等）
/vim	切换 Vim 编辑模式
/ide	配置 / 查看 IDE 集成状态
/terminal-setup	安装终端集成（更好看的历史、补全）
/mcp	管理 MCP 服务器
/add-dir	在会话中追加可访问目录
/reset	重置配置到默认

斜杠命令也可以在命令行直接调用，例如 claude /review、claude /compact。

---

五、键盘快捷键

交互模式下（基于终端 UI）：

快捷键	作用
Ctrl + C	中断当前 AI 执行（连按两次退出）
Ctrl + D	发送 EOF，退出会话
Ctrl + L	清屏
Ctrl + R	搜索历史命令
↑ / ↓	浏览历史输入
Tab	自动补全
Esc	取消当前输入
Shift + Tab	循环切换权限模式（default → acceptEdits → bypassPermissions）
Ctrl + Z	将 Claude 挂起（fg 可恢复）

---

六、配置文件与 CLAUDE.md

Claude Code 有三层配置体系，理解它能让 AI 更“懂”你的项目。

1. 用户级（全局）
~/.claude/settings.json — 所有项目共享的偏好，如默认模型、主题、权限。

2. 项目级
.claude/settings.json（项目根目录）— 团队共享的仓库配置。

3. 项目记忆 CLAUDE.md

放在仓库根目录，Claude 每次启动都会读它，相当于给 AI 的“项目说明书”。建议写入：

• 项目技术栈与目录结构
• 命令约定（构建、测试、lint 怎么跑）
• 代码风格与命名规范
• 常见坑与注意事项

示例 CLAUDE.md：

# 项目说明
- 技术栈：Next.js 14 + TypeScript + Tailwind
- 构建：npm run build
- 测试：npm test
- 代码风格：函数式为主，禁止 any
- 注意：改动 API 后必须同步更新 docs/

生成命令：

claude /init   # 让 Claude 自动扫描项目并起草 CLAUDE.md

---

七、权限与权限模式

Claude 执行“危险”操作（写文件、跑命令）前会请求确认。四种权限模式：

模式	行为
default	每个敏感操作都弹确认
acceptEdits	自动接受文件编辑，命令仍需确认
bypassPermissions	全部放行（等价于 --dangerously-skip-permissions）
plan	规划模式，只分析不改代码

设置方式

# 启动时指定
claude --permission-mode acceptEdits

# 会话内用 Shift+Tab 循环切换，或 /permissions 查看

精细化权限（settings.json 示例）

{
  "permissions": {
    "allow": ["Bash(npm test)", "Bash(npm run build)", "Edit(~/.claude/**)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

---

八、MCP 工具配置

MCP（Model Context Protocol）让 Claude 接入外部工具/数据源（数据库、浏览器、内部 API 等）。

添加 MCP 服务器

# stdio 型（最常用）
claude mcp add github -- npx -y @anthropic-ai/mcp-server-github

# 带环境变量
claude mcp add mydb --env API_KEY=xxx -- npx -y my-db-mcp

# 远程型（HTTP/SSE）
claude mcp add remote-foo --transport http https://example.com/mcp

# JSON 方式（适合复杂配置）
claude mcp add-json my-srv '{"command":"npx","args":["-y","pkg"],"env":{"K":"V"}}'

管理

claude mcp list       # 列出全部
claude mcp get my-srv # 查看详情
claude mcp remove my-srv

配置文件位置：MCP 配置会写入 ~/.claude.json（用户级）或项目 .mcp.json。

---

九、Hooks 钩子（自动化）

Hooks 允许在 Claude 执行某些动作前后自动触发脚本，典型用途：

• 提交前自动 lint / 格式化
• 写文件后自动跑测试
• 记录操作审计日志

配置示例（settings.json）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npx prettier --write $CLAUDE_FILE_PATHS" }
        ]
      }
    ]
  }
}

常用事件：PreToolUse、PostToolUse、Notification、Stop。

---

十、实战场景示例

场景 1：自动化修复 CI 报错

claude -y -p "读取 .github/workflows 的失败日志，定位并修复导致 CI 失败的代码"

场景 2：给新同事生成项目上手文档

claude /init   # 然后追加 /memory 说明约定

场景 3：评审 PR

claude /review

场景 4：当管道工具处理日志

kubectl logs pod-xxx | claude -p --output-format text "总结关键错误并给修复建议"

场景 5：长对话压缩继续干活

claude /compact     # 压缩上下文
claude -c           # 下次继续

---

十一、效率技巧

1. 写一份高质量的 CLAUDE.md：越是复杂项目，越要花几分钟写清楚约定，后面省下的时间是指数级的。
2. 用别名省键盘：claude-skip 等别名处理长参数。
3. 善用打印模式进脚本：claude -p + --output-format json 可嵌进 CI、Git hook、定时任务。
4. Shift + Tab 切权限：临时需要放行时不用退出重开。
5. /cost 控预算：长任务中随时看 token 消耗。
6. /compact 续命：上下文快满时压缩，保留关键记忆。
7. 按项目配 .claude/settings.json：把团队权限、hooks 固化进仓库，新人 clone 即用。

---

十二、常见问题 FAQ

Q1：提示 command not found: claude？
A：确认全局安装成功，npm prefix -g 的 bin 目录在 $PATH 里；或重装 npm install -g @anthropic-ai/claude-code。

Q2：--dangerously-skip-permissions 安全吗？
A：会跳过所有确认，只在本机、可信目录、可信任务下使用，切勿在公共/生产服务器上裸跑。

Q3：如何切换模型？
A：会话内 /model，或启动时 --model claude-opus-4-0。

Q4：上下文太长变慢/报错？
A：用 /compact 压缩，或 /clear 重新开始，重要信息写进 CLAUDE.md。

Q5：如何团队协作共享配置？
A：把 .claude/settings.json 和 CLAUDE.md 提交进仓库；MCP 用 .mcp.json。

Q6：Claude 能直接改我的 Git 并提 PR 吗？
A：可以，它原生支持 Git 操作，但建议用 default/acceptEdits 权限模式，提交前自己 review。

---

总结

Claude Code 的威力在于“命令行即能力”：-p 让你把它当管道工具，/review、/compact 提供工程化工作流，MCP 与 Hooks 则把它接进你的整个工具链。记住三件套——写好 CLAUDE.md、管好权限模式、用好打印模式——基本就能覆盖 90% 的开发场景。

如果本文对你有帮助，欢迎点赞收藏，也欢迎在评论区补充你常用的命令组合 👇

---

本文命令基于 Claude Code 近期稳定版整理，版本迭代请以 claude --help 为准。