附录 A：Cheatsheet 速查表

本附录是 Claude Code 日常使用中最常用的命令、快捷键、配置项和技巧的浓缩速查表。适合放在手边随时翻阅，也可作为团队新成员的快速上手参考。

VSCode 快捷键

快捷键	操作
`Cmd+Shift+L` (Mac) / `Ctrl+Shift+L` (Win)	打开 Claude Code 面板
`Cmd+Shift+I` (Mac) / `Ctrl+Shift+I` (Win)	打开 Claude Code 内联输入框
`Cmd+K` (Mac) / `Ctrl+K` (Win)	上下文菜单（选中代码后）
`Tab`	接受内联建议
`Escape`	拒绝内联建议
`Cmd+Shift+Enter` (Mac) / `Ctrl+Shift+Enter` (Win)	发送当前输入
`Ctrl+C`	中断 Claude 当前操作
`↑` / `↓`	浏览对话历史
`Cmd+Enter` (Mac) / `Ctrl+Enter` (Win)	强制换行（不发送）

Slash Commands 速查

会话管理

命令	说明
`/clear`	清空对话，开始新话题
`/compact`	压缩对话历史，释放上下文空间
`/context`	查看当前上下文使用量（token 占比）
`/cost`	查看当前会话的 API 费用
`/doctor`	运行诊断，检查配置和环境问题
`/status`	查看当前会话状态（模式、模型、上下文）
`/config`	打开配置界面
`/help`	显示帮助信息

模式与模型

命令	说明
`/plan`	进入计划模式（只读，生成执行计划）
`/model`	切换当前会话使用的模型
`/thinking`	切换深度思考模式开关
`/permissions`	查看和调整当前权限模式

Git

命令	说明
`/commit`	自动生成 commit message 并创建提交
`/review`	对当前变更进行代码审查
`/clean_gone`	清理远程已删除的本地分支
`/pr`	创建 Pull Request
`/diff`	查看当前工作区变更摘要

任务与工作流

命令	说明
`/init`	分析项目并生成 CLAUDE.md
`/todo`	查看当前任务进度列表
`/tasks`	管理后台任务（查看、取消）
`/loop <interval> <cmd>`	按指定间隔循环执行命令
`/add-dir <path>`	将目录添加到工作区
`/memory`	打开持久化记忆编辑器

IDE 集成

命令	说明
`/terminal-setup`	配置终端集成
`/ide`	查看 IDE 集成状态
`/login`	登录 Anthropic 账号
`/logout`	登出当前账号

MCP 与扩展

命令	说明
`/mcp`	查看和管理 MCP 服务器
`/mcp-servers`	列出已配置的 MCP 服务器
`/plugin`	管理插件（安装、启用、禁用）
`/hooks`	查看和管理钩子配置

常用 CLI 命令

bash

# 启动 Claude Code（交互模式）
claude

# 直接提问（非交互模式，输出后退出）
claude -p "解释这个项目的结构"

# 从文件读取 prompt
claude -p "$(cat prompt.txt)"

# 指定模型启动
claude --model claude-opus-4-7

# 继续上次对话
claude --continue

# 恢复指定会话
claude --resume <session-id>

# 列出历史会话
claude --resume

# 查看版本
claude --version

# 更新到最新版
npm update -g @anthropic-ai/claude-code

# 打印系统信息（调试用）
claude --doctor

# 指定工作目录
claude --cwd /path/to/project

# 无头模式（非交互，适合 CI/CD）
claude -p "运行测试" --output-format json

cc-switch 模型切换

bash

# 查看当前模型
cc-switch current

# 列出所有可用模型
cc-switch list

# 切换到指定模型
cc-switch set sonnet        # Claude Sonnet
cc-switch set opus          # Claude Opus
cc-switch set haiku         # Claude Haiku
cc-switch set deepseek      # DeepSeek V4 Pro
cc-switch set deepseek-flash  # DeepSeek V4 Flash

# 查看当前模型详情
cc-switch status

# 模型别名管理
cc-switch alias add fast deepseek-flash
cc-switch alias list
cc-switch set fast          # 使用别名切换

# 查看帮助
cc-switch --help

配置速查

settings.json 关键字段

json

{
  "model": "claude-sonnet-4-6",
  "maxThinkingTokens": 32000,
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(npm:*)",
      "Bash(pnpm:*)",
      "Bash(make:*)",
      "Read(*)",
      "Glob(*)",
      "Grep(*)",
      "WebSearch(*)",
      "WebFetch(*)"
    ],
    "deny": [
      "Bash(rm:-rf:*)",
      "Bash(sudo:*)",
      "Bash(curl:*)",
      "Bash(> /dev:*)"
    ],
    "ask": []
  },
  "enableAllProjectMcpServers": true,
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{ "type": "command", "command": "echo 'About to run a bash command'" }]
      }
    ]
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-...",
    "DEEPSEEK_API_KEY": "sk-..."
  }
}

配置层级优先级

层级	路径	用途
1 (最高)	`.claude/settings.local.json`	个人本地覆盖，不提交 Git
2	`.claude/settings.json`	项目级配置，团队共享
3	`~/.claude/settings.json`	用户级全局配置
4 (最低)	内置默认值	系统默认配置

权限模式速查

模式	行为	适用场景
Ask	所有操作需确认	高风险操作、学习阶段
Auto	自动批准已授权操作	日常开发（推荐）
Edit	允许文件编辑，Bash 需确认	代码重构
Plan	只读模式，仅分析不修改	方案评估、代码审查
Bypass	跳过所有确认（⚠️ 慎用）	CI/CD 自动化

CLAUDE.md 最小模板

markdown

# CLAUDE.md

## Commands
- `pnpm dev` — 启动开发服务器
- `pnpm test` — 运行测试
- `pnpm build` — 生产构建
- `pnpm lint` — 代码检查

## Architecture
- `src/` — 源代码
- `tests/` — 测试文件
- `docs/` — 项目文档
- `.claude/` — Claude Code 配置

## Tech Stack
- Runtime: Node.js 22
- Framework: React 19 / Vite
- Language: TypeScript (strict mode)
- Package Manager: pnpm

## Rules
- 使用 TypeScript 严格模式
- Commit 遵循 Conventional Commits (`feat:`, `fix:`, `chore:`)
- 组件使用函数式写法
- 样式使用 CSS Modules
- 不要引入超过 50KB 的第三方库
- API 调用统一通过 `src/api/` 层

## Important Notes
- 生产构建前必须通过 `pnpm test` 全量测试
- 数据库 migration 不能自动回滚——先备份
- 不要直接修改 `dist/` 下的文件

Tips & Tricks

效率提升

选中代码再提问：在 VSCode 中选中代码后提问，Claude 自动获得你关注的上下文
用 @file 引用文件：在 prompt 中使用 @src/utils/helper.ts 引用特定文件
用 @folder 引用目录：@src/components/ 让 Claude 了解整个目录结构
写清楚期望的输出格式："用表格列出"、"给代码示例"、"画一个 Mermaid 架构图"
一次做一件事：不要在一个 prompt 里塞太多独立任务，拆分能显著提高质量
先 Plan 再执行：复杂任务先用 /plan 让 Claude 制定方案，审查通过后再执行
善用 /todo 跟踪进度：多步骤任务让 Claude 维护 TodoWrite，避免遗漏

上下文管理

长对话中，如果 Claude 开始"忘记"之前的内容，用 /compact 压缩
换了话题就用 /clear，避免旧上下文干扰新任务
CLAUDE.md 控制在 300 行以内——Claude 每次会话都会全量读取
用注释标记高优先级约定：// CLAUDE: always use path aliases
定期用 /context 检查上下文使用率，超过 70% 就该压缩
多文件重构任务分多个会话进行，每个会话专注一个模块

安全

永远审查 Claude 提议的 Bash 命令后再允许执行
不要将 API Key、密码等敏感信息粘贴到对话中
settings.local.json 应加入 .gitignore，避免泄露本地密钥
对 rm -rf、sudo、curl | bash 类命令设置 deny 规则
定期审查 .claude/settings.json 中的 allow 列表，避免权限过度开放
在 CI/CD 中使用专用 API Key，设置额度上限

模型选择速查

任务类型	推荐模型	原因
简单问答、代码补全	Haiku / DeepSeek Flash	速度快、成本低
日常开发、代码生成	Sonnet / DeepSeek Pro	质量与速度平衡
复杂重构、架构设计	Opus / DeepSeek Pro	最强的推理能力
代码审查、安全分析	Opus	最高准确率
批量任务、CI 自动化	Haiku / DeepSeek Flash	低成本、高吞吐

常见错误与解决

问题	可能原因	解决
Claude 改错文件了	上下文过大或文件名模糊	指定具体文件路径，限制操作范围
Claude 重复同样的修改	陷入循环	`Ctrl+C` 中断，用更具体的指令重新描述
Claude 输出被截断	达到输出 token 上限	说 "continue" 让它继续输出
权限弹窗太多	allow list 配置不足	在 settings.json 中为常用命令添加 allow 规则
Claude 忘记之前的约定	上下文窗口被挤占	用 `/compact` 压缩，或在 CLAUDE.md 中固化约定
响应速度很慢	模型负载高或网络问题	切换到更轻量的模型，检查网络
"Context limit exceeded"	会话上下文超出模型限制	立即 `/compact`，或 `/clear` 重开
MCP 服务器连接失败	配置错误或服务未启动	用 `/doctor` 诊断，检查 MCP 服务器进程状态
插件安装后不生效	需重启 Claude Code	重启 VSCode 或重新加载窗口
cc-switch 切换后无变化	缓存未刷新	重启 Claude Code 会话

调试 Claude

如果 Claude 的行为不达预期，按以下步骤排查：

检查 CLAUDE.md —— 是否有误导性或过时的信息？用 /init 重新生成
检查上下文 —— 用 /context 查看是否接近上下文上限
清空重来 —— 用 /clear 清空对话，给一个更清晰的 prompt
检查配置 —— settings.json 是否有错误的权限规则？
换模型 —— 复杂任务切换到更强的模型（Opus）
运行诊断 —— 用 /doctor 检查系统环境
重启 —— 重启 VSCode 或 Claude Code 会话

环境变量速查

变量	说明	示例
`ANTHROPIC_API_KEY`	Anthropic API 密钥	`sk-ant-api03-...`
`ANTHROPIC_BASE_URL`	自定义 API 端点	`https://api.anthropic.com`
`ANTHROPIC_MODEL`	默认模型	`claude-sonnet-4-6`
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	最大输出 token 数	`32000`
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	禁用非必要网络请求	`1`
`NO_COLOR`	禁用 CLI 颜色输出	`1`
`HTTP_PROXY` / `HTTPS_PROXY`	代理设置	`http://proxy:8080`

MCP 常用服务器速查

服务器	用途	安装命令
Context7	实时文档查询	`npx @context7/mcp-server`
GitHub	GitHub API 操作	官方内置
Filesystem	文件系统访问	官方内置
Postgres	数据库查询	`npx @anthropic/mcp-server-postgres`
Brave Search	Web 搜索	`npx @anthropic/mcp-server-brave-search`
Puppeteer	浏览器自动化	`npx @anthropic/mcp-server-puppeteer`

附录 A：Cheatsheet 速查表 ​

VSCode 快捷键 ​

Slash Commands 速查 ​

会话管理 ​

模式与模型 ​

Git ​

任务与工作流 ​

IDE 集成 ​

MCP 与扩展 ​

常用 CLI 命令 ​

cc-switch 模型切换 ​

配置速查 ​

settings.json 关键字段 ​

配置层级优先级 ​

权限模式速查 ​

CLAUDE.md 最小模板 ​

Tips & Tricks ​

效率提升 ​

上下文管理 ​

安全 ​

模型选择速查 ​

常见错误与解决 ​

调试 Claude ​

环境变量速查 ​

MCP 常用服务器速查 ​

参考资源 ​

附录 A：Cheatsheet 速查表

VSCode 快捷键

Slash Commands 速查

会话管理

模式与模型

Git

任务与工作流

IDE 集成

MCP 与扩展

常用 CLI 命令

cc-switch 模型切换

配置速查

settings.json 关键字段

配置层级优先级

权限模式速查

CLAUDE.md 最小模板

Tips & Tricks

效率提升

上下文管理

安全

模型选择速查

常见错误与解决

调试 Claude

环境变量速查

MCP 常用服务器速查

参考资源