目标读者:零基础团队同事
学习周期: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 控制中心
路径优先级(从低到高覆盖)
-
全局
~/.claude/settings.json -
项目
.claude/settings.json(推荐 commit 到 git) -
项目
.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 “读懂你”)
核心原则
-
具体化
❌ "fix bug"
✅ “用户反馈登录后 session 丢失,复现步骤:1. 打开登录页 2. 输入凭证 3. 刷新页面。提供 failing test” -
引用模式
✅ "Like the HotDogWidget pattern in src/widgets/" -
**多线程 **
Boris 日常 5 个终端 + 网页版并行 -
模型分层
-
规划用 Opus
-
探索用 Haiku
-
执行用 Sonnet
-
-
自迭代
每次结束说 “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 小时的老对话(即使
/compact3 次)比 6 个独立新会话贵 2.1 倍
多新开对话的优势:
-
每次新会话只加载 CLAUDE.md(固定 1-2K tokens) + 你主动
@的具体文件/目录 -
Prompt Caching 在新会话中命中率更高:系统级缓存 CLAUDE.md 和常用 skills
-
上下文永远干净、无历史垃圾,模型思考更高效
-
Boris Cherny 日常做法:同时开 5-10 个终端实例,每个只负责一个子任务,整体费用比单长对话低 60% 以上
实用成本控制策略(按优先级排序)
-
默认使用新会话策略
每完成一个独立任务(或每 30-60 分钟)就关闭当前终端,重新claude启动新对话。强烈推荐作为团队规范。 -
/clear** 优于 **/compact
/clear直接清空历史,只保留 CLAUDE.md 和本次 Prompt,更彻底省钱。 -
模型分层使用(最大节省)
-
探索/简单任务/总结:用 Haiku(最便宜,速度最快)
-
规划/中等复杂度:用 Sonnet
-
高难度架构/复杂决策:用 Opus
-
在 settings.json 或提示中指定:
model: "claude-haiku-4-0"
-
-
精准注入上下文
永远用@文件或@目录而不是让 Claude 自动读全库。 -
.claudeignore** 激进配置(必做)**
创建项目根目录 .claudeignore:
node_modules/
dist/
build/
*.log
*.min.js
coverage/
.next/
**/*.png
**/*.jpg
*.mp4
*.pdf
这能直接砍掉 80% 无用 Token。
-
Prompt Caching 自动优化
-
实时监控与警报
-
每任务结束说
/cost查看本次消耗 -
在 Hooks 中加 Notification:超过 0.5$ 时桌面提醒
-
-
后台与子 Agent 省钱法
-
长任务用
/loop或Ctrl+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 大核心模块
-
QueryEngine.ts(46K 行)
大脑核心。负责 LLM 调用、流式输出、Prompt Cache、Tool 编排 +while(true)循环实现并行 Tool 执行。 -
Tool 系统(29K 行)
插件式架构,40+ 个 Tool(Read/Write/Edit/Bash/LSP/MCP 等),每个 Tool 都有精细权限 schema. -
Agent Delegation(Swarm 子 Agent)
多 Agent 编排层。可自动/手动 spawn “swarms”(子 Agent 群),每个子 Agent 拥有独立干净上下文 + 共享 Prompt Cache。 -
Extension 层(Hooks + MCP)
13 种 Hooks 事件 + MCP 外部集成。源码显示 Hooks 支持异步并行。 -
**Security & Memory 层 **
8 层安全防护 + 3 层 Memory 架构(远超 CLAUDE.md):-
Identity(长期用户画像)
-
Core(项目规则)
-
Experience(会话历史压缩)
-
此外还有 44 个隐藏 feature flag(KAIROS、PROACTIVE 等)。
8.2 从源码衍生出的 12 条高级技巧
-
**利用
while(true)并行 Tool **
在提示中说 “run tests and lint in parallel after edit”,速度提升 2-3 倍。 -
**手动触发 Swarm 子 Agent **
命令 “Spawn swarm to handle UI + backend separately”,子 Agent 自动隔离上下文。 -
**自定义 Tool Schema **
在 settings.json 写更精准规则(如Bash(npm run test: unit|integration))。 -
强制 Prompt Cache 命中
新对话 + 只@必要文件 + 重复 CLAUDE.md 规则,Cache 命中率可达 90%+。 -
**Hooks 异步并行 **
PostToolUse 里同时跑 3 个 command(lint + test + git diff),源码确认async: true支持。 -
3 层 Memory 手动模拟
在 CLAUDE.md 之外建lessons.md(Experience 层),让 Claude 定期 “consolidate memory”。 -
Feature Flag 实验
源码暴露 KAIROS/PROACTIVE 等 flag,可在 fork 版本地启用测试“持久后台 Agent”。 -
Swear Word Regex 监控
源码有正则匹配 “wtf”“ffs”“piece of shit” 等,自动打is_negative: true遥测标签。 -
QueryEngine 流式优化
提示中要求 “stream partial results”,流式 + Tool 并行可让长任务“边想边干”。 -
MCP + Tool 插件化
源码 Tool 定义极简,轻松自写 MCP Server 连内部 Jira/公司 Figma。 -
**Background Memory Consolidation **
用/loop+ “consolidate memory every 30m” 模拟。 -
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:基础必会
-
CLAUDE.md** 是“复利武器”** - 持续迭代,每次任务后更新
-
Plan Mode 先精炼 - 复杂任务必须先规划
-
Hooks 自动验证 - PostToolUse 自动跑测试
-
@** 精准引用** - 只注入必要文件 -
Esc+Esc 回滚 - 快速恢复到检查点
-
多开 worktree - 并行开发零冲突
-
子 Agent 拆任务 - 大任务分解给 Swarm
-
粘贴错误日志直接 fix - 提供完整 stack trace
-
自定义 Slash - 常用流程一键执行
-
视觉对比截图 - 拖拽 UI 截图让 Claude 对比
11-20:进阶技巧
-
Git worktree 并行 5 个实例 - Boris 日常操作
-
/compact** 保持干净** - 但新会话更省钱 -
PostToolUse 自动 prettier - 代码格式化自动化
-
update CLAUDE.md - 每次出错后立即更新规则
-
model tiering - Opus 规划、Sonnet 执行、Haiku 探索
-
MCP 连外部工具 - GitHub/Jira/Figma 集成
-
skills 复用重复工作 - 模板化常用流程
-
/statusline** 显示上下文** - 实时监控 Token 使用 -
voice dictation 提速 3 倍 - 语音输入长 Prompt
-
Grill me on changes - 让 Claude 审查你的代码
21-30:专家级
-
Document & Clear 模式 - 每任务清空上下文
-
Progressive Disclosure - 外部 md 文件按需引用
-
async hooks 测试不卡主线程 - 并行执行验证
-
deny .env 防泄露 - 权限配置保护敏感文件
-
/permissions** UI 查看规则** - 可视化权限管理 -
fork 实验分支 - 安全测试新想法
-
Notification 桌面提醒 - 长任务完成通知
-
learn output style 解释 why - 让 Claude 解释决策
-
techdebt 命令每周跑一次 - 自动识别技术债
-
commit 后自动 PR - 全流程自动化
🔥 杀手级应用:把 Claude Code 变成你的数据分析全栈团队
这是 Boris Cherny 和团队公开分享的最高杠杆技巧之一:把 Claude Code 当成你的专属“数据分析师 + 数据工程师 + BI 工程师”三合一搭档。传统数据工作需要手动写 SQL、跑 BigQuery、写 dbt 模型、生成图表、写分析报告,而现在你只需一句话,Claude 就能端到端完成。
为什么这么强?
-
✅ Claude Code 原生支持 Bash Tool(可直接执行
bq、snowsql、dbt等 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. 资源 & 行动计划
官方资源
-
50 Tips(Builder.io):https://www.builder.io/blog/claude-code-tips-best-practices
-
CLAUDE.md** 模板仓库**:https://github.com/abhishekray07/claude-md-templates
-
Boris 分享:搜索 @bcherny Claude Code
-
社区 GitHub: MuhammadUsmanGM/claude-code-best-practices
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_URL 和 ANTHROPIC_API_KEY 环境变量,或使用第三方代理。
结语
Claude Code 不是简单的代码补全工具,而是一个可深度定制的 Agent 平台。通过本手册的学习,你将从“使用工具”进化到“驾驭 Agent”,实现真正的 3-5 倍提效。
记住核心原则:
-
✅ 持续迭代 CLAUDE.md
-
✅ 多新会话胜过老对话压缩
-
✅ 永远先 Plan 再 Implement
-
✅ 验证闭环(测试必须通过)
-
✅ 精准注入上下文(
@文件)
现在就开始:打开终端,输入 claude,开启你的 Agent 编程之旅!
文档版本:v1.0
最后更新:2026-04-01 \