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 标志

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.118+）：

如需完整设置schema，请参阅完整指南中的配置深度解析。

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的推荐替代方案。只读操作和文件编辑会自动批准。自定义允许/拒绝规则会优先解析。其他所有操作都会交给安全分类器。默认自动阻止：curl | bash、强制推送到main、生产环境部署、大规模云资源删除、IAM变更、向外部发送敏感数据。¹

断路器：会话中连续阻止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-*:*)的允许规则可让只读操作绕过提示。对于大量使用PowerShell的工作流，建议使用v2.1.149+；它修复了内置cd权限绕过、前缀/通配符允许规则匹配以及陈旧目录变量跟踪问题。

9. Hook 事件

| 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、匹配器、退出码），请参阅完整指南中的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设置会话标题。
• command hooks上的args: string[]（v2.1.139+）——传递结构化argv，无需shell引用。
• 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亿次，并收录了3000多个已索引服务器。³如需了解传输类型、引导请求和工具搜索配置，请参阅完整指南中的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万tokens的定价（截至2026年4月）。⁵

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

按计划划分的默认模型（截至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预算）。新的xhigh投入级别是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循环和安全分析使用Opus。复杂重构使用opusplan（Opus规划，Sonnet执行）。

15. 关键文件位置

16. 变更日志

17. 参考资料

这份速查表是完整Claude Code CLI指南的快速查阅配套资料。有关设置演练，请参阅Claude Code快速入门。如果是iOS和macOS项目，请参阅iOS Agent开发指南、XcodeBuildMCP集成模式，以及Apple生态系统系列。最后更新于2026年5月24日。