Claude Code 速查表

Claude Code 日常使用速查手册，涵盖核心命令、快捷键、权限模式、上下文管理、模型选择等内容。

核心命令

命令	功能
`/help`	上下文帮助
`/clear`	重置对话
`/compact`	释放上下文
`/status`	会话状态 + 上下文用量
`/context`	详细 token 分解
`/plan`	进入计划模式（不做修改）
`/execute`	退出计划模式（应用修改）
`/model`	切换模型（sonnet/opus/opusplan）
`/insights`	使用分析 + 优化报告
`/simplify`	检测过度工程 + 自动修复
`/batch`	通过并行 worktree agent 进行大规模重构
`/teleport`	从 Web 传送会话
`/tasks`	监控后台任务
`/remote-control`	启动远程控制会话（Pro/Max）
`/fast`	切换快速模式（2.5 倍速度，6 倍成本）
`/debug`	系统化故障排查
`/exit`	退出（或 Ctrl+D）

快捷键

快捷键	功能
`Shift+Tab`	循环切换权限模式
`Esc` x 2	回退（撤销）
`Ctrl+C`	中断
`Ctrl+R`	搜索命令历史
`Ctrl+L`	清屏（保留上下文）
`Tab`	自动补全
`Shift+Enter`	换行
`Ctrl+B`	后台任务
`Alt+T`	切换思考模式
`Ctrl+D`	退出

文件引用

@path/to/file.ts    → 引用文件
@agent-name         → 调用 Agent
!shell-command      → 运行 Shell 命令

IDE	快捷键
VS Code	`Alt+K`
JetBrains	`Cmd+Option+K`

隐藏功能（官方已支持）

功能	版本	说明
Tasks API	v2.1.16	持久化任务列表，支持依赖关系
后台 Agent	v2.0.60	子 Agent 在后台工作
Agent 团队	v2.1.32	多 Agent 协调（TeamCreate/SendMessage）
自动记忆	v2.1.32	自动跨会话上下文捕获
会话分叉	v2.1.19	回退 + 创建平行时间线
LSP 工具	v2.0.74	代码智能（跳转定义、引用）
远程控制	v2.1.51	从手机/浏览器控制本地会话（Pro/Max）

权限模式

使用 Shift+Tab 循环切换：

模式	编辑	执行
默认	询问	询问
acceptEdits	自动	询问
计划模式	禁止	禁止
dontAsk	仅限允许规则	仅限允许规则
bypassPermissions	自动	自动（仅 CI/CD）

              Shift+Tab              Shift+Tab
┌──────────┐ ──────────→ ┌───────────────┐ ──────────→ ┌───────────┐
│   默认   │             │   自动接受     │             │  计划模式  │
│ edit=ask │             │ edit=auto      │             │ edit=no   │
│ exec=ask │             │ exec=ask       │             │ exec=no   │
└──────────┘ ←────────── └───────────────┘ ←────────── └───────────┘
              Shift+Tab              Shift+Tab

记忆与配置

层级	位置	范围	Git
项目级	`.claude/`	团队共享	已提交
个人级	`~/.claude/`	个人（所有项目）	不提交

优先级：项目级覆盖个人级。

文件	位置	用途
`CLAUDE.md`	项目根目录	团队记忆（指令）
`settings.json`	`.claude/`	团队配置（Hook）
`settings.local.json`	`.claude/`	个人配置覆盖
`CLAUDE.md`	`~/.claude/`	个人记忆

.claude/ 目录结构

.claude/
├── CLAUDE.md           # 本地记忆（gitignored）
├── settings.json       # Hook 配置（已提交）
├── settings.local.json # 权限配置（不提交）
├── agents/             # 自定义 Agent
├── commands/           # 自定义斜杠命令
├── hooks/              # 事件脚本
├── rules/              # 自动加载的规则
└── skills/             # 知识模块

上下文管理

上下文阈值

上下文 %	状态	操作
0-50%	绿色	自由工作
50-70%	黄色	谨慎选择
70-90%	橙色	立即 `/compact`
90%+	红色	必须 `/clear`

按症状操作

现象	操作
回复变短	`/compact`
频繁遗忘	`/clear`
上下文 >70%	`/compact`
任务完成	`/clear`

上下文恢复命令

命令	用途
`/compact`	总结并释放上下文
`/clear`	重新开始
`/rewind`	撤销最近的变更
`claude -c`	恢复上次会话
`claude -r <id>`	恢复指定会话

状态栏

Model: Sonnet | Ctx: 89.5k | Cost: $2.11 | Ctx(u): 56.0%

增强状态栏（ccstatusline）： 添加到 ~/.claude/settings.json：

{ "statusLine": { "type": "command", "command": "npx -y ccstatusline@latest", "padding": 0 } }

内部机制速览

概念	要点
主循环	简单的 `while(tool_call)` —— 无 DAG、无分类器
工具	8 个核心工具：Bash、Read、Edit、Write、Grep、Glob、Task、TodoWrite
上下文	~200K tokens，75-92% 时自动压缩
子 Agent	隔离上下文，最大深度=1
理念	「少搭架子，多信模型」—— 信任 Claude 的推理能力

典型工作流

启动会话：claude
检查上下文：/status
复杂任务进入计划模式：Shift+Tab x 2
描述任务：清晰、具体的提示词（做什么、在哪里、怎么做、如何验证）
审查变更：务必阅读 diff
接受/拒绝：y/n
验证：运行测试
任务完成后提交
上下文 >70% 时执行 /compact

计划模式与思考

功能	激活方式	用途
计划模式	`Shift+Tab` x 2 或 `/plan`	只探索不修改
OpusPlan	`/model opusplan`	Opus 负责规划，Sonnet 负责执行

控制方式	操作	持久性
Alt+T	开关思考模式	当前会话
/config	全局启用/禁用	永久
`/model` 滑块	左右切换：`low\|medium\|high`	当前会话
`CLAUDE_CODE_EFFORT_LEVEL`	环境变量：`low\|medium\|high`	Shell 会话

快速模型选择

任务	模型	力度
重命名、模板代码、测试生成	Haiku	low
功能开发、调试、重构	Sonnet	medium-high
架构设计、安全审计	Opus	high-max

动态模型切换

模式：Sonnet 起步（速度） -> 切换 Opus（复杂度） -> 回到 Sonnet

# 会话开始（默认 Sonnet）
claude

# 遇到复杂功能
/model opus                    # 切换到深度推理

# 功能完成，回归日常
/model sonnet                  # 速度 + 成本优化

最佳实践：

在任务边界切换，而非任务中间
Opus 用于：架构决策、复杂调试、安全关键代码
Sonnet 用于：日常编辑、重构、测试编写
Haiku 用于：简单修复、拼写错误、验证检查

成本对照

模型	输入	输出	使用场景
Opus	$15/MTok	$75/MTok	复杂推理（10-20% 的任务）
Sonnet	$3/MTok	$15/MTok	大部分开发（70-80% 的任务）
Haiku	$0.25/MTok	$1.25/MTok	简单验证（5-10% 的任务）

MCP 服务器

服务器	用途
Serena	代码索引 + 会话记忆 + 符号搜索
grepai	语义搜索 + 调用图分析
Context7	类库文档
Sequential	结构化推理
Playwright	浏览器自动化
Postgres	数据库查询
doobidoo	语义记忆 + 多客户端 + 知识图谱

Serena 记忆: write_memory() / read_memory() / list_memories()

Serena 索引：

# 初始索引
uvx --from git+https://github.com/oraios/serena serena project index

# 强制重建
serena project index --force-full

# 增量更新（更快）
serena project index --incremental --parallel 4

查看状态：/mcp

创建自定义组件

文件：.claude/agents/my-agent.md

---
name: my-agent
description: Use when [trigger]
model: sonnet
tools: Read, Write, Edit, Bash
---
# 指令内容

文件：.claude/commands/my-command.md

# 命令名称
要执行的指令...
$ARGUMENTS[0] $ARGUMENTS[1] - 用户参数

文件：.claude/hooks/my-hook.sh

#!/bin/bash
INPUT=$(cat)
# 处理 JSON 输入
exit 0  # 0=继续, 2=阻止

CLI 参数速查

参数	用途
`-p "query"`	非交互模式（CI/CD）
`-c` / `--continue`	继续上次会话
`-r` / `--resume <id>`	恢复指定会话
`--teleport`	从 Web 传送会话
`remote-control`	子命令：启动远程控制会话
`--model sonnet`	切换模型
`--add-dir ../lib`	允许访问 CWD 之外的目录
`--permission-mode plan`	计划模式
`--tools "Tool1,Tool2"`	启用特定工具
`--max-budget-usd 5.00`	最大 API 支出限制（print 模式）
`--system-prompt "..."`	追加自定义系统提示词
`--worktree` / `-w`	在隔离的 git worktree 中运行
`--dangerously-skip-permissions`	自动接受（谨慎使用）
`--allowedTools "Edit,Read"`	工具白名单
`--debug`	调试输出

调试命令

claude --version     # 版本号
claude update        # 检查/安装更新
claude doctor        # 诊断工具
claude --debug       # 详细模式
claude --mcp-debug   # 调试 MCP
/mcp                 # MCP 状态（在 Claude 内部）

CI/CD 模式（无头模式）

# 非交互执行
claude -p "analyze this file" src/api.ts

# JSON 输出
claude -p "review" --output-format json

# 经济模型
claude -p "lint" --model haiku

# 自动接受
claude -p "fix typos" --dangerously-skip-permissions

远程控制 — 移动端访问（v2.1.51+）

# 从终端启动（新会话）
claude remote-control

# 或在活动会话中：
/rc        # （或 /remote-control）

从手机/平板/浏览器连接：

扫描 二维码（启动后按空格键显示）
或在浏览器 / Claude 移动应用中打开 会话 URL
或使用 /mobile 获取 App Store / Play Store 下载链接

已知限制	说明
同时仅 1 个会话	仅支持一个远程会话
斜杠命令失效	`/new`、`/compact` 在远程端变为纯文本，需在本地终端执行
终端必须保持开启	关闭本地终端会结束会话
网络超时	~10 分钟断连后会话过期

高级用法：tmux 多会话（绕过单会话限制）：

tmux new-session -s dev
# 每个窗格 = 独立的 claude 会话
# 在需要远程控制的窗格中运行 /rc

任务管理（v2.1.16+）

两套系统可用：

系统	适用场景	持久化
Tasks API（v2.1.16+）	多会话项目、依赖关系	磁盘（`~/.claude/tasks/`）
TodoWrite（旧版）	简单单会话	仅会话内

Tasks API 命令

# 启用跨会话持久化
export CLAUDE_CODE_TASK_LIST_ID="project-name"
claude

# 在 Claude 中：创建任务层次
> "Create tasks for auth system with dependencies"

# 稍后恢复（新会话）
export CLAUDE_CODE_TASK_LIST_ID="project-name"
claude
> "TaskList to see current state"

反模式

不要这样做	应该这样做
模糊的提示词	用 @引用指定文件 + 行号
不审查就接受	阅读每一个 diff
忽略警告	70% 时用 `/compact`
跳过权限检查	生产环境绝不跳过
只写否定约束	提供替代方案

快速提示词公式

做什么：[具体交付物]
在哪里：[文件路径]
怎么做：[约束条件、方法]
验证：[成功标准]

示例：

为登录表单添加输入验证。
在哪里：src/components/LoginForm.tsx
怎么做：使用 Zod schema，显示行内错误
验证：空邮箱显示错误，格式无效显示错误

快速决策树

简单任务      → 直接问 Claude
复杂任务      → 先用 Tasks API 规划
高风险变更    → 先用计划模式
重复任务      → 创建 Agent 或 Command
上下文满了    → /compact 或 /clear
需要文档      → 用 Context7 MCP
深度分析      → 用 Opus（思考模式默认开启）

常见问题速修

问题	解决方案
”Command not found”	检查 PATH，重装 npm 全局包
上下文过高（>70%）	立即 `/compact`
响应变慢	`/compact` 或 `/clear`
MCP 不工作	`claude mcp list`，检查配置
权限被拒绝	检查 `settings.local.json`
Hook 阻塞	检查 Hook 退出码，审查逻辑

健康检查：

which claude && claude doctor && claude mcp list

黄金法则

务必审查 diff 再接受变更
及时 /compact 上下文超过 70% 之前
描述要具体（做什么、在哪里、怎么做、如何验证）
复杂/高风险任务先用计划模式
为每个项目创建 CLAUDE.md
每完成一个任务就提交
了解发送了什么 —— 提示词、文件、MCP 结果都会发送到 Anthropic（隐私设置）

社区工具

工具	用途	安装
ccusage	成本追踪与报告	`bunx ccusage daily`
RTK	Token 压缩（60-90%）	`brew install rtk-ai/tap/rtk` 或 `cargo install rtk`
claude-code-viewer	会话历史 UI	`npx @kimuson/claude-code-viewer`
Entire CLI	会话检查点 + 治理	entire.io

成本优化

模型	适用场景	成本
Haiku	简单修复、审查	$
Sonnet	大部分开发	$$
Opus	架构设计、复杂 bug	$$$
OpusPlan	规划（Opus）+ 执行（Sonnet）	$$