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`

权限模式

使用 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%

典型工作流

启动会话：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	数据库查询

查看状态：/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>`	恢复指定会话
`--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`	自动接受（谨慎使用）
`--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

反模式

不要这样做	应该这样做
模糊的提示词	用 @引用指定文件 + 行号
不审查就接受	阅读每一个 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`
claude-code-viewer	会话历史 UI	`npx @kimuson/claude-code-viewer`
Entire CLI	会话检查点 + 治理	entire.io

成本优化

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