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 个内置斜杠命令

一	二	三	四	五	六	日
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30

新年倒计时

一、每天都要用

启动 & 退出

输入前缀（最实用）

最常用斜杠命令（Top 12）

键盘快捷键（核心）

多行输入

二、经常用

权限模式

模型 & 推理

会话管理

项目配置（CLAUDE.md）

其他常用斜杠命令

三、开发中常用

Git 集成

添加额外目录

其余斜杠命令一览

四、配置与定制

settings.json 位置

核心配置模板

权限规则语法

路径规则文件

快捷键自定义

五、MCP 服务器

CLI 命令

配置示例

配置文件位置

六、Hooks 自动化

核心事件

扩展事件

Hook 类型

配置示例

退出码

七、子代理 & 技能

内置代理

自定义代理位置

技能位置

八、IDE 集成

VS Code

JetBrains

九、CLI 完整标志速查

常用标志

非交互/CI 模式

高级标志

十、沙箱 & 环境变量

沙箱

环境变量

快速场景速查

发送评论 编辑评论

推荐文章

发送评论编辑评论