agent:~/.claude$ cat claude-code-cheatsheet.md

Claude Code速查表:命令、配置与快捷键

# 面向v2.1.140更新的Claude Code速查表,便于快速查阅CLI flags、斜杠命令、键盘快捷键、钩子、插件、Agent View、/goal和环境变量。

words: 1035 read_time: 9m updated: 2026-05-13 05:36
$ less claude-code-cheatsheet.md

一站式汇总所有CLI命令行标志、斜杠命令、键盘快捷键、配置键、hook事件和环境变量。如需深入讲解,请参阅完整的Claude Code指南。首次配置请参阅快速入门

1. 安装

3种安装方法,按推荐顺序排列。

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

安装特定版本:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

验证安装:

claude doctor

身份验证:

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLI 标志

Flag 说明 示例
-p 打印模式——执行单次查询后退出 claude -p "list TODOs"
-c 继续最近的会话 claude -c
-r, --resume 恢复命名或编号会话 claude -r "auth-refactor"
-n, --name 启动时设置会话显示名称 claude -n "feature-x"
--model 覆盖此会话使用的模型 claude --model opus
--max-turns 限制自主轮次 claude -p "fix lint" --max-turns 10
--output-format textjsonstream-json输出 claude -p "count files" --output-format json
--allowedTools 限制可用工具 claude -p "fix" --allowedTools "Edit,Bash(npm:*)"
--permission-mode 设置权限模式 claude --permission-mode auto
--enable-auto-mode 启动时启用 Auto Mode claude --enable-auto-mode
--dangerously-skip-permissions YOLO模式——跳过所有提示 claude --dangerously-skip-permissions
--from-pr 启动与 PR 关联的会话(v2.1.27+);接受GitHub、GHE、GitLab MR、Bitbucket PR URLs(v2.1.119+) claude --from-pr 123
--fork-session 从已恢复的会话 fork claude -r base --fork-session
-w 在隔离的 git worktree 中启动 claude -w
--bare 脚本模式——跳过 hooks、LSP、plugins claude -p "count files" --bare
--plugin-url <url> 为当前会话获取 plugin .zip归档(v2.1.129+) claude --plugin-url https://example.com/plugin.zip
--plugin-dir <path> 为当前会话加载 plugin 目录或.zip归档(v2.1.128+支持.zip claude --plugin-dir ./my-plugin.zip
--channels 将审批提示转发到 Telegram/Discord claude --channels
--debug 启用调试日志 claude --debug
--init 使用 CLAUDE.md 初始化项目 claude --init

3. Slash 命令

Command 作用
/init 使用 CLAUDE.md 初始化项目
/compact 压缩对话历史。添加关注点:/compact focus on tests
/context 查看上下文窗口用量,并获得可执行建议
/usage Token 用量、成本、套餐用量;合并对话框(v2.1.118+:/cost/stats是输入快捷方式,会打开/usage标签页)
/cost 输入快捷方式 → 打开/usage成本标签页(v2.1.118+)
/model 更改模型。/model opus/model sonnet
/fast 切换快速输出模式
/effort 设置 effort 级别:lowmediumhigh
/status 查看会话状态、模型和设置
/permissions 以交互方式管理权限设置
/config 打开完整设置界面
/mcp 配置MCP服务器。/mcp enable/mcp disable
/hooks 查看 hook 配置
/memory 查看和管理 auto-memory 文件
/copy 复制代码块。/copy N复制第 N 个最近响应
/resume 恢复命名会话。/resume 1/resume name
/rename 命名当前会话。/rename feature-auth
/branch 为并行探索创建对话分支
/clear 清除对话历史
/plan 进入 plan 模式。/plan refactor the auth module
/powerup 带动画演示的交互式功能课程(v2.1.90+)
/voice 切换按住说话语音模式
/loop 周期性任务。/loop 5m /foo每5分钟运行一次
/rewind 返回检查点(或按两次Esc
/export 导出对话转录
/add-dir 添加工作目录以扩展文件访问范围
/agents 管理 subagents
/goal 设置完成条件;Claude会持续执行,直到达到目标(v2.1.139+)
/skills 列出已安装的 skills;支持输入筛选的搜索框(v2.1.121+)
/bashes 列出后台 bash 任务
/tasks 列出后台 agents
/theme 管理命名主题(v2.1.118+);plugins 附带themes/目录
/color 设置提示栏颜色。使用/color default重置
/simplify 审查代码以进行简化
/batch 批量操作
/security-review 审查代码漏洞
/claude-api 使用ClaudeAPI/AnthropicSDK构建应用
/doctor 检查安装健康状态
/bug 向Anthropic报告 bug
/release-notes 带 changelogs 的交互式版本选择器(v2.1.92+)
/buddy 终端陪伴宠物——18个物种、5个稀有度层级,根据账号 ID 确定
/login / /logout 在会话中进行身份验证或退出登录

自定义命令:创建.claude/commands/my-command.md(项目)或~/.claude/commands/my-command.md(个人),并使用/my-command调用。命令支持YAML frontmatter,用于描述、允许的工具、模型覆盖,以及通过$ARGUMENTS或位置参数$1$2进行参数插值。

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

用法:/fix-issue 123


4. 键盘快捷键

通用控制

Shortcut 操作
Ctrl+C 取消当前操作
Ctrl+D 退出会话(EOF)
Ctrl+L 清屏(保留历史)
Ctrl+O 切换详细输出
Ctrl+R 搜索命令历史
Ctrl+V 从剪贴板粘贴图片
Ctrl+B 将当前操作置于后台
Ctrl+X Ctrl+K 停止所有 agents(v2.1.83中由 Ctrl+F 更改而来)
Ctrl+S 暂存提示词草稿
Ctrl+G 打开外部编辑器
Esc Esc 回退上次更改
Tab 接受提示词建议
! Tab Bash 历史自动补全
Shift+Tab 循环切换权限模式
Alt+P / Option+P 输入时切换模型
Alt+T 切换 thinking 模式
Ctrl+T 切换语法高亮
Shift+Down 循环切换 agent team 成员
Up/Down 浏览命令历史
v Vim 可视模式——字符选择(v2.1.118+;仅限 vim 模式)
V Vim 可视行模式(v2.1.118+;仅限 vim 模式)
? 显示快捷键

快速前缀

Prefix 操作 示例
# 添加到持久内存 # Always use TypeScript
/ Slash 命令 /review
! 直接执行 bash ! git status
@ 引用文件 @src/index.ts
& 将任务发送到云端 & Build the API

多行输入

方法 按键
转义换行 \然后按Enter
macOS Option+Enter
iTerm2/WezTerm/Ghostty/Kitty Shift+Enter
其他终端 Shift+Enter(先运行/terminal-setup
控制字符 Ctrl+J

Keybindings 可通过/keybindings自定义(存储在~/.claude/keybindings.json)。


5. 配置文件

优先级层级(从高到低)

级别 位置 范围
企业(锁定) /Library/Application Support/ClaudeCode/managed-settings.json(macOS) 所有用户,不可覆盖
CLI flags 命令行参数 当前会话
本地项目 .claude/settings.local.json 个人、当前项目(gitignored)
共享项目 .claude/settings.json 团队,提交到 git
用户全局 ~/.claude/settings.json 您的所有项目
运行时状态 ~/.claude.json OAuth tokens、MCP配置

首个匹配项生效。企业设置无法绕过。


6. Settings.json 参考

关键设置及其类型和示例。可放入上述层级中的任意设置文件。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

权限规则语法:Tool(pattern:*)提供前缀匹配。Bash(npm run test:*)允许npm run testnpm run test:unit等。文件模式使用 glob 语法:Edit(src/**)

新键(v2.1.118+):

Key 行为
autoMode.allow $defaults Sentinel,可在内置列表之外添加自定义规则(也适用于soft_denyenvironment)——v2.1.118+
prUrlTemplate 页脚 PR 徽章 URL 模板——v2.1.119+
wslInheritsWindowsSettings WSL 继承 Windows 端托管设置——v2.1.118+
skillOverrides 隐藏或折叠 skills:offuser-invocable-onlyname-only——v2.1.129+

完整设置 schema 请参阅完整指南中的Configuration Deep Dive


7. CLAUDE.md 快速参考

CLAUDE.md 是项目的指令文件。Claude 会在每个会话开始时读取它。

所在位置:

位置 范围
CLAUDE.md (project root) 此项目中的所有用户、所有会话
.claude/CLAUDE.md 同上,备选位置
~/.claude/CLAUDE.md 个人配置,所有项目

应包含的内容:

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

保持便于快速浏览。密集的长段文字会在每个会话中浪费上下文 token。使用项目符号、表格和短代码块。避免长段落——Claude 会在每个会话开始时读取 CLAUDE.md,因此每个字都会占用上下文。

实用技巧: - 在 REPL 中使用 # 前缀,可将内容添加到自动记忆中,无需编辑 CLAUDE.md:# Always use TypeScript strict mode - 当 Claude 读取某个目录中的文件时,也会加载该子目录中的 CLAUDE.md - 团队共享规则放在 .claude/rules/*.md 中,便于模块化组织


8. 权限模式

模式 行为 使用场景
default 每个工具首次使用时提示 常规开发
acceptEdits 自动批准文件编辑,对 bash 进行提示 可信项目
auto 分类器(Sonnet 4.6)逐项审核操作安全性 带保护措施的自主执行
plan 只读——不允许编辑或执行 仅用于分析和规划
bypassPermissions 跳过所有提示 CI/CD 自动化

Auto Mode(v2.1.85+)是 --dangerously-skip-permissions 的推荐替代方案。只读操作和文件编辑会自动获批。自定义允许/拒绝规则会先行生效。其他所有操作都会交给安全分类器处理。默认自动阻止:curl | bash、强制推送到 main、生产部署、大规模云资源删除、IAM 变更、向外部发送敏感数据。1

熔断器:会话中连续 3 次阻止或总计 20 次阻止后,会暂停并回退到手动提示。

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

PowerShell 自动批准(v2.1.119+): PowerShell 工具命令在权限模式下会像 Bash 命令一样自动批准。类似 PowerShell(Get-*:*) 的允许规则会绕过只读操作的提示。


9. Hook 事件

事件 触发时机 能否阻止?
PreToolUse 工具执行之前
PostToolUse 工具完成之后
PostToolUseFailure 工具失败之后
UserPromptSubmit 用户发送 prompt
Stop Claude 完成响应
SubagentStart subagent 生成时
SubagentStop subagent 完成时
SessionStart 会话开始
SessionEnd 会话关闭
Notification 警报触发

| InstructionsLoaded | CLAUDE.md 已加载 | 否 | | ConfigChange | 会话中配置文件发生变化 | 是 | | WorktreeCreate | 正在创建 worktree | 是 | | WorktreeRemove | 正在移除 worktree | 否 | | PreCompact | 上下文压缩之前 | 否 | | PostCompact | 上下文压缩之后 | 否 | | Elicitation | MCP 请求结构化输入 | 是 | | ElicitationResult | 用户响应 MCP 对话框 | 是 | | StopFailure | 由于 API 错误导致回合结束 | 否 | | PermissionRequest | 显示权限对话框 | 是 | | PermissionDenied | Auto mode 拒绝某项操作(v2.1.88+) | 否 | | CwdChanged | 工作目录变化(v2.1.83+) | 否 | | FileChanged | 被监视文件由外部修改(v2.1.83+) | 否 | | TaskCreated | 创建新任务(v2.1.84+) | 否 | | TeammateIdle | Agent 团队成员空闲 | 是 | | TaskCompleted | 任务标记为完成 | 是 |

关于完整的 hook 协议(输入/输出 JSON、matchers、退出码),请参阅完整指南中的 Hooks 深入解析


10. Hook 配置

Hooks 位于 settings.json 或专用的 hooks.json 中。最小示例:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

Matcher 语法:

模式 匹配
* 所有工具
Bash 仅 Bash
Edit\|Write Edit 或 Write
mcp__github MCP 服务器工具
"" (empty) 不带工具的事件(例如 UserPromptSubmit

退出码:

代码 含义
0 成功——操作继续
2 阻止——操作停止,stderr 会传给 Claude
1, 3+ 非阻塞警告

异步 hooks 会在后台运行且不阻塞:在 hook 对象中添加 "async": true2

Hook 输出/输入字段:

  • duration_ms 位于 PostToolUse / PostToolUseFailure hook 输入中(v2.1.119+)——工具执行时间,不包括权限提示和 PreToolUse hooks。
  • hookSpecificOutput.updatedToolOutput(v2.1.121+)——替换任意工具的工具输出(v2.1.118 仅为 MCP 引入此功能;v2.1.121 扩展到所有工具)。
  • hookSpecificOutput.sessionTitle(v2.1.96+)——通过 UserPromptSubmit hook 设置会话标题。
  • args: string[] 位于 command hooks 中(v2.1.139+)——无需 shell quoting,即可传递结构化 argv。
  • continueOnBlock 位于 PostToolUse hooks 中(v2.1.139+)——将阻止原因反馈给 Claude 并继续当前回合。
  • subagent_type 位于 agent hook 输入中(v2.1.140+)——识别正在运行的 agent 类型。

11. MCP 快速设置

用一条命令添加 MCP 服务器:

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

Scope 控制:

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

项目 .mcp.json 示例:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP 目前每月下载量已达 1 亿次,并有 3,000+ 个已索引服务器。3 关于传输类型、elicitation 和工具搜索配置,请参阅完整指南中的 MCP 部分

alwaysLoad(v2.1.121+): 让可信服务器绕过 Tool Search 延迟加载。其所有工具会在会话开始时加载,无需 ToolSearch 往返:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

自动重试(v2.1.121+): 启动期间报错的 MCP 服务器会最多重试 3 次,然后才标记为已断开连接。

SDK mcp_authenticate redirectUri(v2.1.121+): 在自定义 URI scheme 上完成 OAuth 时必需——适用于桌面应用和 claude.ai connector 流程。


11.5. Plugin CLI 命令

命令 行为
claude --plugin-url <url> 为当前会话获取 plugin .zip 归档(v2.1.129+)
claude --plugin-dir <path> 为当前会话加载 plugin 目录或 .zip 归档(.zip 支持 v2.1.128+)
claude plugin prune 移除其父项已不存在的自动安装 plugins(v2.1.121+)
claude plugin uninstall <name> --prune 卸载并级联移除孤立的自动安装依赖(v2.1.121+)
claude plugin tag 通过版本验证创建发布 git tags(v2.1.118+)

12. Subagent 类型

类型 默认模型 模式 用途
Explore Haiku(快速) 只读 搜索代码库、查找文件、理解结构
General-purpose 继承主会话 完整读写 复杂研究与修改任务
Plan 继承主会话 只读 执行前规划实现方案
Custom 可配置 可配置 特定领域工作(安全审查、测试等)

Claude会自动委派给subagents。您也可以显式请求它们:

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

自定义subagents定义在.claude/agents/(项目)或~/.claude/agents/(个人)中,以带有YAML frontmatter的markdown文件形式存在。最多可并行运行10个subagents。4

在当前版本中,claude agents会打开Agent View:这是一个research-preview运维界面,用于查看正在运行、被阻塞和已完成的Claude Code会话。它适合用于监控,但不能作为工作已通过质量门槛的证明。6

自定义agent frontmatter字段:

字段 用途
name 唯一标识符(小写、连字符)
description 何时调用(包含“PROACTIVELY”以启用自动委派)
tools 逗号分隔的工具列表。支持Agent(Explore)以限制可spawn的类型
disallowedTools 从继承集合中拒绝使用的工具
model opussonnethaikuinherit(默认)
permissionMode defaultacceptEditsplanbypassPermissions
maxTurns 最大agentic轮数
background 设为true表示始终作为后台任务运行
isolation 使用worktree创建隔离的git worktree副本

自定义agent示例.claude/agents/security-reviewer.md):

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. 环境变量

身份验证与API

变量 用途
ANTHROPIC_API_KEY 直接API身份验证
ANTHROPIC_AUTH_TOKEN 自定义授权标头
ANTHROPIC_CUSTOM_HEADERS 额外请求标头

模型配置

变量 用途
ANTHROPIC_MODEL 覆盖默认模型
CLAUDE_CODE_SUBAGENT_MODEL subagents使用的模型
MAX_THINKING_TOKENS 启用扩展思考
CLAUDE_CODE_MAX_OUTPUT_TOKENS 限制输出长度

云服务商

变量 用途
CLAUDE_CODE_USE_BEDROCK=1 使用AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1 使用Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1 使用Microsoft Foundry
ANTHROPIC_BEDROCK_SERVICE_TIER=priority Bedrock服务层级——default/flex/priority(v2.1.122+);作为X-Amzn-Bedrock-Service-Tier发送
ENABLE_TOOL_SEARCH=true 选择启用Vertex AI上的Tool Search(v2.1.119+;默认关闭,以避免不受支持的beta标头)
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 选择启用网关/v1/models发现,用于/model选择器(v2.1.129+)

行为控制

变量 用途
DISABLE_AUTOUPDATER=1 防止自动更新
DISABLE_UPDATES=1 阻止包括手动claude update在内的所有更新路径(v2.1.118+,比DISABLE_AUTOUPDATER更严格)
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 Homebrew/WinGet安装会在后台运行包管理器升级,并提示重启(v2.1.129+)
DISABLE_TELEMETRY=1 退出使用情况遥测
DISABLE_COST_WARNINGS=1 隐藏成本警告
DISABLE_PROMPT_CACHING=1 全局禁用提示缓存
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 使用标准200K,而不是1M
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1 移除内置commit/PR说明
CLAUDE_CODE_HIDE_CWD=1 在启动logo中隐藏工作目录(v2.1.119+)
CLAUDE_CODE_FORK_SUBAGENT=1 在外部build上使用forked subagents(v2.1.117+;在非交互式-p模式中可用,v2.1.121+)
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 当自动检测遗漏时,强制同步终端输出(v2.1.129+)

工具配置

变量 用途
BASH_DEFAULT_TIMEOUT_MS Bash命令超时(默认30000)
BASH_MAX_TIMEOUT_MS Bash最大超时时间(默认600000)
MCP_TIMEOUT MCP服务器启动超时(默认5000)
MCP_TOOL_TIMEOUT MCP工具执行超时(默认30000)

网络与代理

变量 用途
HTTP_PROXY / HTTPS_PROXY 代理配置
NO_PROXY 对特定域名绕过代理
CLAUDE_CODE_CLIENT_CERT mTLS证书路径

完整列表请参阅完整指南中的环境变量


14. 成本参考

每100万tokens的定价(截至2026年4月)。5

模型 输入 输出 备注
Opus 4.7 $5.00 $25.00 当前旗舰模型。1M context采用标准定价——无长上下文溢价。
Opus 4.6(legacy) $5.00 $25.00 1M context现在同样采用标准定价
Sonnet 4.6 $3.00 $15.00 均衡模型。1M context采用标准定价——无长上下文溢价。
Haiku 4.5 $1.00 $5.00 探索、简单任务

典型会话会消耗50K-200K输入tokens和10K-50K输出tokens。Haiku会话:$0.10-$0.45。Opus会话:$0.50-$2.25。

按plan划分的默认模型(截至2026年4月16日的Claude Code):

  • Max、Team Premium → Opus 4.7
  • Pro、Team Standard、Enterprise、Anthropic API → Sonnet 4.6(Enterprise + API将于2026年4月23日切换到Opus 4.7)
  • Bedrock、Vertex、Foundry → Sonnet 4.5(通过ANTHROPIC_DEFAULT_OPUS_MODEL固定到更新版本)

Opus 4.7需要Claude Code v2.1.111或更高版本。它仅使用自适应推理(没有固定thinking budgets)。新的xhigh effort级别是Opus 4.7上编码/agentic工作负载的默认值。

在会话期间切换模型:

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only  recommended for coding/agentic

决策规则:简单探索交给Haiku。成本敏感的日常编码交给Sonnet。高难推理、架构、agentic loops和安全分析交给Opus。复杂重构使用opusplan(Opus负责规划,Sonnet负责执行)。


15. 关键文件位置

路径 用途
~/.claude/settings.json 用户全局设置
~/.claude/keybindings.json 自定义键盘快捷键
~/.claude/CLAUDE.md 个人说明(所有项目)
~/.claude/commands/ 个人slash commands
~/.claude/skills/ 个人skills
~/.claude/agents/ 个人subagent定义
~/.claude.json 运行时状态、OAuth tokens、MCP配置
.claude/settings.json 项目设置(通过git共享)
.claude/settings.local.json 项目设置(个人,git忽略)
.claude/CLAUDE.md 项目说明
.claude/commands/ 项目slash commands
.claude/agents/ 项目subagent定义
.claude/skills/ 项目skills
.claude/plans/ Plan模式输出文件
.claude/memory/ 自动memory文件
.mcp.json 项目MCP服务器配置
CLAUDE.md 项目说明(根目录替代项)

16. 变更日志

日期 变更
2026-05-13 同步了截至 Claude Code v2.1.140 的最新版本线证据。新增 /goal、Agent View 说明、command-hook argsPostToolUse continueOnBlock,以及 agent hook 输入中的 subagent_type。注明 v2.1.140 修复了 ConfigChangedisableAllHooksallowManagedHooksOnly 行为。本地验证:claude --version 返回 2.1.140 (Claude Code)6
2026-05-06 同步了截至 Claude Code v2.1.131 的最新版本线证据。无需更改命令、配置、快捷键、hook、plugin 或环境变量表,因为 v2.1.131 是针对 VS Code Windows 激活和 Mantle 端点身份验证的修复版本。6
2026-05-05 同步至 CC 指南 v2.36(CLI v2.1.126–v2.1.129)。新增:用于加载 plugin zip 的 --plugin-url--plugin-dir.zip 支持、skillOverridesCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYCLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATECLAUDE_CODE_FORCE_SYNC_OUTPUT,以及 v2.1.129 针对实验性 themes/monitors 的 plugin manifest 指南。覆盖至 v2.1.129。6
2026-04-29 同步至 CC 指南 v2.35(CLI v2.1.117–v2.1.123)。新增:alwaysLoad MCP 选项 + 启动时自动重试;claude plugin prune--prune 级联;claude plugin tag/skills 输入过滤;/theme 命名主题;/usage 合并对话框;vim 可视模式(v/V);PowerShell 自动批准;hook 输入中的 duration_ms + 适用于所有工具的 updatedToolOutputprUrlTemplatewslInheritsWindowsSettingsautoMode.allow $defaults;环境变量 ANTHROPIC_BEDROCK_SERVICE_TIERENABLE_TOOL_SEARCHCLAUDE_CODE_HIDE_CWDDISABLE_UPDATESCLAUDE_CODE_FORK_SUBAGENT--from-pr 接受 GitLab/Bitbucket/GHE PR URLs。覆盖至 v2.1.123。
2026-04-19 刷新:Sonnet 4.6 1M context 现在显示为标准 $3/$15(无长上下文溢价);将定价脚注切换为 platform.claude.com/docs/en/about-claude/pricing。覆盖至 v2.1.116。
2026-04-04 基于 CC 指南 v2.26 重新推导。新增 /powerup,更新 /release-notes,移除 /vim。更新 Ctrl+X Ctrl+K 快捷键。新增 4 个 hook 事件(CwdChanged、FileChanged、TaskCreated、PermissionDenied)。更新 /cost,加入按模型拆分的明细。覆盖至 v2.1.92。
2026-03-28 cheat sheet 首次发布,覆盖 Claude Code CLI 至 v2.1.85

17. 参考资料


这份 cheat sheet 是 Claude Code CLI 完整指南的快速查询配套资料。有关设置演练,请参阅 Claude Code quickstart。如果专门面向 iOS 和 macOS 项目,请参阅 iOS Agent Development 指南XcodeBuildMCP 集成模式,以及 Apple Ecosystem Series。最后更新于 2026年5月13日。

NORMAL claude-code-cheatsheet.md EOF