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

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

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

8. 权限模式

Auto Mode（v2.1.85+）是--dangerously-skip-permissions的推荐替代方案。只读操作和文件编辑会自动获批。系统会优先处理自定义 allow/deny 规则，其余操作均交由安全分类器判断。默认自动阻止的操作包括：curl | bash、强制推送至 main、生产环境部署、大规模删除云端资源、IAM 变更，以及向外部发送敏感数据。¹

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

# 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 team 成员进入空闲状态时 | 是 | | 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"
          }
        ]
      }
    ]
  }
}

匹配器语法：

退出代码：

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

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 设置会话标题。
• 命令 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+）： 让受信任的服务器不受工具搜索延迟加载机制影响。其所有工具都会在会话启动时加载，无需经过 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年7月）。⁵

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

Claude Code中的默认模型（自v2.1.197，即2026年6月30日起）： 所有新会话均默认使用Sonnet 5——原生支持1M上下文，首发优惠价为$2/$10，有效期至8月31日；只需运行一次/model opus即可切换到Opus（自v2.1.219起，该别名对应Opus 5）。管理员可设置组织级默认模型，该模型会在/model中显示为“组织默认值”（v2.1.196及更高版本）；在Bedrock/Vertex/Foundry上，可通过ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL固定使用特定模型。

Sonnet 5、Opus 5、Opus 4.8和Fable 5仅使用自适应推理（不支持固定思考预算）。这些模型的effort均默认为high；面对最困难的编码或代理式任务，可使用/effort xhigh。Opus 5相较Opus 4.8的破坏性变更： 对于省略thinking字段的请求，默认启用思考；若将thinking: {type: "disabled"}与xhigh或max级别的effort搭配使用，则会返回400错误。

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

在会话期间切换模型：

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/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日。