用 Claude Code 两个月，我学到的一切

本文编译自 @Axel_bitblaze69 发布于 X 的原创文章，保留原文核心内容，结合实际使用体验整理。

现在是 2026 年 3 月，如果你还在把代码复制粘贴到 ChatGPT 里，那我们真的得谈谈了。

在过去的两个月里，我一直深陷于 Claude Code 之中。不是偶尔用用，而是每天都在用，在实战中摸爬滚打。

这不是一篇”十大 AI 工具”之类的肤浅文章。这是我学到的一切：那些没人谈论的功能、真正有效的流程、让我浪费数小时的错误，以及帮我节省数天的技巧。

Claude Code 到底是什么

让我先打破最大的误解。

Claude Code 不是 Copilot。它不是一个让你粘贴代码进去的聊天机器人。它也不是加强版的自动补全。

它是一个智能体（Agent）。一个真正的自主智能体。

它能够：读你的整个代码库、规划实施方案、在整个项目中编辑文件、运行你的测试、发现失败并进行修复、不断迭代直到任务完成。

关键词是智能体化（Agentic）。它在一个循环中运行：收集上下文、采取行动、验证结果、重复。

你告诉它你想要什么，它会想办法实现。你们不是在”一起写代码”，你是在授权给一个真正理解它所读内容的东西。

模型选择：学会匹配投入与问题

Claude Code 运行在 Anthropic 的 Claude 模型家族之上。了解何时使用哪种模型是成功的关键。

Claude Opus 4.6：最强大脑。用于复杂的架构决策、棘手的调试、涉及 10 个以上文件的大型重构。
Claude Sonnet 4.6：主力机型。默认模型。速度、成本和质量的最佳平衡。这是你的日常首选。
Claude Haiku：速度之王。便宜且快速。适合简单任务和子智能体。

随时切换：/model opus 在会话中遇到难题时切换；claude --model opus 以 Opus 启动整个会话。

我在第一周因为觉得 Opus “更聪明”而到处使用它，大概浪费了 200 美元。Sonnet 能以同样的方式处理 90% 的任务。

你还可以独立于模型控制思考深度：

/effort low：快速回答，最少推理
/effort high：深度分析，扩展思考
/effort max：全力以赴，消耗更多 Token，但能捕捉到人类容易忽略的边缘情况

.claude 文件夹：你项目的控制中心

这是大多数人浪费了 80% 价值的地方。

有两个 .claude 目录，而不是一个。

第一个在你的项目内部（提交到 Git，与团队共享）。第二个在 ~/.claude/（个人偏好、机器本地状态、会话历史）。

CLAUDE.md：最重要的单个文件

当你启动 Claude Code 会话时，它读取的第一件事就是 CLAUDE.md。它会直接加载到系统提示词中。

该写什么：

构建、测试和 Lint 命令
关键架构决策
不明显的注意事项
导入规范、命名模式、错误处理风格

不该写什么：

任何属于 Linter 或 Formatter 配置的内容
你已经可以链接到的完整文档
解释理论的长篇大论

保持在 200 行以内。

超过这个长度，Claude 的指令遵循度实际上会下降。我曾因为 400 行的 CLAUDE.md 被无视了一半内容而吃过苦头。缩减到 150 行后，一切都变好了。

一个扎实的 CLAUDE.md 示例：

项目：Acme API

命令
npm run dev          # 启动开发服务器
npm run test         # 运行测试 (Jest)
npm run lint         # ESLint + Prettier 检查
npm run build        # 生产环境构建

架构
- Express REST API, Node 20
- 通过 Prisma ORM 连接 PostgreSQL
- 所有处理程序位于 src/handlers/
- 共享类型位于 src/types/

规范
- 使用 zod 进行请求体验证
- 返回结构始终为 { data, error }
- 永远不要向客户端暴露堆栈跟踪

这只有 20 行。它给了 Claude 在这个代码库中高效工作所需的一切。

rules/ 文件夹：可扩展的模块化指令

真正的威力来自路径范围规则（Path-scoped rules）。添加 YAML 前置元数据，规则仅在 Claude 处理匹配的文件时激活：

---
paths:
  - "src/api/**/*.ts"
---
# API 设计规则
所有处理程序返回 { data, error } 结构
使用 zod 进行请求体验证

当 Claude 编辑 React 组件时，它甚至不会加载这个规则。干净、专注、高效。

改变工作方式的功能

多文件编辑

这是 Claude Code 甩开其他所有工具的地方。

claude "将身份验证系统重构为使用 JWT Token 而非 Session"

它会：找到每个涉及 Auth 的文件、更新中间件、修改路由、更改测试、更新配置、修复导入。在一个会话中跨越 15+ 个文件。

我曾在一个会话中将整个 Express 应用从回调函数重构为 async/await。23 个文件，每一个都正确。试着用 Tab 补全来做这个看看。

智能体循环：编写、测试、修复、重复

Claude 不仅仅是写代码，它还会运行代码：

编写函数 → 运行测试 → 发现失败 → 阅读错误 → 修复 Bug → 再次运行测试 → 全部通过。

这个循环才是重点。它不是”这是代码，祝你好运”，而是”我写好了，测试过了，修复了你没想到的边缘情况，而且通过了”。

子智能体：没人谈论的规则改变者

我花了 3 周时间才开始正确使用这个功能，我后悔没早点用。

Claude 可以生成专门的子智能体来隔离处理特定任务：

探索智能体：只读研究，快速，使用 Haiku
规划智能体：在实施前进行分析
通用智能体：在干净的上下文中处理复杂的多步任务

为什么这很重要： 当你让 Claude 运行完整的测试套件时，那几百行通过/失败的输出会淹没你的上下文窗口。子智能体在隔离环境中处理这些，传回一个干净的总结。

你还可以为特定流程创建自定义智能体：

# .claude/agents/security-reviewer.md
---
name: security-reviewer
description: 安全漏洞专家代码审查员。在审查 PR 或部署前主动使用。
model: sonnet
tools: Read, Grep, Glob
---

你是一名资深安全工程师。在审查代码时：
- 检查 SQL 注入和 XSS 风险
- 寻找暴露的凭据或密钥
- 检查身份验证和授权漏洞

tools 字段是有意为之的。安全审计员只需要 Read、Grep 和 Glob，不需要写文件的权限。

7 个常见错误（这些我都犯过）

1. 在 CLAUDE.md 里写长篇小说

保持在 200 行以内。具体、可执行。

2. 任务之间不使用 /clear

关于修复 CSS Bug 的对话对于实现新的 API 端点来说，有用上下文为零。残留的上下文会主动损害性能。清除它。每次都这样。

3. 与其死磕不如重启

在两次失败的尝试后，上下文就被错误的方法污染了。使用 /clear 并写一个更好的提示词。我曾为此浪费了 6 个小时才学会这一点。

4. 不使用子智能体

在主对话中运行完整的测试套件会让上下文充斥着数百行输出。授权给子智能体，保持主对话干净。

5. 事事都用 Opus

Sonnet 能完美处理 90% 的任务。Opus 用于那 10% 真正需要深度推理的任务。你的钱包会感谢你的。

6. 大改动时忽略 Plan 模式

在任何涉及 3 个以上文件的改动上，务必先进行规划。你花 5 分钟审查计划所节省的时间，能抵消 Claude 走错方向时你花 2 小时进行的清理工作。

7. 不主动管理上下文

上下文窗口是一种资源。像对待资源一样对待它。变长时使用 /compact，冗长的操作使用子智能体。

总结

Claude Code 不是一个工具。它是一个队友。

一个能阅读你整个代码库、遵循你的编码标准、运行你的测试、创建你的 PR、记住你的偏好，并且越用越好的队友。

那些学会与 Claude Code 协作，而不仅仅是向它粘贴代码的开发者，正在以一年前无法想象的速度交付成果。

现在是 2026 年。你可以访问一个能够自主导航 50,000 行代码库、进行精确的多文件修改、运行测试、修复自身 Bug 并创建带有文档的 Pull Request 的 AI 智能体。

停止收藏关于 AI 的文章。开始用它构建。

原文作者：@Axel_bitblaze69，发布于 X。