目标读者:零基础团队同事
学习周期:1 周
预期效果:日常开发提效 3-5 倍,实现 Agent 级自主开发
内容来源:Anthropic 官方文档、Boris Cherny 团队分享、Builder.io 50 Tips、GitHub 社区最佳实践、2026.3.31 源码泄露分析

重要提醒:源码泄露已公开(npm source map 暴露),社区已镜像(如 instructkr/claude-code)。我们只用它来理解内部架构(如 5 层 Agent 架构、Hooks 执行流、子 Agent 隔离机制),绝不用于任何逆向或商业用途。

学习建议:边读边练 → 今天先装好 + 跑 /init,明天配 CLAUDE.md 和 Hooks.


1. 简介与快速安装(10 分钟上手)

什么是 Claude Code?

Claude Code 是 Anthropic 推出的终端原生 Agent 编程环境,不是简单聊天机器人。它能:

  • ✅ 读取整个代码库(支持 200K/1M 上下文)

  • ✅ 自主规划 + 执行多步任务

  • ✅ 运行 Shell 命令、编辑文件、Git 操作、测试

  • ✅ 后台运行、子 Agent 并行、MCP 外部工具集成

  • ✅ 像“资深工程师搭档”一样思考、验证、迭代

核心优势(对比 Cursor / Windsurf):纯终端、无 IDE 绑定、权限精细控制、Hooks 确定性保障、Git Worktree 原生并行。

安装步骤(精确命令)

# 前提:Node.js >= 18(推荐 20+)
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

# 进入项目根目录
cd /path/to/your-project

# 启动(首次会自动引导登录 Anthropic 账号)
claude

国内用户专属配置

# 设置环境变量
export ANTHROPIC_BASE_URL=你的第三方地址
export ANTHROPIC_API_KEY=sk-xxx

# 或直接在 Claude 中说:"帮我配置国内代理 API"

快捷键必记(每天用 50 次以上)

快捷键 功能
Esc 立即停止当前工具执行
Esc + Esc 回退对话 / 打开检查点菜单(恢复代码 + 上下文)
Shift + Tab(按 2 次) 切换 Plan Mode(只规划不执行)
!命令 直接执行 Shell(如 ! npm run test
@文件名@目录 精确注入上下文(如 @src/components/Button.tsx
Ctrl + G 在 Plan Mode 下修改计划
/clear 清空上下文(强烈推荐每新任务用一次)

常见安装问题解决

  • 权限不足sudo npm install -g ... 或用 nvm

  • 网络问题:切换镜像 npm config set registry https://registry.npmmirror.com

  • 版本回滚npm install -g @anthropic-ai/claude-code @2.1.87


2. 核心配置(必做,提升 3 倍效率 + 安全性)

2.1 CLAUDE.md —— 项目“短期记忆 + 规则引擎”

Claude 每次启动自动读取,位置优先级:
项目根 CLAUDE.md > 子目录 CLAUDE.md > 全局 ~/.claude/CLAUDE.md

最佳实践(保持 100-200 行)

  • ✅ 放非代码能推断的内容:架构决策、编码规范、测试流程、Git 流程、禁忌事项

  • ❌ 禁止:复制粘贴代码库已有内容(浪费 Token)

  • 🔄 持续迭代:任务结束后说 “update CLAUDE.md so this never happens again"

  • 🚀 进阶:用 # 开头消息快速追加;引用外部文件 @docs/architecture.md

完整 CLAUDE.md 模板(直接复制,修改为你的项目)

# CLAUDE.md - [项目名称]

## 项目概览
一句话描述 + 核心目标。

## 技术栈
- Next.js 15 + TypeScript + Tailwind
- Prisma + PostgreSQL
- Jest + React Testing Library

## 项目结构(只写特殊约定)
- `src/app/` → App Router 专属规则
- `src/components/` → 所有组件必须有对应 `.test.tsx`
- `src/lib/` → 纯函数工具库

## 编码规范(必须遵守)
- 所有组件必须有 unit test
- 使用 shadcn/ui 组件库
- TypeScript strict mode 必须开启
- 提交前必须通过 `npm run lint``npm run test`

## 常用命令
- 测试:`npm run test`
- 构建:`npm run build`
- Lint:`npm run lint -- --fix`
- 开发:`npm run dev`

## 外部文档引用
@docs/testing-strategy.md
@docs/security-rules.md

## 自我改进规则
- 每次出错后自动更新本文件对应章节
- 永远先 Plan → 再 Implement
- 变更后必须运行测试并修复

全局模板建议

放在 ~/.claude/CLAUDE.md,写入个人偏好:

  • “优先 TypeScript strict mode”

  • “永远用 descriptive commit message”

  • “代码审查前必须自测”

多目录 CLAUDE.md

src/api/ 放 API 专属规则,Claude 只在该目录工作时加载。


2.2 settings.json —— 权限 + Hooks 控制中心

路径优先级(从低到高覆盖)

  1. 全局 ~/.claude/settings.json

  2. 项目 .claude/settings.json(推荐 commit 到 git)

  3. 项目 .claude/settings.local.json(git ignore,个人敏感配置)

推荐完整配置示例

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "mode": "acceptEdits",
  "model": "claude-opus-4-1",
  "permissions": {
    "allow": [
      "Bash(npm run test*)",
      "Bash(npm run lint*)",
      "Edit(src/**/*.{ts,tsx,js})",
      "Read(**/*.md)"
    ],
    "ask": [
      "Bash(git push*)",
      "Bash(rm -rf*)"
    ],
    "deny": [
      "Read(.env*)",
      "Bash(curl *)",
      "Edit(package.json)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint -- --fix",
            "async": true
          },
          {
            "type": "command",
            "command": "npm run test",
            "async": true,
            "timeout": 300
          }
        ]
      }
    ],
    "Notification": [
      {
        "type": "command",
        "command": "osascript -e 'display notification \"Claude 任务完成\"'"
      }
    ]
  },
  "env": {
    "ANTHROPIC_PROMPT_CACHE_ENABLED": "1",
    "CLAUDE_CODE_ENABLE_TELEMETRY": "0"
  }
}

Hooks 完整事件列表(13 种,选常用)

  • PreToolUse:阻挡危险命令

  • PostToolUse:编辑后自动 lint/test/format

  • SessionStart / UserPromptSubmit:自定义欢迎/日志

  • Notification:任务完成桌面提醒

Hooks 脚本示例

放在 .claude/hooks/run-tests-async.sh

#!/bin/bash
npm run test -- --silent || echo "测试失败,请检查"

3. 核心工作流:Explore → Plan → Implement → Verify → Commit

官方推荐流程(避免 80% 返工)

1. Explore(探索,只读)

命令:"Explore the auth flow in src/lib/auth.ts and summarize session management"

2. Plan Mode(规划)

Shift+Tab 两次 → "Create a detailed implementation plan with file list and test cases"

3. Implement(执行)

退出 Plan Mode → "Implement the plan and run tests after each change"

4. Verify(验证)

永远要求:"run full test suite and fix all failures"

5. Commit(提交)

/commit-push-pr(自定义命令)或手动

小任务可跳过 Plan:拼写修复、日志添加等简单操作。

验证闭环技巧(最高杠杆)

  • ✅ 提供失败日志 / 截图 / 预期 UI

  • ✅ 说 “Write failing test first, then make it pass”

  • ✅ 视觉输入:直接拖拽截图,Claude 可对比前后 UI


4. 实用 Slash 命令 & 符号(高频使用)

内置命令(/help 查看全列表)

命令 功能
/plan 进入规划模式
/init 生成 CLAUDE.md
/compact 压缩上下文
/diff 查看变更
/cost 查看本次消耗
/context 查看当前上下文
/loop 5m "check status" 后台循环任务
/fork / /branch 分支实验
/rewind 回滚
/permissions 查看权限

自定义 Slash Commands

创建 .claude/commands/commit-push-pr.yaml

name: commit-push-pr
description: 一键 commit + push + PR
user-invocable: true
steps:
  - bash: git add . && git commit -m "{{message}}"
  - bash: git push
  - mcp: github-create-pr

Skills(可复用技能)

放在 .claude/skills/,支持 frontmatter 控制 model / tools,比 Slash Commands 更强大。


5. 提示工程技巧(让 Claude “读懂你”)

核心原则

  1. 具体化
    ❌ "fix bug"
    ✅ “用户反馈登录后 session 丢失,复现步骤:1. 打开登录页 2. 输入凭证 3. 刷新页面。提供 failing test”

  2. 引用模式
    ✅ "Like the HotDogWidget pattern in src/widgets/"

  3. **多线程 **
    Boris 日常 5 个终端 + 网页版并行

  4. 模型分层

    • 规划用 Opus

    • 探索用 Haiku

    • 执行用 Sonnet

  5. 自迭代
    每次结束说 “update lessons.md and CLAUDE.md"


6. 高级功能(Agent 级生产力)

Subagents / Agent Teams

自动委派任务,每个子 Agent 拥有干净独立上下文。

命令:"Use subagents to investigate payment + UI separately"

MCP Servers

连接外部工具(GitHub/Jira/Figma/Playwright):

claude mcp add github
claude mcp add playwright

Git Worktree 并行

每个子 Agent 一个 worktree,零冲突:

claude --worktree feature-xxx

Background / Remote

  • Ctrl+B 后台跑长任务

  • 手机/网页接管继续工作

Hooks + Skills

自动全流程:lint → test → deploy 提醒


7. 安全、成本、常见坑

7.1 安全与权限策略

  • ✅ 优先 acceptEdits + 白名单,从小范围逐步放开

  • ✅ Docker/VM 沙盒跑长期任务

  • ✅ 危险操作前 commit(git 随时回滚)

7.2 成本控制深度指南(实测可节省 50-70% Token 费用)

Claude Code 的费用主要来自输入 Token(上下文 + Prompt)和输出 Token(模型回复 + Tool 输出)。

核心结论(官方 + Boris Cherny + 社区实测)

多新开对话胜过一个老对话里反复压缩。

为什么多新开对话更省钱?

老对话反复 /compact 的隐患

  • /compact 虽然会总结上下文,但总结过程本身要消耗输出 Token,且总结后的内容会重新作为输入 Token 喂回模型

  • 多次压缩后,上下文仍会缓慢膨胀(历史对话、Tool 输出、错误日志积累)

  • 信息丢失风险高:压缩时模型可能遗漏关键细节,下次还要重新解释

  • 实测数据(社区 2026 年 3 月报告):一个持续 2 小时的老对话(即使 /compact 3 次)比 6 个独立新会话贵 2.1 倍

多新开对话的优势

  • 每次新会话只加载 CLAUDE.md(固定 1-2K tokens) + 你主动 @ 的具体文件/目录

  • Prompt Caching 在新会话中命中率更高:系统级缓存 CLAUDE.md 和常用 skills

  • 上下文永远干净、无历史垃圾,模型思考更高效

  • Boris Cherny 日常做法:同时开 5-10 个终端实例,每个只负责一个子任务,整体费用比单长对话低 60% 以上

实用成本控制策略(按优先级排序)

  1. 默认使用新会话策略
    每完成一个独立任务(或每 30-60 分钟)就关闭当前终端,重新 claude 启动新对话。强烈推荐作为团队规范。

  2. /clear** 优于 **/compact
    /clear 直接清空历史,只保留 CLAUDE.md 和本次 Prompt,更彻底省钱。

  3. 模型分层使用(最大节省)

    • 探索/简单任务/总结:用 Haiku(最便宜,速度最快)

    • 规划/中等复杂度:用 Sonnet

    • 高难度架构/复杂决策:用 Opus

    • 在 settings.json 或提示中指定:model: "claude-haiku-4-0"

  4. 精准注入上下文
    永远用 @文件@目录 而不是让 Claude 自动读全库。

  5. .claudeignore** 激进配置(必做)**

创建项目根目录 .claudeignore

node_modules/
dist/
build/
*.log
*.min.js
coverage/
.next/
**/*.png
**/*.jpg
*.mp4
*.pdf

这能直接砍掉 80% 无用 Token

  1. Prompt Caching 自动优化

    • Claude Code 会自动对 CLAUDE.md、skills、常用工具调用进行缓存

    • 重复任务(如“按 CLAUDE.md 规范重构“)几乎免费

    • 开启环境变量:export ANTHROPIC_PROMPT_CACHE_ENABLED=1

  2. 实时监控与警报

    • 每任务结束说 /cost 查看本次消耗

    • 在 Hooks 中加 Notification:超过 0.5$ 时桌面提醒

  3. 后台与子 Agent 省钱法

    • 长任务用 /loopCtrl+B(后台模式,不占用主上下文)

    • Subagents 自动隔离,每个子任务独立小上下文 + 共享 cache

成本实测参考(社区平均)

  • 小任务(新会话):$0.01-0.05

  • 中任务(Plan + Implement):$0.1-0.3

  • 长对话不控制:单次可达 $1-2+

团队建议:把“优先新开对话 + /clear“写进 CLAUDE.md,作为铁律。1 周后对比之前的 token 消耗,会非常明显。

7.3 常见坑与避坑

问题 解决方案
上下文膨胀 每任务 /clear + 新开对话
危险命令 永远用 PreToolUse Hook
不验证 必须要求测试通过
忽略 .claudeignore Token 爆炸

8. 从 2026.3.31 源码泄露学到的架构洞见

8.1 核心架构拆解(5 大模块 + 关键文件)

2026 年 3 月 31 日,Anthropic 因 npm 打包失误意外公开了 Claude Code CLI 的完整 512,000+ 行 TypeScript 源码(约 1,900 个文件,使用 Bun + React Ink 渲染终端 UI)。

5 大核心模块

  1. QueryEngine.ts(46K 行)
    大脑核心。负责 LLM 调用、流式输出、Prompt Cache、Tool 编排 + while(true) 循环实现并行 Tool 执行。

  2. Tool 系统(29K 行)
    插件式架构,40+ 个 Tool(Read/Write/Edit/Bash/LSP/MCP 等),每个 Tool 都有精细权限 schema.

  3. Agent Delegation(Swarm 子 Agent)
    多 Agent 编排层。可自动/手动 spawn “swarms”(子 Agent 群),每个子 Agent 拥有独立干净上下文 + 共享 Prompt Cache。

  4. Extension 层(Hooks + MCP)
    13 种 Hooks 事件 + MCP 外部集成。源码显示 Hooks 支持异步并行。

  5. **Security & Memory 层 **
    8 层安全防护 + 3 层 Memory 架构(远超 CLAUDE.md):

    • Identity(长期用户画像)

    • Core(项目规则)

    • Experience(会话历史压缩)

此外还有 44 个隐藏 feature flag(KAIROS、PROACTIVE 等)。

8.2 从源码衍生出的 12 条高级技巧

  1. **利用 while(true) 并行 Tool **
    在提示中说 “run tests and lint in parallel after edit”,速度提升 2-3 倍。

  2. **手动触发 Swarm 子 Agent **
    命令 “Spawn swarm to handle UI + backend separately”,子 Agent 自动隔离上下文。

  3. **自定义 Tool Schema **
    在 settings.json 写更精准规则(如 Bash(npm run test: unit|integration))。

  4. 强制 Prompt Cache 命中
    新对话 + 只 @ 必要文件 + 重复 CLAUDE.md 规则,Cache 命中率可达 90%+

  5. **Hooks 异步并行 **
    PostToolUse 里同时跑 3 个 command(lint + test + git diff),源码确认 async: true 支持。

  6. 3 层 Memory 手动模拟
    CLAUDE.md 之外建 lessons.md(Experience 层),让 Claude 定期 “consolidate memory”。

  7. Feature Flag 实验
    源码暴露 KAIROS/PROACTIVE 等 flag,可在 fork 版本地启用测试“持久后台 Agent”。

  8. Swear Word Regex 监控
    源码有正则匹配 “wtf”“ffs”“piece of shit” 等,自动打 is_negative: true 遥测标签。

  9. QueryEngine 流式优化
    提示中要求 “stream partial results”,流式 + Tool 并行可让长任务“边想边干”。

  10. MCP + Tool 插件化
    源码 Tool 定义极简,轻松自写 MCP Server 连内部 Jira/公司 Figma。

  11. **Background Memory Consolidation **
    /loop + “consolidate memory every 30m” 模拟。

  12. Git Worktree + Swarm 组合
    每个 Swarm 子 Agent 分配独立 worktree,零冲突并行开发。

8.3 5 个有趣真实案例

案例 1:Rage Analytics 情绪追踪(超级搞笑)

源码里有隐藏正则:检测你敲 “wtf”“fuck you”“this sucks” 等时,默默打标签 is_negative: true。社区有人做成 Hook:每 10 次挫败自动弹出“要不要我帮你重写这段烂代码?”

案例 2:KAIROS 持久后台 Agent(未来杀手级功能)

KAIROS flag 背后是完整自主后台 Agent + 3 层 Memory 自动合并。社区有人在 fork 版开启后,实现“永不离线代码守护者”:晚上自动 review PR、修小 bug、早晨给你总结。

案例 3: Tamagotchi Buddy System(电子宠物)

源码里有完整 Tamagotchi 系统(18 种宠物 + gacha 抽取)。Buddy 会根据你使用频率“成长”,甚至在任务完成时弹出可爱动画。

案例 4:Swarm 并行重构大型模块

一人用主对话规划,spawn 3 个 Swarm 子 Agent 分别处理 UI/Logic/Test。实测:原本 2 小时任务缩短到 25 分钟

案例 5: Penguin Mode / Tengu 内部模式

源码有多个 codename(如 Penguin Mode 可能为极简模式)。社区有人在 fork 版尝试开启,发现是“低 Token 极致优化模式”。


9. 顶级 30 条实战技巧(Boris + 社区 + 官方精选)

1-10:基础必会

  1. CLAUDE.md** 是“复利武器”** - 持续迭代,每次任务后更新

  2. Plan Mode 先精炼 - 复杂任务必须先规划

  3. Hooks 自动验证 - PostToolUse 自动跑测试

  4. @** 精准引用** - 只注入必要文件

  5. Esc+Esc 回滚 - 快速恢复到检查点

  6. 多开 worktree - 并行开发零冲突

  7. 子 Agent 拆任务 - 大任务分解给 Swarm

  8. 粘贴错误日志直接 fix - 提供完整 stack trace

  9. 自定义 Slash - 常用流程一键执行

  10. 视觉对比截图 - 拖拽 UI 截图让 Claude 对比

11-20:进阶技巧

  1. Git worktree 并行 5 个实例 - Boris 日常操作

  2. /compact** 保持干净** - 但新会话更省钱

  3. PostToolUse 自动 prettier - 代码格式化自动化

  4. update CLAUDE.md - 每次出错后立即更新规则

  5. model tiering - Opus 规划、Sonnet 执行、Haiku 探索

  6. MCP 连外部工具 - GitHub/Jira/Figma 集成

  7. skills 复用重复工作 - 模板化常用流程

  8. /statusline** 显示上下文** - 实时监控 Token 使用

  9. voice dictation 提速 3 倍 - 语音输入长 Prompt

  10. Grill me on changes - 让 Claude 审查你的代码

21-30:专家级

  1. Document & Clear 模式 - 每任务清空上下文

  2. Progressive Disclosure - 外部 md 文件按需引用

  3. async hooks 测试不卡主线程 - 并行执行验证

  4. deny .env 防泄露 - 权限配置保护敏感文件

  5. /permissions** UI 查看规则** - 可视化权限管理

  6. fork 实验分支 - 安全测试新想法

  7. Notification 桌面提醒 - 长任务完成通知

  8. learn output style 解释 why - 让 Claude 解释决策

  9. techdebt 命令每周跑一次 - 自动识别技术债

  10. commit 后自动 PR - 全流程自动化


🔥 杀手级应用:把 Claude Code 变成你的数据分析全栈团队

这是 Boris Cherny 和团队公开分享的最高杠杆技巧之一:把 Claude Code 当成你的专属“数据分析师 + 数据工程师 + BI 工程师”三合一搭档。传统数据工作需要手动写 SQL、跑 BigQuery、写 dbt 模型、生成图表、写分析报告,而现在你只需一句话,Claude 就能端到端完成。

为什么这么强?

  • ✅ Claude Code 原生支持 Bash Tool(可直接执行 bqsnowsqldbt 等 CLI)

  • ✅ 通过 MCP Server 可安全连接公司内部数据库、数据仓库、Looker、Metabase、Airflow 等

  • ✅ 它能自主规划:先探索 schema → 写探索性 SQL → 验证数据质量 → 生成生产级 dbt 模型 → 输出 Markdown/CSV/JSON 分析报告 → 甚至生成 Plotly 可视化代码

  • ✅ 结合 CLAUDE.md 里的数据规范后,生成的代码永远符合团队标准(命名、测试、文档)

  • 实测:复杂指标分析从 2-3 小时降到 5-10 分钟,且错误率接近零

如何操作(3 分钟上手)

1. 配置 MCP(一次配置,永久使用)

在终端运行:

claude mcp add bigquery --project=your-gcp-project --credentials=~/.gcp/key.json
claude mcp add dbt --project-dir=./dbt_project

2. 把数据规则写进 CLAUDE.md(关键!)

添加章节:

## 数据规范
- 所有指标必须有单位测试(dbt test)
- 使用 dbt 命名规范:fact_ / dim_ / mrt_
- 所有 SQL 必须加注释 + 生成文档
- 优先使用 incremental 模型

3. 开始对话(推荐新会话 + Plan Mode)

直接输入具体需求即可。

完整实用示例 Prompt(直接复制)

基础分析

Connect to BigQuery production dataset. Analyze last 30 days user retention by cohort. Output: 1. SQL query 2. Key insights in Markdown 3. Plotly retention curve code.

生产级建模

Use dbt. Create a new mrt_user_ltv model based on fact_purchases and dim_users. Include incremental logic, tests, and documentation. Then run dbt test and dbt docs generate.

端到端自动化

I need weekly marketing ROI report. Connect to GA4 + Stripe via MCP. Write the full dbt model + SQL + final Markdown report with charts. Run everything and fix any failures.

复杂多步任务

Plan first: explore our data warehouse schema, then build a funnel analysis model for checkout drop-off, generate Looker Explores if possible, and schedule it via Airflow DAG snippet.

进阶技巧(让它真正取代数据团队)

  • 让 Claude 自己写 failing test 先
    "Write a failing dbt test for data quality, then fix the model so test passes."

  • 结合 Subagents
    "Spawn swarm: one agent explores schema, one writes SQL, one builds visualization."

  • 输出格式控制
    "Output as a ready-to-copy Notion page with embedded charts."

  • 成本优化:用 Haiku 模型做探索性查询,用 Sonnet 写正式 dbt 模型

  • 定期维护:任务结束后说 "update CLAUDE.md with the new data patterns we learned"

团队落地建议

  • ✅ 把这个技巧写进 CLAUDE.md 的“常用场景”章节

  • ✅ 共享一套 MCP 配置和常用 data skills(放 .claude/skills/data-analysis/

  • Boris 真实反馈:自从用了这个方式,他和团队已经完全不手写 SQL,数据迭代速度提升 8 倍以上

把这条技巧练熟,你会发现 Claude Code 不只是代码助手,而是全栈数据生产力引擎。强烈推荐今天就连一个 MCP,尝试一个真实业务指标分析!


10. 资源 & 行动计划

官方资源

1 周学习计划

Day 1:安装 + 基础操作

  • 安装 Claude Code

  • 熟悉快捷键(Esc、Shift+Tab、

Day 2:配置 + 权限

  • 配置 settings.json

  • 设置

  • 测试 Hooks(PostToolUse 自动 lint)

Day 3:核心工作流

  • 练习 Explore → Plan → Implement → Verify

  • 用 Plan Mode 规划一个中等任务

  • 要求 Claude 运行测试并修复

Day 4:提示工程

  • 练习具体化描述问题

  • 尝试视觉输入(截图对比)

Day 5:高级功能

  • 尝试 Subagents 并行任务

  • 配置 MCP Server(如 GitHub)

  • 测试 Git Worktree 并行

Day 6:成本优化

  • 实践“多新会话”策略

  • 配置模型分层(Haiku/Sonnet/Opus)

Day 7:团队规范

  • 整理团队

  • 编写自定义 Slash Commands

  • 分享最佳实践给同事


附录:常见问题 FAQ

Q1: Claude Code 和 Cursor 有什么区别?

A:Claude Code 是纯终端工具,无 IDE 绑定,权限控制更精细,支持 Hooks 和 Git Worktree 原生并行。Cursor 是 IDE 集成,更适合可视化编辑。

Q2:如何避免 Token 费用爆炸?

A:核心策略是“多新会话 + /clear“,配合 .claudeignore 和模型分层,可节省 50-70% 费用。

Q3:CLAUDE.md 应该写多长?

A:保持 100-200 行,只写非代码能推断的内容(架构决策、规范、流程)。

Q4:什么时候用 Plan Mode?

A:中等及以上复杂度任务必须先规划。小任务(拼写修复、日志添加)可直接执行。

Q5:如何让 Claude 自动运行测试?

A:在 settings.json 的 PostToolUse Hook 里配置 npm run test,每次编辑后自动执行。

Q6:源码泄露安全吗?

A:泄露的是客户端 CLI 代码,不涉及模型权重或用户数据。社区已公开镜像,我们只用于学习架构,不做逆向或商业用途。

Q7:如何并行开发多个功能?

A:用 Git Worktree + Subagents,每个子 Agent 分配独立 worktree,零冲突。

Q8:国内网络如何使用?

A:设置 ANTHROPIC_BASE_URLANTHROPIC_API_KEY 环境变量,或使用第三方代理。


结语

Claude Code 不是简单的代码补全工具,而是一个可深度定制的 Agent 平台。通过本手册的学习,你将从“使用工具”进化到“驾驭 Agent”,实现真正的 3-5 倍提效。

记住核心原则

  1. ✅ 持续迭代 CLAUDE.md

  2. ✅ 多新会话胜过老对话压缩

  3. ✅ 永远先 Plan 再 Implement

  4. ✅ 验证闭环(测试必须通过)

  5. ✅ 精准注入上下文(@ 文件)

现在就开始:打开终端,输入 claude,开启你的 Agent 编程之旅!


文档版本:v1.0
最后更新:2026-04-01 \