成为 Claude Code 高手的完整门户

不知道从哪开始？先选一条路径。三条路线对应三种人，每条都给出该按什么顺序读。

你现在在哪一级？勾选自测掌握度

勾选你已经会的，进度环实时显示掌握度，浏览器记住你的进度。这是你的精通路线图。

从零到能干活。所有命令经官方 setup/quickstart 文档核实 ✅。

Claude Code 是什么、在哪运行

一个 agentic 编程工具：读你的代码库、改文件、跑命令、用 git，全部由自然语言驱动。同一引擎跨多界面运行，CLAUDE.md / settings / MCP 配置通用。

安装：选哪种方式

系统要求：macOS 13+ / Win 10 1809+ / Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+；4GB+ RAM。Node 18+ 只有 npm 方式才需要。

# macOS / Linux / WSL —— 自动更新
curl -fsSL https://claude.ai/install.sh | bash
# 钉特定版本
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

# macOS/Linux，不自动更新
brew install --cask claude-code          # stable，约落后 1 周
brew install --cask claude-code@latest   # 最新
brew upgrade claude-code

# PowerShell
irm https://claude.ai/install.ps1 | iex
# WinGet（不自动更新）
winget install Anthropic.ClaudeCode

# 需 Node 18+，绝不要 sudo
npm install -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code@latest  # 升级（不是 npm update）

认证：选哪种

cd /path/to/your/project && claude   # 首次启动打开浏览器 OAuth 登录
# 浏览器没弹？按 c 复制 URL；WSL2/SSH/容器里在 "Paste code here" 粘贴返回码

第一个 10 分钟（拿来即用）

# 1-2 安装+验证
curl -fsSL https://claude.ai/install.sh | bash
claude --version          # 出错则 claude doctor
# 3-4 启动+确认
cd your-project && claude  # 浏览器登录
/status                   # 确认模型+认证
# 5-8 探索→改动→提交→真实任务
# 问"这个项目是做什么的？" → "给主文件加 hello world" → 看 diff → 批准
# "用一句有意义的话提交" → "给计算器函数写单元测试"

健康检查、更新与 /init

整个 Claude Code 精通的地基。会议反复强调"管理上下文"，但没讲透为什么。这里讲透。

Context window 是什么

Context window＝模型一次能"看到"的全部 token 上限。类比一张有限的工作台：系统提示、CLAUDE.md、工具定义、对话历史、你贴的文件……全摊在台子上。台子满了，要么挤掉旧东西，要么模型"看花眼"。

交互演示：什么在填满你的 context

点下面的按钮，看不同配置下 context 怎么被吃掉。这就是 MCP 的"隐形税"。

三个让模型"变笨"的真相

实战工具箱：/clear vs /compact vs subagent

会议演示的核心动作，逐个讲透——精确命令 + 键位 + 坑。

Plan Mode：先规划后执行（只读）

进入：按 Shift+Tab 循环（default → acceptEdits → plan）；或单条 prompt 前缀 /plan；或 claude --permission-mode plan。限制：只读——读文件、跑探索命令、写计划，但不改源码。编辑计划：Ctrl+G 在 $EDITOR 打开。

Rewind / Checkpoints：回退

Claude 在每次编辑前自动 checkpoint，每个用户 prompt 创建新 checkpoint，跨 session 持久。打开：/rewind，或输入框为空时按 Esc 两次。

输入模式：@ ! /

全部内置命令 + 自定义命令制作。下面的搜索框实时过滤命令表——输入即筛选。

自定义命令（现已并入 Skills）

# ~/.claude/skills/summarize-changes/SKILL.md
---
description: 总结未提交改动并标记风险。当用户问改了什么、要 commit message 时使用。
---

## 当前改动
!`git diff HEAD`

## 指令
用两三个要点总结上面的改动，然后列出风险（缺错误处理、硬编码值、需更新的测试）。

---
name: deploy
description: 部署到生产
disable-model-invocation: true   # 仅手动 /deploy 调用
allowed-tools: Bash(git add *) Bash(git commit *)
---
把 $ARGUMENTS 部署到生产：1.跑测试 2.构建 3.推送 4.验证

# 调用：/migrate-component SearchBar React Vue
---
name: migrate-component
argument-hint: [component] [from] [to]
---
把 $0 组件从 $1 迁移到 $2。保留所有现有行为和测试。

参数替换：$ARGUMENTS（整串）、$N（第 N 个，0 起）、$name（命名参数）。命名空间：plugin skills 为 plugin:skill；monorepo 嵌套同名加目录限定 /apps/web:deploy。

每个 flag 经官方 CLI reference + 本机 v2.1.195 --help 双重核实 ✅。按 ? 随时调出键位浮层。

核心调用与 flag

claude                          # 交互式
claude "explain this project"   # 带初始 prompt
claude -p "explain this fn"      # headless，打印后退出
cat logs.txt | claude -p "解释"      # 管道输入
claude -c                       # 继续当前目录最近对话
claude -r "auth-refactor" "完成 PR"   # 按名恢复
claude --resume abc123 --fork-session     # 分支而非复用

claude --append-system-prompt "Always use TypeScript"   # 追加（保留默认编程身份）
claude --system-prompt-file ./review.txt              # 完全替换（自负安全）
claude -p "query" --output-format json            # text|json|stream-json
claude --mcp-config ./mcp.json --strict-mcp-config     # 只用这些 MCP
claude -p --max-turns 3 --max-budget-usd 5.00 "query"
claude --bare -p "..."                            # CI 推荐：跳过 hooks/skills/plugins/MCP

claude update / install [version] / doctor
claude mcp add|list|get|remove|login|logout
claude plugin install|enable|disable|marketplace|validate
claude agents             # 管理/监控后台 agents
claude setup-token        # CI 用 1 年期 OAuth token
claude attach|logs|stop|respawn|rm <id>   # 后台 session 管理

键盘快捷键（精选 · 完整版按 ? 看浮层）

把单个任务做可靠、把主 context 保持干净的核心机制。

是什么、为什么用

Subagent 跑在自己的 context window 里，有自定义系统提示、特定工具、独立权限。Claude 遇到匹配某 subagent description 的任务时委派；subagent 独立工作，只把摘要返回主对话。好处：保护 context、强制工具约束、跨项目复用、控制成本（路由 Haiku）。

内置 subagent

三个实战 subagent 文件

---
name: code-reviewer
description: Reviews code for quality, security. Use immediately after writing code.
tools: Read, Grep, Glob, Bash
model: inherit
---
You are a senior code reviewer. When invoked: 1. Run git diff. 2. Focus on
modified files. 3. Begin review immediately. Feedback by priority:
Critical / Warnings / Suggestions. Include specific fix examples.

---
name: debugger
description: Debugging specialist. Use proactively when encountering issues.
tools: Read, Edit, Bash, Grep, Glob
---
Root-cause analysis: capture error+stack → reproduce → isolate → minimal fix
→ verify. Fix the underlying issue, not symptoms.

---
name: data-scientist
description: Data analysis expert for SQL/BigQuery. Use proactively for queries.
tools: Bash, Read, Write
model: sonnet
---
Write efficient SQL/BigQuery, summarize results, ensure queries are cost-effective.

编排流程图

把"软规则"变成"硬保证"的关键。

全部 hook 事件（能否阻断）

四个实战 hook

# PostToolUse + Edit|Write
{ "hooks": { "PostToolUse": [ { "matcher": "Edit|Write", "hooks": [
  { "type": "command",
    "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
] } ] } }

#!/bin/bash —— PreToolUse + Bash，exit 2 阻断
COMMAND=$(jq -r '.tool_input.command')
if echo "$COMMAND" | grep -q 'rm -rf'; then
  echo "Blocked: rm -rf not allowed" >&2
  exit 2
fi
exit 0

# SessionStart：stdout 注入为 context（压缩后重注入提醒）
{ "hooks": { "SessionStart": [ { "matcher": "compact", "hooks": [
  { "type": "command",
    "command": "echo '提醒：用 Bun 不用 npm。提交前跑 bun test。'" }
] } ] } }

# Notification（macOS）
{ "hooks": { "Notification": [ { "matcher": "", "hooks": [
  { "type": "command",
    "command": "osascript -e 'display notification \"需要你\" with title \"Claude Code\"'" }
] } ] } }
# Linux: notify-send  /  Windows: PowerShell MessageBox

MCP（Model Context Protocol）是连接 LLM app 与外部工具/数据/prompt 的开放标准（Anthropic 发起）。

添加 server

claude mcp add airtable --env AIRTABLE_API_KEY=KEY -- npx -y airtable-mcp-server
claude mcp add playwright -- npx -y @playwright/mcp@latest

claude mcp add --transport http github https://api.githubcopilot.com/mcp/
claude mcp add --scope project --transport http sentry https://mcp.sentry.dev/mcp

claude mcp add --transport sse linear https://mcp.linear.app/sse

.mcp.json（项目 scope，可提交 git）

{
  "mcpServers": {
    "my-remote": {
      "type": "http",
      "url": "https://example.com/mcp",
      "headers": { "Authorization": "Bearer ${TOKEN}" }  # ${VAR} 展开，不提交明文
    }
  }
}

Context 税与优化（呼应第 02 章）

每个 server 在启动时把所有工具定义注入系统提示——打字前就花 token。几十个工具能烧上万 token 并降低选择准确率。

会议的"沉淀 CLAUDE.md"+"AIM 分发治理"两层主线在这里落地。

CLAUDE.md 四层层级（拼接，不是覆盖）

settings.json 优先级 + 权限求值

{
  "permissions": {
    "deny":  ["WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)"],
    "ask":   ["Bash(git push *)"],
    "allow": ["Bash(npm run test *)", "Read(~/docs/**)"],
    "defaultMode": "acceptEdits"
  }
}

企业分发：AIM 的开源等价物

把团队好配置打包成"软件包"，让新人 day-1 即产出。

Plugin 打包什么 + 关键坑

自包含目录，打包 skills、slash commands、subagents、hooks、MCP servers、LSP、monitors、bin/。启用时一起激活。命名空间 /plugin-name:skill-name。

my-plugin/
├── .claude-plugin/plugin.json   # 清单（唯一放这里的）
├── skills/<name>/SKILL.md         # model-invoked（首选）
├── commands/*.md                 # 扁平 legacy 命令
├── agents/                       # subagents
├── hooks/hooks.json              # 事件 handler
└── .mcp.json                     # MCP servers

{ "name": "my-plugin", "description": "...", "version": "1.0.0", "author": { "name": "You" } }

安装与 marketplace

# 安装（官方 marketplace 首次启动自动注册）
/plugin install github@claude-plugins-official
# 加 marketplace（4 种源）
/plugin marketplace add anthropics/claude-code          # GitHub owner/repo
/plugin marketplace add https://gitlab.com/co/plugins.git#v1.0.0   # Git URL+钉 ref
/reload-plugins   # 安装/启用后免重启应用

把 Claude Code 从交互工具变成自动化基础设施。

Headless + Agent SDK

claude -p "auth 模块是做什么的？"
cat build-error.txt | claude -p '解释根因' > output.txt
claude --bare -p "..."   # CI 推荐：跳过 hooks/skills/plugins/MCP，可复现

npm install @anthropic-ai/claude-agent-sdk

import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const m of query({
  prompt: "Analyze this codebase for bugs and fix them",
  options: { allowedTools: ["Read","Edit","Glob"], permissionMode: "acceptEdits", maxTurns: 3 },
})) { console.log(m); }

pip install claude-agent-sdk

from claude_agent_sdk import query, ClaudeAgentOptions
options = ClaudeAgentOptions(permission_mode="acceptEdits", allowed_tools=["Read","Edit"])
async for message in query(prompt="Create a web server", options=options):
    print(message)

CI：GitHub Actions / GitLab

# 安装：会话里跑 /install-github-app
on: { issue_comment: { types: [created] } }
jobs:
  claude:
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
# 评论里 @claude implement this feature（是 @claude 不是 /claude）

# 无专用 action，job 里直接跑 claude -p
claude:
  image: node:24-alpine3.21
  before_script:
    - curl -fsSL https://claude.ai/install.sh | bash
  script:
    - claude -p "审查这个 MR 并实现改动" --permission-mode acceptEdits
# ANTHROPIC_API_KEY 设为 masked CI 变量，Claude 自动读取

OTEL 度量 + Bedrock/Vertex

# OpenTelemetry —— 规模化的 ROI 证据
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
# 8 核心 metric：session/lines_of_code/PR/commit/cost.usage/token.usage/code_edit_tool.decision/active_time

# Amazon Bedrock（钉模型，别名会滞后）
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'

把前面所有能力组合成可复制套路。这些是"高手与新手的差距"所在。

Explore → Plan → Code → Commit（官方默认）

TDD + 对抗式审查

Thinking / Effort 阶梯

并行 session：git worktree

claude --worktree feature-auth   # 隔离 worktree + 分支
claude --worktree "#1234"          # 从 PR 分支
# 加 .claude/worktrees/ 到 .gitignore；subagent 隔离用 isolation: worktree

opusplan：Opus 规划、Sonnet 执行

claude --model opusplan       # plan mode 用 Opus，执行自动切 Sonnet
claude --model opusplan[1m]   # 两阶段都 1M context

16 条 GenAI Playbook 精华（可复制为 prompt 喂给 AI）

这些是"融会贯通"的浓缩。点每张卡右下角"复制为 prompt"，可直接喂给任何 AI 当指导原则。

速查表 + 术语卡 + 个人精通 checklist。

模型与价格（✅核实，缓存 2026-06-04）

对抗复核纠正的事实

术语表（深入浅出）

个人深度精通行动清单

和 s0 共享进度——勾选记录你的精通之路。

这份门户怎么核实的、纠正了什么、来源在哪。

核实方法

• 官方文档全表面：13 个研究 agent 并行抓 code.claude.com/docs/en/，16 个对抗 agent 复核高风险声明。产出 224 finding、162 示例、51 流程图、15 对抗判决。
• CHANGELOG：raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md（4610 行，2026-06-29）确认能力引入版本。
• 本机二进制：claude --version = v2.1.195，claude --help 实测子命令。
• GenAI Playbook：8 chunk 并行蒸馏 + 综合，100 原始洞见 → 16 主题。
• 模型/价格：harness 内置 claude-api skill（缓存 2026-06-04）。

可信度标注

官方来源（自行复核）

code.claude.com/docs/en/ 下：overview · quickstart · setup · cli-reference · interactive-mode · commands · skills · memory · settings · sub-agents · hooks · mcp · common-workflows · model-config · iam · security · monitoring-usage · amazon-bedrock · google-vertex-ai · sdk · github-actions · gitlab-ci-cd · output-styles · statusline · plugins · plugin-marketplaces。CHANGELOG：github.com/anthropics/claude-code/blob/main/CHANGELOG.md。