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. Slash命令

自定义命令：创建.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
  },
  "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 会在每次会话开始时读取它。

存放位置：

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

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

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

8. 权限模式

Auto Mode（v2.1.85+）自 2026年8月14日起，成为 Pro、Max 和 Team 计划新会话的默认权限模式（自行设置的 defaultMode 会继续生效，直到您接受一次性切换提示；disableAutoMode 可在整个组织范围内禁用该模式）。这是 --dangerously-skip-permissions 的推荐替代方案。只读操作和文件编辑会自动获批；从 v2.1.281 开始，分类器审核改为在服务器端运行，因此只读操作和沙箱 shell 命令也要等待审核，并会在被标记时遭到阻止。自定义 allow/deny 规则优先解析，其余操作均交由安全分类器处理。默认自动阻止的操作包括：curl | bash、向主分支强制推送、生产环境部署、大规模删除云端资源、IAM 更改，以及向外部发送敏感数据。¹

熔断机制：连续阻止 3 次，或单次会话中累计阻止 20 次后，将暂停自动模式并恢复手动提示。

无人值守模式下的危险 rm（v2.1.281）：在 auto 模式和 --dangerously-skip-permissions 下，危险 rm 的提示会等待 2 分钟，随后拒绝该命令并给出重写建议，使会话能够继续。若递归 rm 的目标完全来自命令替换输出（例如 rm -rf "$(pwd)"），即使存在 Bash allow 规则，现在也会发出提示。

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

有关完整的 Hook 协议（输入/输出 JSON、匹配器、退出代码），请参阅完整指南中的 Hook 深入解析。

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

匹配器语法：

退出代码：

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

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+）——无需 shell 引号即可传递结构化 argv。
• PostToolUse Hook 上的 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 scheme 中完成 OAuth 时的必填项——适用于桌面应用和 claude.ai connector 流程。

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 为后台会话添加调度 flags；v2.1.143 将这些 flags 一致应用于仪表板和后台会话：--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 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、Opus 5、Opus 4.8、Fable 5和Fable 5.1仅使用自适应推理（没有固定的思考预算）；对于最具挑战性的编码和智能体任务，可使用/effort xhigh。除默认使用medium的Opus 5.5外，所有这些模型的effort均默认为high——此外，自v2.1.280起，在/effort改为按模型分别设置之前保存的effort级别，不会沿用到Opus 5.5等新发布的模型。因此，在您另行选择之前，新模型会采用自身的默认值。Opus 5.5或Fable模型无法关闭思考功能（MAX_THINKING_TOKENS=0对它们无效）。Opus 5相较于Opus 4.8的重大变更：对于省略thinking字段的请求，默认启用思考；当effort为xhigh或max时，使用thinking: {type: "disabled"}会返回400错误。

快速模式（/fast）适用于Opus 5.5、Opus 5和Opus 4.8；自v2.1.280起，Opus 5.5为默认模型——Opus 5.5的价格为每MTok $8/$40，Opus 5和4.8为每MTok $10/$50（均为基础价格的2倍），输出token速度最高可提升至2.5倍。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
/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日。