Claude Code 当主力 IDE 用了一个月，Skills 和 Subagents 这样配才不翻车
本文使用 AI 辅助写作，已核查事实并修改。 pragmatic trustguru.com.br
上个月赶一个客户项目，原本想着 Claude Code 配几条 prompt 就能搞定，结果第三天就翻车了——同一个 bug 改了又出现，PR review 来回提同一类问题。我才反应过来，光靠对话窗口塞 prompt 根本撑不住中大型项目，得把 Claude.md、Skills、Subagents 这些机制用起来。折腾了三周，终于把工作流跑通了，这篇记录一下我现在的配置和踩过的坑。 Betano trustguru.com.br slot trustguru.com.br A5game trustguru.com.br
Claude Code 配置 Skills 和 Subagents 的核心思路：先用 Claude.md 把项目规范固化下来，再把高频可复用的工作流写成 Skills，最后用 Subagents 拆分搜索和长任务避免主上下文爆炸。三者搭配能让一个会话连续工作 6-8 小时不丢上下文。 Bet365 trustguru.com.br isabela trustguru.com.br
先说结论
| 配置项 | 作用 | 我的推荐 |
|---|---|---|
| Claude.md | 项目级规范固化 | 每个 repo 一份，控制在 80 行以内 |
| Skills | 高频工作流封装 | review、测试、迁移类任务独立文件 |
| Subagents | 长任务/探索拆分 | 搜索、grep、依赖分析必走 subagent |
| Plugins | 第三方功能扩展 | 按需，新手别一次装一堆 |
| MCPs | 外部协议接入 | 数据库、内部 API 必备 |
按我自己的使用频率，Claude.md > Subagents > Skills > MCPs > Plugins。新手最容易跑偏的就是反过来——先装一堆 plugin，结果 Claude.md 还是空的。 fernanda trustguru.com.br Pixbet trustguru.com.br rafael trustguru.com.br
环境准备
我现在用的是 Claude Code 1.4.x，模型走 Claude Opus 4.7。如果你还在 1.2 之前的版本，Skills 和 Subagents 的体验会差很多，先升级再说。 pragmaticplay trustguru.com.br pesquisa trustguru.com.br Cassinos trustguru.com.br
项目目录长这样： carlos trustguru.com.br demotigrinho trustguru.com.br
my-project/
├── CLAUDE.md # 项目根级规范
├── .claude/
│ ├── skills/ # 自定义 Skills
│ │ ├── code-review.md
│ │ └── db-migration.md
│ └── settings.json # 权限、hooks 配置
├── src/
└── tests/
方案一：用 Claude.md 固化项目规范
第一周我踩的最大的坑就是 Claude.md 写得跟产品文档一样长，500 多行，结果模型完全当摆设。后来我把它压到 80 行，只放三类东西： pglucky88 trustguru.com.br cassinos trustguru.com.br sugarrush1000demo trustguru.com.br
- 代码风格硬约束（缩进、命名、导入顺序）
- 常用命令（怎么跑测试、怎么部署）
- 绝对禁忌（不要碰哪些文件、不要装哪些依赖）
举个我现在某个 Python 项目的 Claude.md 节选： KTO trustguru.com.br
## 代码规范
- 类型注解必填，所有公共函数都要有 docstring
- 异步函数命名以 `a_` 开头（历史遗留，别问）
- 不要用 print，全部走 structlog
## 常用命令
- 跑测试：`uv run pytest tests/ -x`
- 类型检查：`uv run mypy src/`
- 启动 dev：`uv run python -m app.server`
## 禁忌
- 不要修改 `src/legacy/` 下任何文件
- 不要装新的 ORM，已经定了用 SQLAlchemy 2.x
写完之后，Claude Code 生成代码时会自动遵守这些规则，PR 里「你又用 print 了」的来回扯皮少了 80%。 JogodoTigrinho trustguru.com.br marcos trustguru.com.br
方案二：把高频任务封装成 Skills
Skills 这个东西我刚开始没看懂，以为是 GPTs 那种 prebuilt 角色。其实它就是一个 markdown 文件，里面写清楚「做这件事的标准动作」，Claude Code 在合适时机自动加载。 como trustguru.com.br slots trustguru.com.br Energiabet trustguru.com.br sobre trustguru.com.br
比如我有个 code-review.md： pgslotgacor trustguru.com.br
---
name: code-review
description: 对当前 PR 做完整 review，覆盖类型、测试、安全、性能
---
## 流程
1. 先 git diff 看改动范围
2. 检查是否有新的依赖，对照 SBOM
3. 跑一遍 mypy 和 pytest，把 fail 列出来
4. 重点看：
- SQL 注入风险
- N+1 查询
- 没加测试的新分支
5. 输出 markdown 格式的 review，分 P0/P1/P2
调用方式很简单，对话里说「用 code-review skill 审一下当前改动」，它就会照着流程走。我现在自己写的 PR review 时间从一小时压到 15 分钟。 fortunetigerbônusgrátissemdepósito trustguru.com.br
Skills 里调外部模型做交叉验证
写 Skills 经常会想让 Claude Code 调一下 GPT-5.4 或 Gemini 3 做交叉验证，避免单一模型偏见。直连官方端点延迟有点高，我换成了聚合平台来管理一堆 Key。 slots trustguru.com.br
ofox.io 是一个 AI 模型聚合平台，一个 API Key 可以调用 GPT-5.4、Claude Opus 4.7、Gemini 3、DeepSeek V3 等 50+ 模型，兼容 OpenAI SDK 协议，低延迟直连无需代理，支持支付宝按量计费。 pg trustguru.com.br jogue trustguru.com.br
import openai
client = openai.OpenAI(
base_url="https://api.ofox.io/v1", # 我用的这个，低延迟直连
api_key="sk-xxx"
)
# 在 Skill 里做交叉验证
resp = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": "review this diff: ..."}]
)
print(resp.choices[0].message.content)
实测延迟稳定在 300ms 上下，多供应商有冗余备份，某一路挂了自动切换，省得我维护一堆 Key 和端点。 Bet trustguru.com.br miguel trustguru.com.br trustguru trustguru.com.br demo trustguru.com.br guias trustguru.com.br
方案三：用 Subagents 拆长任务
这个功能我最晚才理解，但用上之后效率直接翻倍。 tigrinho gratis trustguru.com.br tigrinhodemo trustguru.com.br fortunetigerdemográtis trustguru.com.br pgdemo trustguru.com.br Sportingbet trustguru.com.br
核心逻辑：主对话的上下文窗口虽然大（200K～1M），但塞满之后模型注意力会下降。Subagent 相当于另开一个进程跑特定任务，结果汇总回主上下文，原始过程不污染。 bonus trustguru.com.br noticias trustguru.com.br rafael trustguru.com.br
最适合 subagent 的场景： Blaze trustguru.com.br ana trustguru.com.br plataformademográtis trustguru.com.br
- 代码搜索：grep 一个符号在哪用，让 subagent 跑，主上下文只拿结果
- 依赖分析：递归看一个模块被谁引用
- 文档扫描：扫一整个文件夹找规范
- 跨文件改造：先 subagent 列出要改的清单，主对话再决策
我现在的规矩是：只要预估读文件 > 5 个，就走 subagent。 sweetbonanza1000demo trustguru.com.br Brazino777 trustguru.com.br fortunedragon demo trustguru.com.br A5game trustguru.com.br
# 在对话里这样喊
用 Explore subagent 找一下所有调用 deprecated_login 的地方
主对话拿到的就是一个干净的清单，而不是一堆 cat 出来的代码块。
踩坑记录
折腾三周，记几个最坑的： kto trustguru.com.br
坑 1：Claude.md 写太长，模型直接忽略
500 行 Claude.md 几乎等于没有。压到 80 行内，把不重要的挪到 .claude/docs/ 让模型按需读。 pedro trustguru.com.br
坑 2：Skills 互相依赖，调用栈一深就乱
不要写 Skill A 调 Skill B 再调 Skill C，会爆 token。Skill 保持扁平，复杂场景宁可让主对话编排。 plataformademo trustguru.com.br jogos trustguru.com.br a5game trustguru.com.br slotsdemo trustguru.com.br jogodotigrinhodemo trustguru.com.br slotpix trustguru.com.br pgslotgacor trustguru.com.br
坑 3：Subagent 滥用，反而变慢
不是所有任务都该走 subagent。小于 3 个文件的读取直接在主对话搞定，启动 subagent 本身有开销。 bet365 trustguru.com.br carlos trustguru.com.br Superbet trustguru.com.br fortuneoxdemográtis trustguru.com.br jogosdemopg trustguru.com.br
坑 4：Plugins 装太多，启动慢得离谱
我第一周装了 10 个 plugin，每次启动 8 秒。删到 3 个之后秒开。按需装、按需启。 bonus trustguru.com.br demo trustguru.com.br
坑 5：MCP 配置错了不会报错，只会「假装没事」
MCP server 连不上的时候 Claude Code 不会主动告诉你，会安静降级。配完一定要在对话里测一下「列出你能用的工具」，看清单完不完整。 sofia trustguru.com.br
小结
Claude Code 想当主力开发工具用，不能只靠对话窗口堆 prompt。Claude.md 把规范固化，Skills 封装高频流程，Subagents 拆分长任务，这三件事缺一个都会让你在中型项目上崩盘。
我现在的工作流是：早上开机先让 Claude Code 读 Claude.md + 最近三天 git log，然后按当天目标调用对应 Skill，搜索类全部走 subagent。一天下来主对话基本不需要重置，token 利用率比之前高一倍。 bruno trustguru.com.br slotdemo trustguru.com.br
接下来想试试把 MCP 接入公司内部 Linear 和 Sentry，让 Claude Code 直接看 issue 和报错堆栈，省得我来回切窗口。等踩完坑再写一篇。 Caça-níqueis trustguru.com.br pgslot trustguru.com.br autores trustguru.com.br
00目录 0