Claude Code速查表:命令、配置与快捷键
# 面向v2.1.140更新的Claude Code速查表,便于快速查阅CLI flags、斜杠命令、键盘快捷键、钩子、插件、Agent View、/goal和环境变量。
一站式汇总所有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 |
以text、json或stream-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 级别:low、medium、high |
/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 test、npm run test:unit等。文件模式使用 glob 语法:Edit(src/**)。
新键(v2.1.118+):
| Key | 行为 |
|---|---|
autoMode.allow $defaults |
Sentinel,可在内置列表之外添加自定义规则(也适用于soft_deny、environment)——v2.1.118+ |
prUrlTemplate |
页脚 PR 徽章 URL 模板——v2.1.119+ |
wslInheritsWindowsSettings |
WSL 继承 Windows 端托管设置——v2.1.118+ |
skillOverrides |
隐藏或折叠 skills:off、user-invocable-only或name-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": true。2
Hook 输出/输入字段:
duration_ms位于PostToolUse/PostToolUseFailurehook 输入中(v2.1.119+)——工具执行时间,不包括权限提示和 PreToolUse hooks。hookSpecificOutput.updatedToolOutput(v2.1.121+)——替换任意工具的工具输出(v2.1.118 仅为 MCP 引入此功能;v2.1.121 扩展到所有工具)。hookSpecificOutput.sessionTitle(v2.1.96+)——通过UserPromptSubmithook 设置会话标题。args: string[]位于 command hooks 中(v2.1.139+)——无需 shell quoting,即可传递结构化 argv。continueOnBlock位于PostToolUsehooks 中(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 |
opus、sonnet、haiku或inherit(默认) |
permissionMode |
default、acceptEdits、plan、bypassPermissions等 |
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 args、PostToolUse continueOnBlock,以及 agent hook 输入中的 subagent_type。注明 v2.1.140 修复了 ConfigChange、disableAllHooks 和 allowManagedHooksOnly 行为。本地验证: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 支持、skillOverrides、CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE、CLAUDE_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 + 适用于所有工具的 updatedToolOutput;prUrlTemplate、wslInheritsWindowsSettings、autoMode.allow $defaults;环境变量 ANTHROPIC_BEDROCK_SERVICE_TIER、ENABLE_TOOL_SEARCH、CLAUDE_CODE_HIDE_CWD、DISABLE_UPDATES、CLAUDE_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日。