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

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

1. 安装

三种安装方式，按推荐程度排序。

# 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 --version

如果您使用的是 2.1.288 至 2.1.290 版本，请更新到 2.1.291 或更高版本：该版本修复了 2.1.288 中可能在退出时丢失会话最后几条消息的回归问题，以及 2.1.290 中云端会话可能丢弃权限提示回答的回归问题。

进行身份验证：

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

2. CLI 标志

v2.1.212 新增子命令：claude auto-mode reset 可从终端重置您的 auto-mode 状态；传入 --yes 可跳过确认提示。⁷

会话与数据子命令：claude attach <name> 和 claude logs <name> 可用后台会话名称的一部分代替其 id（v2.1.290+）。claude purge [path] 会删除项目的本地 Claude Code 状态（--dry-run 可预览）；在 v2.1.288 之前它名为 claude project purge，旧名称仍可使用，但会显示提示。自 v2.1.300 起，claude remote-control 不再接受 --sandbox 或 --no-sandbox（二者此前并无实际效果；请在设置中配置 sandbox.enabled）。自 v2.1.309 起，claude ultrareview 需要工作区信任：在终端中会询问确认，否则直接拒绝；脚本可传入 --trust-workspace（无需参数值；PR 编号或基准分支须放在它之前），或设置 CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1。¹⁴ claude self-hosted-runner --hold-idle-file <path> --max-hold-min <n> 会在您的主机持续修改该文件期间保持空闲会话存活，但无论如何都会在 n 分钟后释放（默认 1440；v2.1.311+）。

3. 斜杠命令

自定义命令： 创建 .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. 键盘快捷键

通用控制

快捷前缀

多行输入

快捷键绑定可通过 /keybindings 自定义（存储在 ~/.claude/keybindings.json 中）。自 v2.1.284 起，effortSlider:decreaseEffort、increaseEffort 和 toggleUltracode 操作可重新绑定 /effort 滑块的方向键和 Tab 键。

5. 配置文件

优先级层次（从高到低）

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

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
  },
  "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.214 起，单段 dir/** allow 规则仅匹配 <cwd>/dir，不再匹配目录树中任意位置的 dir/；若需任意深度匹配，请写成 Edit(**/src/**)。deny/ask 规则保留任意深度匹配，hook 的 if: 条件也采用同样的 cwd 作用域。自 v2.1.299 起，MCP allow 规则仅作用于其指定的服务器：mcp__a 不再涵盖名为 a__b 或 a_ 的服务器；请使用完整的规范化名称写成 mcp__<server>__*。

新增键（v2.1.118+）：

完整的设置架构请参阅完整指南中的配置深度解析。

7. CLAUDE.md 速查

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

存放位置：

AGENTS.md（v2.1.277+）：在没有 CLAUDE.md 的项目中，Claude Code 会改为读取 AGENTS.md——可在 /config 的“Project instructions”下更改此行为（Bedrock/Vertex/Foundry 尚不支持）。

应包含的内容：

# 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.md 会在 Claude 读取该目录下的文件时加载 - 团队共享的规则放在 .claude/rules/*.md 中，便于模块化管理

8. 权限模式

自动模式（v2.1.85+）是所有套餐和所有提供商上交互式终端与 VS Code 会话的内置起始模式：v2.1.283 将其扩展到第三方提供商和关闭遥测的会话，v2.1.284 又扩展到所有套餐和提供商；在此之前，它仅在 Pro、Max 和 Team 套餐上默认启用（自2026年8月14日起）。从 v2.1.285 到 v2.1.301，在第三方提供商上或关闭遥测时，未配置权限模式的 claude -p 和 Python Agent SDK 会话也会以自动模式启动；v2.1.302 撤销了这一行为：未设置权限模式的 claude -p 或 Agent SDK 会话，在第三方提供商上、关闭遥测时以及全新安装时，都以 Manual 模式启动——与能够获取功能标志的环境中一贯的行为一致；--permission-mode auto 则保持自动模式。¹³ permissions.defaultMode 会覆盖内置默认值（"default" 固定为 Manual），disableAutoMode 可在整个组织范围内禁用它。它是 --dangerously-skip-permissions 的推荐替代方案。只读操作和文件编辑会自动批准；自 v2.1.281 起，在分类器审查于服务器端运行的场合，只读和沙箱化的 shell 命令也要等待审查结果，被标记时会被拦截。自定义的允许/拒绝规则优先生效。其余一切都交由安全分类器处理。默认自动拦截的操作包括：curl | bash、强制推送到 main、生产环境部署、批量删除云资源、IAM 变更、向外部发送敏感数据。¹

熔断机制：单次会话中连续 3 次拦截或累计 20 次拦截，会暂停自动模式并回到手动询问。

自动模式在读取工作目录之外的文件前弹出的询问中，提供 Yes, but ask again next time（是，但下次再问）选项（v2.1.284+）：允许本次读取，之后的读取仍会询问。

无人值守模式下的危险 rm（v2.1.281）：在自动模式和 --dangerously-skip-permissions 下，危险 rm 的询问会等待 2 分钟，然后拒绝该命令并给出改写提示，让会话得以继续。目标仅为命令替换输出的递归 rm，例如 rm -rf "$(pwd)"，现在即使有 Bash 允许规则也会询问。

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

权限变更（v2.1.288-290）：pyright 不再被视为只读命令，会先询问；更多形式的 ps 命令亦是如此（v2.1.290）。项目的设置文件不能再开启 Claude in Chrome；请使用 --chrome、/chrome 或您的用户设置（v2.1.290）。客户端的自动模式分类器会忽略指向 Sonnet 5.5 或 Opus 5.5 的 ANTHROPIC_DEFAULT_SONNET_MODEL 固定设置，改用 Claude Sonnet 5（v2.1.288）。

PowerShell 自动批准（v2.1.119+）：PowerShell 工具命令在权限模式下的自动批准方式与 Bash 命令相同。类似 PowerShell(Get-*:*) 的允许规则可免去只读操作的询问。大量使用 PowerShell 的工作流请使用 v2.1.149+；该版本修复了内置 cd 的权限绕过问题、前缀/通配符允许规则的匹配问题，以及目录变量跟踪过期的问题。

9. Hook 事件

| InstructionsLoaded | CLAUDE.md 加载完成时 | 否 | | ConfigChange | 会话中配置文件发生变更时 | 是 | | DirectoryAdded | /add-dir 或 SDK 的 register_repo_root 在会话中添加工作目录时（v2.1.219+） | 否 | | WorktreeCreate | 正在创建 worktree 时 | 是 | | WorktreeRemove | 正在移除 worktree 时 | 否 | | PreCompact | 上下文压缩前 | 否 | | PostCompact | 上下文压缩后 | 否 | | Elicitation | MCP 请求结构化输入时 | 是 | | ElicitationResult | 用户响应 MCP 对话框时 | 是 | | StopFailure | 因 API 错误而结束回合时 | 否 | | PermissionRequest | 显示权限对话框时 | 是 | | PermissionDenied | 自动模式拒绝某项操作时（v2.1.88+） | 否 | | CwdChanged | 工作目录变更时（v2.1.83+） | 否 | | FileChanged | 受监视的文件被外部修改时（v2.1.83+） | 否 | | TaskCreated | 创建新任务时（v2.1.84+） | 否 | | TeammateIdle | Agent 团队成员空闲时 | 是 | | TaskCompleted | 任务被标记为完成时 | 是 |

完整的 hook 协议（输入/输出 JSON、匹配器、退出码）请参阅完整指南中的 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"
          }
        ]
      }
    ]
  }
}

匹配器语法：

退出码：

异步 hook 在后台运行，不会阻塞：在 hook 对象中添加 "async": true 即可。² 自 v2.1.302 起，同一事件的提示 hook 和 agent hook 同时最多运行 12 个；其余的排队等待。¹³

Hook 输出/输入字段：

• PostToolUse / PostToolUseFailure hook 输入中的 duration_ms（v2.1.119+）——工具执行时间，不含权限询问和 PreToolUse hook 所用的时间。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）——替换任意工具的输出（v2.1.118 仅为 MCP 引入此功能；v2.1.121 扩展到所有工具）。
• hookSpecificOutput.sessionTitle（v2.1.96+）——从 UserPromptSubmit hook 中设置会话标题。
• 命令 hook 上的 args: string[]（v2.1.139+）——传递结构化的 argv，无需 shell 引用转义。
• Skill hook 上限（v2.1.304+）：来自同一来源（一个仓库、您自己的文件夹或一个 plugin）的 skills 每个会话最多可注册 1,024 个 hook 和 16,384 个匹配器字符；某个 skill 的 once hook 不再会移除另一个 skill 的相同 hook。
• PostToolUse hook 上的 continueOnBlock（v2.1.139+）——将拦截原因反馈给 Claude 并继续当前回合。
• Agent hook 输入中的 subagent_type（v2.1.140+）——识别正在运行的 agent 类型。
• hook JSON 输出中的 terminalSequence（v2.1.141+）——发出终端控制序列，用于通知、窗口标题和响铃。
• 命令 hook 和 HTTP hook 上的 onFailure: "block"（v2.1.295+）——无法启动、超时、以 0 或 2 以外的退出码退出、收到 HTTP 错误或输出无效 JSON 的 hook 会拦截该操作（效果与该事件上的退出码 2 相同；在 PermissionRequest 上则为拒绝）。默认为 "continue"；在 Stop、SubagentStop、TaskCompleted、TeammateIdle 和异步 hook 上会被忽略。

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

作用域控制：

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 个服务器。³ 有关传输类型、信息征询和工具搜索配置，请参阅完整指南中的 MCP 部分。

alwaysLoad（v2.1.121+）： 将受信任的服务器排除在 Tool Search 延迟加载机制之外。该服务器的所有工具都会在会话启动时加载，无需通过 ToolSearch 往返调用：

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

alwaysLoad: false（v2.1.287+）的作用相反：该服务器的所有工具都要等到工具搜索时才会加载。

自动重试（v2.1.121+）： MCP 服务器启动出错时，最多会重试 3 次，之后才会被标记为已断开连接。

URL 提示（v2.1.287+）： 使用 2025-11-25 协议的 MCP 服务器可以打开 URL 提示，例如用于登录。如果服务器在更新后无法连接，请在其 MCP 配置条目中添加 "bareElicitationCapability": true。

SDK mcp_authenticate redirectUri（v2.1.121+）： 使用自定义 URI 协议方案完成 OAuth 时必须提供此参数，适用于桌面应用和 claude.ai 连接器流程。

11.5. plugins CLI 命令

Mods（v2.1.287+）： mod 是一种 plugins，其 JavaScript 或 TypeScript 处理程序在 Claude Code 内部运行：它可以绘制窗格、添加命令，以及监视或修改工具调用。Mods 默认启用；--safe-mode 可在单次会话中停用它们，"disableAllHooks": true 则会在所有会话中停用它们，但这两种方式都不会停用内置 mods。⁸

LSP 服务器（v2.1.288+）： LSP 服务器条目支持以毫秒为单位的 requestTimeout（默认值为 60000）。因此，如果服务器始终不响应，请求会在 60 秒后失败，而不会一直挂起。

12. subagents 类型

Claude 会自动将任务委派给 subagents。您也可以明确要求使用它们：

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

自定义 subagents 以带有 YAML 前置元数据的 markdown 文件定义，存放于 .claude/agents/（项目级）或 ~/.claude/agents/（个人级）。默认最多可并发运行 20 个 subagents；通过 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 可调整此上限。⁴ 自 v2.1.292 起，Agent 工具支持 effort 参数，因此可以要求 Claude 以指定的推理投入级别运行 subagents。智能体名称的长度上限为 256 个字符（skills 或 plugins 文件中超长的 name 会被忽略）。自 v2.1.302 起，除终端外，claude -p、Agent SDK、桌面应用和 VS Code 也默认启用 fork subagents（subagent_type: "fork"）（设置 CLAUDE_CODE_FORK_SUBAGENT=0 可将其关闭；claude mcp serve 始终不提供此功能）。桌面应用和 VS Code 始终在后台运行主对话的 subagents。¹³

在当前版本中，claude agents 会打开 Agent View：这是一个处于研究预览阶段的操作界面，用于查看正在运行、受阻和已完成的 Claude Code 会话。claude agents --cwd <path> 可将视图范围限定为一个目录（v2.1.141+）；v2.1.142 新增后台会话的调度标志；v2.1.143 将这些标志统一应用于仪表板和后台会话：--add-dir、--settings、--mcp-config、--plugin-dir、--permission-mode、--model、--effort 和 --dangerously-skip-permissions。v2.1.144 新增后台会话的 /resume 支持，并用 bg 标记这些会话；v2.1.145 新增 claude agents --json、等待输入标签页的计数，并修复 Agent View 回复窗格的问题；v2.1.147 新增置顶后台会话，在空闲时保持运行，并在更新时原位重启；v2.1.287 新增 n:<text> 过滤器，用于匹配会话名称和任务；v2.1.288 新增 Ctrl+F，用于按名称查找会话，以及 Alt+Up / Alt+Down，用于在分组之间跳转。这两类快捷键均可在 keybindings.json 中重新绑定（Ctrl+F 对应 agents:find）。Agent View 应用于监控，不能作为工作已通过质量门禁的证明。⁶

自定义智能体前置元数据字段：

自定义智能体示例（.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

网络与代理

14. 成本参考

每100万token的定价（截至2026年10月）。⁵¹⁰

一次典型的会话消耗50K-200K输入token和10K-50K输出token。Haiku 5.5会话：按100K token以内提示的费率计算，约$0.01-$0.05。Opus 5.5会话：$0.40-$1.80。

Claude Code中的默认模型（按计划）：自v2.1.280（2026年9月22日）起所有计划均默认为Opus – Pro和Team Standard从Sonnet切换到Opus，与Max、Team Premium和Enterprise保持一致 – 默认Opus模型为Opus 5.5（claude-opus-5-5），opus别名现在指向该模型。v2.1.251的分割方案（高级计划用Opus 5，Pro/Team Standard用Sonnet 5）和v2.1.197全面默认Sonnet 5的方案均已成为历史。管理员可以设置组织级默认模型，在/model中显示为“Org default”（v2.1.196+）。AWS上的Claude Platform、Amazon Bedrock和Google Cloud的Agent Platform也默认为Opus 5.5；Microsoft Foundry是唯一的例外（默认Sonnet 4.5，也是opus解析为Opus 4.6的唯一平台）– 可通过ANTHROPIC_DEFAULT_OPUS_MODEL/ANTHROPIC_DEFAULT_SONNET_MODEL固定特定模型。

Opus 5.5、Sonnet 5.5、Haiku 5.5、Sonnet 5、Opus 5、Opus 4.8、Fable 5和Fable 5.1仅使用自适应推理（没有固定的思考预算），最困难的编码/智能体工作可使用/effort xhigh。这些模型的effort均默认为high，但Opus 5.5和Sonnet 5.5除外，二者默认为medium，Haiku 5.5在Claude API上亦是如此 – 并且自v2.1.280起，您在/effort改为按模型设置之前保存的effort级别不再沿用到Opus 5.5等新发布的模型上，这些模型会以自身的默认值起步，直到您另行选择。Opus 5.5、Sonnet 5.5和Fable系列模型无法关闭思考（MAX_THINKING_TOKENS=0在这些模型上无效）。Opus 5相对Opus 4.8的破坏性变更：省略thinking字段的请求默认开启思考，而thinking: {type: "disabled"}搭配effort xhigh或max会返回400。

快速模式（/fast）适用于Opus 5.5和Opus 5，以及2026年11月30日之前的Opus 4.8（10月30日起弃用；移除后，在Opus 4.8上发起快速模式请求将报错，而不会以标准速度运行），自v2.1.280起默认为Opus 5.5 – Opus 5.5为每MTok $8/$40，Opus 5和4.8为$10/$50（均为基础价格的2倍），输出速度最高可达每秒2.5倍token。Opus 4.7已移除：claude-opus-4-7搭配speed: "fast"现在会报错，而不是回退到标准速度。研究预览版，仅限Claude API和订阅计划（不支持Bedrock/Vertex/Foundry或AWS上的Claude Platform）；切换速度会使提示缓存失效。自v2.1.271起，快速模式也可在Claude Code Remote会话（云端和自托管运行器）中使用：在您的组织允许的范围内，主机的快速模式设置或在会话中输入的/fast均会生效。

在会话中切换模型：

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5.5 on the Anthropic API (v2.1.284+)
/model haiku      # Switch to Haiku 5.5 on the Anthropic API (v2.1.293+)
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/effort xhigh     # Recommended for the hardest coding/agentic work

决策规则：简单探索交给Haiku。成本敏感的日常编码交给Sonnet。复杂推理、架构设计、智能体循环和安全分析交给Opus。复杂重构使用opusplan（Opus规划，Sonnet执行）。

15. 关键文件位置

16. 更新日志

17. 参考资料

本速查表是完整 Claude Code CLI 指南的快速查阅配套资料。安装与设置的分步讲解，请参阅 Claude Code 快速入门。针对 iOS 和 macOS 项目，请参阅 iOS Agent 开发指南、XcodeBuildMCP 集成模式以及 Apple 生态系统系列。最后更新于 2026年10月6日。