Claude_Code_命令速查手册

一、每天都要用

启动 & 退出

claude                                      # 启动交互会话
claude "帮我看下这个报错"                      # 带问题启动
claude -c                                   # 恢复上次对话
claude -r "会话名"                           # 恢复指定会话
claude --dangerously-skip-permissions       # 跳过所有权限
Ctrl+D  或  /exit                           # 退出

输入前缀（最实用）

前缀	功能	示例
!	直接跑 Bash	!git status
@	引用文件	@src/main.ts 帮我看看这个文件
/	斜杠命令	/compact

最常用斜杠命令（Top 12）

命令	干什么	什么时候用
/compact [指令]	压缩上下文	对话太长、变卡时
/clear	清空对话	换话题时（别名 /reset、/new）
/model	切换模型	需要更强/更快模型时
/plan [描述]	只读分析模式	不想让它改代码，只想分析
/init	生成 CLAUDE.md	新项目第一次使用
/memory	编辑记忆指令	调整项目规则
/cost	看 Token 消耗	关心花费时
/resume	恢复历史会话	找回之前的工作（别名 /continue）
/diff	交互式 diff 查看器	检查 Claude 改了什么
/rewind	回退检查点	改坏了要撤回（别名 /checkpoint）
/branch	分叉当前对话	想从某个点重新开始（别名 /fork）
/help	帮助菜单	忘了命令时

键盘快捷键（核心）

快捷键	功能
Ctrl+C	中断生成（硬编码，不可重绑定）
Esc Esc	回退（Rewind）/ 汇总
Ctrl+D	退出 Claude Code（硬编码）
Ctrl+L	清屏（保留对话历史）
Ctrl+R	反向搜索命令历史
Ctrl+O	切换详细输出（看工具调用细节）
Ctrl+B	任务放后台（tmux 用户按两次）
Ctrl+T	切换任务列表
Ctrl+G	在外部编辑器中打开当前输入
Shift+Tab / Alt+M	循环切换权限模式（Windows 推荐用 Alt+M）
Alt+P	切换模型
Alt+T / Meta+T	切换扩展思考（Thinking）
Alt+O	切换快速模式
Ctrl+X Ctrl+K	杀死所有后台 Agent（3秒内按两次确认）

多行输入

方式	说明
\ + Enter	反斜杠续行（所有终端通用）
Option+Enter (Mac)	换行继续输入
Shift+Enter	换行（iTerm2/WezTerm/Ghostty/Kitty 原生支持）
Ctrl+J	换行符
Ctrl+V / Cmd+V	粘贴多行自动识别
直接粘贴	代码块/日志自动进入多行模式

---

二、经常用

权限模式

模式	说明	适用场景
default	新工具需确认	日常开发
acceptEdits	自动接受文件编辑	大量重构
plan	只读，不可修改	代码审查
auto	后台自动审批	信任环境
dontAsk	自动拒绝未预批工具	限制行为
bypassPermissions	跳过所有提示	隔离/CI 环境

Shift+Tab 或 Alt+M 可在会话中实时切换

模型 & 推理

/model                      # 交互式切换模型
/effort high                # 深度推理 (low/medium/high/max/auto)
/fast                       # 快速模式（同模型，更快输出）
/vim                        # Vim 编辑模式
​
# CLI 标志方式
claude --model claude-sonnet-4-6
claude --effort high

会话管理

命令/快捷键	功能
/resume	恢复历史会话（交互选择，别名 /continue）
claude -c	快速恢复最近对话
claude -r "名称"	恢复指定会话
/rewind	回退到之前的检查点（别名 /checkpoint）
/branch	分叉当前对话（别名 /fork）
/rename	重命名当前会话
/export	导出为纯文本
/copy [N]	复制最后回复到剪贴板
Ctrl+R	反向搜索历史命令

项目配置（CLAUDE.md）

/init        # 在项目根目录生成 CLAUDE.md（最重要的一步）
/memory      # 编辑 CLAUDE.md 内容

CLAUDE.md 层级（优先级从高到低）：

~/.claude/CLAUDE.md              # 你的全局偏好（所有项目生效）
项目根/CLAUDE.md                 # 项目共享规则（提交到 Git）
.claude/CLAUDE.md               # 同上（替代位置）
项目根/CLAUDE.local.md          # 项目个人规则（不提交）

示例 CLAUDE.md：

# 项目规则
- 使用 TypeScript strict 模式
- 测试框架用 vitest
- 提交信息用中文
- 禁止修改 .env 文件

其他常用斜杠命令

命令	功能
/add-dir <路径>	添加工作目录
/config	打开设置（别名 /settings）
/permissions	管理权限规则（别名 /allowed-tools）
/context	可视化上下文使用情况
/status	查看版本/模型/账户等
/stats	可视化每日使用量
/usage	查看用量限制和速率限制
/doctor	检查安装健康状态
/btw <问题>	快速附带问题，不影响主对话
/pr-comments	获取 GitHub PR 评论
/security-review	安全审查待提交变更

---

三、开发中常用

Git 集成

# 自然语言操作
"帮我把这些改动提交，信息写 feat: 添加用户登录"
"创建一个 PR 到 main 分支"
"看下最近的 git log"
​
# 斜杠命令
/diff                # 交互式 diff 查看器
/pr-comments         # 获取 GitHub PR 评论
/security-review     # 安全审查
​
# Worktree 隔离开发
claude -w feature-auth          # 在隔离 worktree 中工作
claude -w feature-auth --tmux   # 用 tmux 窗口
​
# PR 关联
claude --from-pr 123            # 从 PR 恢复会话
​
# 恢复时创建分叉
claude --resume "会话名" --fork-session

添加额外目录

# CLI 方式
claude --add-dir ../lib ../shared
​
# 会话内
/add-dir ../shared-lib
​
# 配置文件（settings.json）
"additionalDirectories": ["../shared-lib"]

其余斜杠命令一览

命令	功能
/agents	管理子代理
/chrome	Chrome 浏览器集成
/color [颜色]	设置提示栏颜色
/desktop	在桌面应用中继续（别名 /app，仅 macOS/Windows）
/feedback	提交反馈（别名 /bug）
/hooks	查看 hook 配置
/ide	管理 IDE 集成
/insights	使用分析报告
/install-github-app	安装 GitHub Actions 应用
/install-slack-app	安装 Slack 应用
/keybindings	打开快捷键配置
/login / /logout	登录/登出
/mcp	管理 MCP 服务器
/mobile	下载移动应用（别名 /ios、/android）
/passes	分享免费使用权
/plugin	管理插件
/privacy-settings	隐私设置（仅 Pro/Max）
/rc	远程控制（别名 /remote-control）
/release-notes	查看更新日志
/reload-plugins	重新加载插件
/remote-env	配置远程环境
/sandbox	切换沙箱模式
/schedule	定时任务
/skills	列出可用技能
/stickers	订购贴纸
/tasks	后台任务
/extra-usage	配置额外用量（达速率限制时继续）
/terminal-setup	终端快捷键配置
/theme	切换主题
/upgrade	升级（仅 Pro/Max）
/voice	语音输入

---

四、配置与定制

settings.json 位置

优先级：高 → 低
​
┌─────────────────────────────────────────────┐
│  CLI 参数 — 临时覆盖                         │
│  .claude/settings.local.json — 本地个人      │
│  .claude/settings.json — 项目共享            │
│  ~/.claude/settings.json — 用户全局          │
└─────────────────────────────────────────────┘

核心配置模板

{
  "model": "claude-sonnet-4-6",
  "alwaysThinkingEnabled": true,
  "permissions": {
    "defaultMode": "auto",
    "allow": ["Bash(npm run *)"],
    "deny": ["Bash(git push *)"]
  },
  "env": {
    "ANTHROPIC_BASE_URL": "..."
  },
  "hooks": {},
  "sandbox": {},
  "enabledPlugins": {},
  "additionalDirectories": ["../shared-lib"]
}

权限规则语法

Bash(npm run build)           # 精确匹配
Bash(npm run *)               # 通配符
Bash(*)                       # 等同于 Bash
Read(./.env)                  # 特定文件
Edit(/src/**/*.ts)            # 路径模式
WebFetch(domain:example.com)  # 特定域名
mcp__server__tool             # MCP 工具
Agent(Explore)                # 子代理

优先级: deny > ask > allow

路径规则文件

在 .claude/rules/ 下创建文件，用 YAML frontmatter 匹配路径：

---
description: TypeScript 严格规则
globs: ["**/*.ts", "**/*.tsx"]
---

- 必须使用严格模式
- 禁止 any 类型

快捷键自定义

编辑 ~/.claude/keybindings.json：

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor"
      }
    }
  ]
}

将快捷键设为 null 可取消默认绑定。运行 /keybindings 直接打开配置。

---

五、MCP 服务器

CLI 命令

claude mcp add <名称> --transport http <url>       # 添加 HTTP 类型
claude mcp add <名称> --transport stdio <命令>      # 添加 stdio 类型
claude mcp add-json <名称> '<json配置>'             # 从 JSON 添加
claude mcp add-from-claude-desktop <名称>           # 从 Claude Desktop 导入
claude mcp remove <名称>                            # 移除
claude mcp list                                     # 列出
claude mcp get <名称>                               # 查看详情
claude mcp reset-project-choices                    # 重置项目级 MCP 批准
claude mcp serve                                    # 作为 MCP 服务器运行

配置示例

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "puppeteer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-puppeteer"]
    }
  }
}

配置文件位置

范围	文件
用户级	~/.claude/settings.json
项目共享	.mcp.json
项目个人	.mcp.local.json

---

六、Hooks 自动化

核心事件

事件	触发时机
SessionStart	会话启动
SessionEnd	会话结束
PreToolUse	工具执行前
PostToolUse	工具执行后
Stop	Claude 停止响应
UserPromptSubmit	用户提交提示前
Notification	发送通知
PreCompact	上下文压缩前
PostCompact	上下文压缩后

扩展事件

事件	触发时机
PermissionRequest	权限请求时
PermissionDenied	权限被拒绝时
PostToolUseFailure	工具执行失败后
SubagentStart / SubagentStop	子代理启动/停止
TaskCreated / TaskCompleted	任务创建/完成
StopFailure	停止失败
InstructionsLoaded	指令加载完成
ConfigChange	配置变更
CwdChanged	工作目录变更
FileChanged	文件变更
WorktreeCreate / WorktreeRemove	Worktree 创建/移除
Elicitation / ElicitationResult	引发用户输入

Hook 类型

类型	说明
command	执行 shell 命令
http	发送 HTTP 请求
prompt	返回提示文本
agent	使用子代理处理

配置示例

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npx eslint --fix $FILE_PATH" }]
      }
    ],
    "Stop": [
      {
        "hooks": [{ "type": "command", "command": "say '任务完成'" }]
      }
    ]
  }
}

退出码

退出码	行为
0	成功，继续
2	阻止操作
其他	警告，不阻止

---

七、子代理 & 技能

内置代理

代理	模型	工具	用途
Explore	Haiku（快）	只读	快速搜索分析
Plan	继承主会话	只读	Plan 模式研究
general-purpose	继承主会话	全部	复杂多步任务

自定义代理位置

.claude/agents/          → 项目级
~/.claude/agents/        → 用户级
--agents CLI 标志        → 会话级

技能位置

~/.claude/skills/<名>/SKILL.md     → 用户级
.claude/skills/<名>/SKILL.md       → 项目级

内置技能	说明
/batch <任务>	大规模并行变更（5-30 个 worktree 代理）
/loop [间隔] <提示>	定时循环执行
/simplify	代码质量审查

---

八、IDE 集成

VS Code

快捷键	功能
Cmd/Ctrl+Esc	切换编辑器 ↔ Claude（Focus Input）
Cmd/Ctrl+Shift+Esc	新标签页新对话
Cmd/Ctrl+N	新建对话（Claude 获得焦点时）
Option/Alt+K	插入文件/选区的 @-mention
Cmd/Ctrl+Shift+P → "Claude Code"	命令面板

JetBrains

支持 IntelliJ、WebStorm、PyCharm 全系列。

---

九、CLI 完整标志速查

常用标志

claude -p "问题"                        # 非交互模式
claude -c                                # 恢复最近对话
claude -r "名称"                         # 恢复指定会话
claude --model claude-sonnet-4-6         # 指定模型
claude --effort high                     # 推理深度
claude -w feature-auth                   # Worktree 隔离
claude -w feature-auth --tmux            # 带 tmux
claude --add-dir ../lib ../shared        # 添加目录
claude -n "名称"                         # 会话命名
claude --from-pr 123                     # 从 PR 恢复
claude --fork-session                    # 分叉会话

非交互/CI 模式

claude -p "问题" --output-format json          # JSON 输出
claude -p "问题" --output-format stream-json    # 流式 JSON
claude -p "问题" --max-budget-usd 5.00          # 限制花费
claude -p "问题" --max-turns 3                  # 限制轮次
claude -p "问题" --allowedTools "Read" "Bash(git *)"  # 预授权
claude -p "问题" --disallowedTools "Bash(git push *)"  # 禁用
claude -p "问题" --json-schema '{...}'          # 结构化输出
claude -p "问题" --input-format stream-json     # 流式输入

高级标志

标志	说明
--system-prompt "..."	替换系统提示
--append-system-prompt "..."	追加系统提示
--dangerously-skip-permissions	跳过所有权限（仅 CI）
--permission-mode auto	设置权限模式
--tools "Bash,Edit,Read"	限制可用工具
--agent <名称>	指定代理
--bare	最小模式加速启动
--verbose	详细输出
--debug "api,mcp"	调试模式
--fallback-model sonnet	模型过载时回退
--mcp-config ./mcp.json	加载 MCP 配置
--remote "任务"	Web 会话
--teleport	恢复 Web 会话到本地
--settings ./settings.json	额外设置文件
--init / --init-only	运行初始化 hooks

---

十、沙箱 & 环境变量

沙箱

平台	实现方式
macOS	Seatbelt 框架
Linux/WSL2	bubblewrap

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/.kube"],
      "denyRead": ["~/secrets/"]
    },
    "network": {
      "allowedDomains": ["github.com"]
    }
  }
}

环境变量

变量	说明
ANTHROPIC_BASE_URL	自定义 API 端点
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE	自动压缩触发百分比（如 50 = 50% 时触发）
API_TIMEOUT_MS	API 超时

---

快速场景速查

场景	操作
新项目开始	/init → 写好 CLAUDE.md 规则
对话太长变卡	/compact
换个话题	/clear
只想分析不改代码	/plan 或 Alt+M 切 Plan 模式
想要更深思考	/effort high
看花了多少钱	/cost
检查 Claude 改了什么	/diff
不小心改坏了	/rewind 回退
跑个命令	!npm run build
看某个文件	@src/app.ts 帮我分析
隔离开发功能	claude -w feature-xxx
自动化 CI	claude -p "任务" --allowedTools ... --output-format json
调试问题	/effort high → 详细输出 Ctrl+O
任务完成了要通知	Hooks → Stop 事件 → macOS: say '完成' · Windows: powershell -c "Write-Host '完成'"
保存对话	/export 导出为文本

---

输入 /help 随时查看完整命令列表 · 共 57 个内置斜杠命令