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

一站式汇总所有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 --version

进行身份验证：

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可从终端重置自动模式状态；传入--yes可跳过确认提示。[⁷]

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中）。

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
  },
  "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.214 起，单路径段 dir/** allow 规则仅匹配 <cwd>/dir，不再匹配目录树任意位置的 dir/；如需匹配任意深度，请使用 Edit(**/src/**)。deny/ask 规则仍保留任意深度匹配，hook 的 if: 条件同样采用此 cwd 作用域。

新增键（v2.1.118+）：

如需查看完整的设置架构，请参阅完整指南中的配置深入解析。

7. CLAUDE.md 快速参考

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

存放位置：

建议包含的内容：

# 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

内容应便于快速浏览。密集的长篇文字会在每次会话中浪费上下文令牌。请使用项目符号、表格和简短的代码块，并避免冗长段落。Claude 会在每次会话开始时读取 CLAUDE.md，因此每个字都会占用上下文。

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

8. 权限模式

自2026年8月14日起，Auto Mode（v2.1.85+）已成为 Pro、Max 和 Team 方案中新会话的默认权限模式（自行设置的 defaultMode 会一直保留，直到您接受一次性切换提示；disableAutoMode 可在整个组织范围内禁用该模式）。它是 --dangerously-skip-permissions 的推荐替代方案。只读操作和文件编辑会自动获批。系统首先处理自定义 allow/deny 规则，其他所有操作均交由安全分类器判定。默认自动阻止的操作包括：curl | bash、强制推送至 main、生产环境部署、批量删除云端资源、IAM 变更，以及向外部发送敏感数据。¹

熔断机制：连续阻止 3 次或单次会话累计阻止 20 次后，系统将暂停 Auto Mode，并恢复手动提示。

# 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

PowerShell 自动批准（v2.1.119+）：在权限模式下，PowerShell 工具命令的自动批准方式与 Bash 命令相同。PowerShell(Get-*:*) 等 allow 规则可使只读操作绕过提示。对于大量使用 PowerShell 的工作流，建议使用 v2.1.149+；该版本修复了内置 cd 的权限绕过、前缀/通配符 allow 规则匹配，以及目录变量未及时更新的问题。

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 | Auto Mode 拒绝操作时（v2.1.88+） | 否 | | CwdChanged | 工作目录发生变更时（v2.1.83+） | 否 | | FileChanged | 受监视的文件被外部修改时（v2.1.83+） | 否 | | TaskCreated | 创建新任务时（v2.1.84+） | 否 | | TeammateIdle | agent 团队成员进入空闲状态时 | 是 | | TaskCompleted | 任务被标记为完成时 | 是 |

如需了解完整的 hook 协议（输入/输出 JSON、匹配器、退出代码），请参阅完整指南中的Hooks 深入解析。

10. Hook 配置

Hook 位于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 语法：

退出代码：

异步 hooks 在后台运行，不会造成阻塞：请在 hook 对象中添加"async": true。²

Hook 输出/输入字段：

• PostToolUse/PostToolUseFailure hook 输入中的duration_ms（v2.1.119+）——工具执行时间，不包括权限提示和 PreToolUse hooks。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）——替换任意工具的输出（v2.1.118 最初仅为 MCP 引入此功能；v2.1.121 将其扩展至所有工具）。
• hookSpecificOutput.sessionTitle（v2.1.96+）——通过UserPromptSubmit hook 设置会话标题。
• 命令 hooks 中的args: string[]（v2.1.139+）——无需 shell 引号即可传递结构化 argv。
• PostToolUse hooks 中的continueOnBlock（v2.1.139+）——将阻止原因反馈给 Claude，并继续当前轮次。
• agent hook 输入中的subagent_type（v2.1.140+）——标识正在运行的 agent 类型。
• hook JSON 输出中的terminalSequence（v2.1.141+）——发送用于通知、窗口标题和提示音的终端控制序列。

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
    }
  }
}

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

SDK mcp_authenticate redirectUri（v2.1.121+）：使用自定义 URI 方案完成 OAuth 时的必填项——适用于桌面应用和 claude.ai 连接器流程。

11.5. Plugin CLI 命令

12. Subagent 类型

Claude 会自动将任务委派给 subagents。也可以显式请求：

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

自定义 subagents 以带有 YAML frontmatter 的 Markdown 文件形式定义在.claude/agents/（项目）或~/.claude/agents/（个人）中。最多可并行运行10个 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 添加了置顶后台会话，使其在空闲时仍保持活动，并可在原位重启以进行更新。Agent View 适合用于监控，但不能作为工作已通过质量门槛的证明。⁶

自定义 agent frontmatter 字段：

自定义 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

模型配置

云服务提供商

行为控制

工具配置

网络和代理

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

14. 费用参考

每 100 万个 token 的价格（截至 2026 年 9 月）。⁵

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

Claude Code中的默认模型（按方案划分）：高级方案——Max、Team Premium、Enterprise（按量付费，以及自CLI v2.1.251 起提供的订阅席位）、AnthropicAPI，以及 Bedrock / Google Cloud 的 Agent Platform / AWS 上的Claude Platform——默认使用 Opus 5；Pro 和 Team Standard 默认使用 Sonnet 5（Microsoft Foundry：Sonnet 4.5）。v2.1.197 曾于 2026 年 6 月 30 日将 Sonnet 5 设为所有方案的默认模型，但这已成为历史；opus 别名现在指向 Opus 5（v2.1.219+）。管理员可以设置组织范围的默认模型，该模型会在 /model 中显示为“组织默认值”（v2.1.196+）；在 Bedrock/Vertex/Foundry 上，可通过 ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL 固定使用特定模型。

Sonnet 5、Opus 5、Opus 4.8、Fable 5 和 Fable 5.1 仅使用自适应推理（不设固定思考预算）。所有这些模型的 effort 均默认为 high；面对最困难的编码和智能体任务，可使用 /effort xhigh。Opus 5 相比 Opus 4.8 的破坏性变更：对于省略 thinking 字段的请求，默认启用思考；当 effort 为 xhigh 或 max 时，使用 thinking: {type: "disabled"} 会返回 400 错误。

截至 v2.1.219，快速模式（/fast）仅适用于 Opus 5 和 Opus 4.8——价格为每 MTok $10 / $50（基础价格的 2 倍），输出 token 速度最高可达 2.5 倍。Opus 4.7 已被移除：使用 claude-opus-4-7 + speed: "fast" 现在会报错，不再回退至标准速度。此功能处于研究预览阶段，仅面向ClaudeAPI（不支持 Bedrock/Vertex/Foundry）；切换速度会使提示词缓存失效。

在会话期间切换模型：

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (default on Pro/Team Standard)
/model haiku      # Switch to Haiku 4.5
/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年7月17日。