# Claude Code 速查表

> 命令以本机 `claude --version` 与 [官方 Releases](https://github.com/anthropics/claude-code/releases) 为准。收藏本页，随时查阅。

---

## 键盘快捷键

### 通用控制

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+C` | 取消输入 / 中断生成 |
| `Ctrl+D` | 退出会话 |
| `Ctrl+L` | 清屏 |
| `Ctrl+O` | 切换详细输出（查看思考过程） |
| `Ctrl+R` | 反向搜索历史 |
| `Ctrl+G` | 在编辑器中打开提示词 |
| `Ctrl+B` | 后台运行当前任务 |
| `Ctrl+T` | 切换任务列表 |
| `Ctrl+V` | 粘贴图片 |
| `Ctrl+F` | 杀死后台 agents（连按 2 次） |
| `Esc` `Esc` | 回退 / 撤销上一步 |

### 模式切换

| 快捷键 | 功能 |
|--------|------|
| `Shift+Tab` | 循环切换权限模式（普通 → 自动接受 → Plan） |
| `Alt+P` | 切换模型 |
| `Alt+T` | 切换思考模式 |

### 输入技巧

| 快捷键 | 功能 |
|--------|------|
| `\` + `Enter` | 换行（快捷方式） |
| `Ctrl+J` | 换行（控制序列） |

### 前缀符号

| 前缀 | 功能 |
|------|------|
| `/` | Slash 命令 |
| `!` | 直接执行 bash 命令 |
| `@` | 文件提及 + 自动补全 |

### 会话选择器

| 快捷键 | 功能 |
|--------|------|
| `↑` `↓` | 导航 |
| `←` `→` | 展开 / 折叠 |
| `P` | 预览 |
| `R` | 重命名 |
| `/` | 搜索 |
| `A` | 全部项目 |
| `B` | 当前分支 |

---

## Slash 命令

### 会话管理

| 命令 | 功能 |
|------|------|
| `/clear` | 清空对话 |
| `/compact [focus]` | 压缩上下文（可指定保留焦点） |
| `/resume` | 恢复 / 切换会话 |
| `/rename [name]` | 为当前会话命名 |
| `/branch [name]` | 分叉对话（`/fork` 别名） |
| `/cost` | Token 使用统计 |
| `/context` | 可视化上下文使用（网格图） |
| `/diff` | 交互式 diff 查看器 |
| `/copy` | 复制上一条回复 |
| `/export` | 导出对话 |

### 配置

| 命令 | 功能 |
|------|------|
| `/config` | 打开设置 |
| `/model [model]` | 切换模型（`←` `→` 调节 effort） |
| `/fast [on\|off]` | 切换快速模式 |
| `/vim` | 切换 vim 模式 |
| `/theme` | 更改颜色主题 |
| `/permissions` | 查看 / 更新权限 |
| `/effort [level]` | 设置 effort 等级（low / med / high / max / auto） |
| `/color [color]` | 设置提示栏颜色 |
| `/keybindings` | 自定义键盘快捷键 |
| `/terminal-setup` | 配置终端快捷键 |

### 工具

| 命令 | 功能 |
|------|------|
| `/init` | 创建 CLAUDE.md |
| `/memory` | 编辑 CLAUDE.md 文件 |
| `/mcp` | 管理 MCP 服务器 |
| `/hooks` | 管理 hooks |
| `/skills` | 列出可用 skills |
| `/agents` | 管理 agents |
| `/chrome` | Chrome 集成 |
| `/reload-plugins` | 热重载插件 |
| `/add-dir <path>` | 添加工作目录 |

### 特殊功能

| 命令 | 功能 |
|------|------|
| `/btw <question>` | 侧边问题（不带上下文，不影响主对话） |
| `/plan [desc]` | Plan 模式（+ 自动开始分析） |
| `/loop [interval]` | 安排周期任务（如 `/loop 5m 检查部署`） |
| `/voice` | 按住说话语音模式（20 种语言） |
| `/doctor` | 诊断安装问题 |
| `/pr-comments [PR]` | 获取 GitHub PR 评论 |
| `/stats` | 使用 streak 和偏好统计 |
| `/insights` | 分析会话报告 |
| `/desktop` | 继续到 Desktop 应用 |
| `/remote-control` | 连接 claude.ai/code（别名 `/rc`） |
| `/usage` | 套餐限额与速率状态 |
| `/schedule` | 云端计划任务 |
| `/security-review` | 变更的安全分析 |
| `/help` | 显示帮助 + 所有命令 |
| `/feedback` | 提交反馈（别名 `/bug`） |
| `/release-notes` | 查看完整更新日志 |

---

## CLI 命令与参数

### 核心命令

| 命令 | 功能 |
|------|------|
| `claude` | 交互式启动 |
| `claude "question"` | 携带初始提示词启动 |
| `claude -p "query"` | 无头模式（非交互） |
| `claude -c` | 继续最近一次对话 |
| `claude -r "name"` | 按名称恢复会话 |
| `claude update` | 更新到最新版本 |

### 关键 Flags

| Flag | 功能 |
|------|------|
| `--model` | 设置模型 |
| `-w` | Git worktree 模式 |
| `-n` / `--name` | 会话名称 |
| `--add-dir` | 添加额外目录 |
| `--agent` | 使用指定 agent |
| `--allowedTools` | 预批准指定工具 |
| `--output-format` | 输出格式（json / stream-json） |
| `--json-schema` | 结构化 JSON 输出 |
| `--max-turns` | 限制交互轮数 |
| `--max-budget-usd` | 成本上限（美元） |
| `--console` | 通过 Anthropic Console 认证 |
| `--verbose` | 详细输出 |
| `--bare` | 极简无头模式（无 hooks/LSP/插件） |
| `--channels` | 权限转发 / MCP 推送消息 |
| `--remote` | 网页会话 |
| `--effort` | 设置 effort（low / med / high / max） |
| `--permission-mode` | 权限模式（plan / default / ...） |
| `--dangerously-skip-permissions` | 跳过所有权限确认 |
| `--chrome` | Chrome 集成 |

---

## MCP 服务器

### 添加服务器

| 参数 | 传输方式 |
|------|---------|
| `--transport http` | 远程 HTTP（推荐） |
| `--transport stdio` | 本地进程 |
| `--transport sse` | 远程 SSE |

### 作用域

| 作用域 | 配置文件 | 说明 |
|--------|---------|------|
| Local | `.claude.json` | 单项目 |
| Project | `.mcp.json` | 共享（提交到 VCS） |
| User | `~/.claude.json` | 全局 |

### 管理命令

| 命令 | 功能 |
|------|------|
| `/mcp` | 交互式管理界面 |
| `claude mcp list` | 列出所有服务器 |
| `claude mcp serve` | 将 Claude Code 自身作为 MCP 服务器 |

> **Elicitation**：MCP 服务器可在任务中途请求用户输入。

---

## 记忆与文件系统

### CLAUDE.md 位置

| 位置 | 作用范围 |
|------|---------|
| `./CLAUDE.md` | 项目级（团队共享） |
| `~/.claude/CLAUDE.md` | 个人级（所有项目） |
| `/etc/claude-code/` | 托管级（组织范围） |

### 规则与导入

| 路径 / 语法 | 说明 |
|------------|------|
| `.claude/rules/*.md` | 项目规则文件 |
| `~/.claude/rules/*.md` | 用户规则文件 |
| `paths:` frontmatter | 路径专用规则（仅匹配的路径生效） |
| `@path/to/file` | 在 CLAUDE.md 中导入文件内容 |

### 自动记忆

```
~/.claude/projects/<proj>/memory/
├── MEMORY.md          ← 记忆索引
└── topic_xxx.md       ← 按主题存储的记忆文件
```

记忆文件自动加载到上下文，`/compact` 后仍保留。

---

## 工作流与技巧

### Plan 模式

| 操作 | 说明 |
|------|------|
| `Shift+Tab` | 循环切换：普通 → 自动接受 → Plan |
| `--permission-mode plan` | 以 plan 模式启动 |

### 思考与 Effort

| 操作 | 说明 |
|------|------|
| `Alt+T` | 开关思考模式 |
| `"ultrathink"` | 本轮使用最高 effort |
| `Ctrl+O` | 查看思考过程（详细输出） |
| `/effort` | 设置等级：低 · 中 · 高 · 最高 |

### Git Worktrees

| 操作 | 说明 |
|------|------|
| `--worktree name` | 为功能创建独立分支工作区 |
| `isolation: worktree` | Agent 在独立 worktree 中运行 |
| `sparsePaths` | 仅 checkout 所需目录（减少磁盘占用） |
| `/batch` | 自动创建多个 worktrees 并行修改 |

### 语音模式

| 操作 | 说明 |
|------|------|
| `/voice` | 启用按住说话 |
| `Space`（长按） | 按住录音，松开发送 |
| 20 种语言 | 英 / 西 / 法 / 德 / 中 / 日 / 韩 ... |

### 上下文管理

| 操作 | 说明 |
|------|------|
| `/context` | 查看使用量 + 优化建议 |
| `/compact [focus]` | 带焦点压缩 |
| Auto-compact | 约 95% 容量时自动触发 |
| 1M context | Opus 4.8（Max/Team/Enterprise 可用） |
| CLAUDE.md | 压缩后仍保留 |

### 会话高阶技巧

| 操作 | 说明 |
|------|------|
| `claude -c` | 继续最近一次对话 |
| `claude -r "name"` | 按名称恢复 |
| `/btw question` | 侧边问题，不占主上下文 |

### SDK / 无头模式

| 操作 | 说明 |
|------|------|
| `claude -p "query"` | 非交互运行 |
| `--output-format json` | 结构化输出 |
| `--max-budget-usd 5` | 成本上限 |
| `cat file \| claude -p` | 管道输入 |

### 调度与远程

| 操作 | 说明 |
|------|------|
| `/loop 5m msg` | 周期任务 |
| `/rc` | 远程控制 |
| `--remote` | claude.ai 上的网页会话 |

---

## Skills 与 Agents

### 内置 Skills

| Skill | 功能 |
|-------|------|
| `/simplify` | 代码审查（3 个并行 agents） |
| `/batch` | 大规模并行修改（5-30 个 worktrees） |
| `/debug [desc]` | 根据调试日志排障 |
| `/loop [interval]` | 周期性计划任务 |
| `/claude-api` | 加载 API + SDK 参考文档 |

### 自定义 Skill 位置

| 位置 | 作用范围 |
|------|---------|
| `.claude/skills/<name>/` | 项目 skills |
| `~/.claude/skills/<name>/` | 个人 skills |

### Skill Frontmatter 字段

| 字段 | 说明 |
|------|------|
| `description` | 自动触发说明 |
| `allowed-tools` | 跳过权限提示的工具列表 |
| `model` | 为该 skill 覆盖模型 |
| `effort` | 覆盖 effort 等级 |
| `context: fork` | 在 subagent 中运行 |
| `$ARGUMENTS` | 用户输入占位符 |
| `${CLAUDE_SKILL_DIR}` | Skill 自身目录路径 |
| `` !`cmd` `` | 动态上下文注入（执行命令并嵌入结果） |

### 内置 Agents

| Agent | 说明 |
|-------|------|
| **Explore** | 快速只读搜索（使用 Haiku） |
| **Plan** | 为 plan 模式做调研 |
| **General** | 完整工具集，复杂任务 |
| **Bash** | 独立上下文终端 |

### Agent Frontmatter 字段

| 字段 | 说明 |
|------|------|
| `permissionMode` | default / acceptEdits / plan / dontAsk / bypass |
| `isolation: worktree` | 在 git worktree 中运行 |
| `memory: user\|project` | 持久记忆 |
| `background: true` | 后台任务 |
| `maxTurns` | 限制 agentic 轮数 |
| `SendMessage` | 恢复已停止的 agents |

---

## 配置与环境变量

### 配置文件

| 文件 | 说明 |
|------|------|
| `~/.claude/settings.json` | 用户设置 |
| `.claude/settings.json` | 项目共享设置 |
| `.claude/settings.local.json` | 仅本地设置 |
| `~/.claude.json` | OAuth、MCP、状态 |
| `.mcp.json` | 项目 MCP 服务器 |

### 关键设置项

| 设置 | 说明 |
|------|------|
| `modelOverrides` | 将模型选择器映射到自定义模型 ID |
| `autoMemoryDirectory` | 自定义记忆目录 |
| `worktree.sparsePaths` | Sparse checkout 目录 |

### 关键环境变量

| 变量 | 说明 |
|------|------|
| `ANTHROPIC_AUTH_TOKEN` | API 密钥 |
| `ANTHROPIC_MODEL` | 默认模型 |
| `ANTHROPIC_BASE_URL` | API 端点（QCode.cc: `https://api.qcode.cc/api`） |
| `CLAUDE_CODE_EFFORT_LEVEL` | 默认 effort（low / med / high） |
| `MAX_THINKING_TOKENS` | 思考 token 上限（0 = 关闭） |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 输出 token 上限（默认 32K） |
| `ANTHROPIC_CUSTOM_MODEL_OPTION` | 自定义 `/model` 下拉条目 |
| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 插件种子目录（多个用 `:` 分隔） |
| `CLAUDECODE` | 检测是否在 Claude Code shell 中（值为 `1`） |
| `IS_DEMO` | 演示模式（隐藏邮箱/组织） |
| `CLAUDE_CODE_DISABLE_CRON` | 禁用定时任务 |

---

## 权限模式

| 模式 | 说明 | 启动参数 |
|------|------|---------|
| `default` | 每次操作询问确认 | 默认 |
| `acceptEdits` | 自动接受文件编辑 | `--permission-mode acceptEdits` |
| `plan` | 只读模式，不执行任何修改 | `--permission-mode plan` |
| `dontAsk` | 除明确允许外全部拒绝 | `--permission-mode dontAsk` |
| `bypassPermissions` | 跳过全部权限检查 | `--permission-mode bypassPermissions` |

> CLI 参数 `--dangerously-skip-permissions` 等同于 `bypassPermissions`，仅在隔离环境使用。

---

## QCode.cc 快速配置

```bash
# 一行搞定
export ANTHROPIC_BASE_URL=https://api.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_你的密钥
```

> 同一个 `cr_` 密钥同时适用于 Claude Code 和 [Codex](/docs/getting-started/codex-quick-start)，共享套餐配额。

---

## 相关文档

- [Claude Code 完整教程](/docs/getting-started/claude-code-tutorial) — 从零到精通
- [CLAUDE.md 配置指南](/docs/usage/claude-md) — 项目配置详解
- [Hooks 系统](/docs/advanced/hooks) — 自动化钩子
- [自动化与 CI/CD](/docs/advanced/headless) — 无头模式实战
- [Codex 完整教程](/docs/ide/codex) — Codex CLI 使用指南
- [Codex vs Claude Code](/docs/getting-started/codex-vs-claude-code) — 两大工具对比
- [套餐定价](https://qcode.cc/pricing) — QCode.cc 套餐方案