← Voltar aos guias

大型 Monorepo 配置 Claude Code：59API 实战指南

为什么 Monorepo 需要专门配置 Claude Code

大型 Monorepo 通常同时包含 Web、服务端、移动端、基础设施和共享包。直接让 Claude Code 扫描整个仓库，容易获得泛化建议，也会消耗更多上下文和调用额度。更有效的做法是：先用仓库级规则说明架构，再为子目录补充局部约束，并把高频编码任务交给性价比更好的模型。

59API 提供按量付费的 Claude 与 GPT 模型访问，兼容 Claude Code、Codex 及 OpenAI SDK。对于需要频繁检索、修复和重构的大型仓库，开发者可通过 https://api.59api.com 使用官方质量模型而不必绑定单一昂贵套餐；Sonnet 可负责日常开发，复杂设计或跨包重构时再切换 Opus。

第一步：连接 59API

在 59API 控制台创建 API Key 后，将下面配置写入本机 shell 配置文件，例如 ~/.zshrc。模型名称应以 59API 控制台当前提供的兼容模型 ID 为准。

export ANTHROPIC_BASE_URL=https://api.59api.com
export ANTHROPIC_AUTH_TOKEN=你的_59API_KEY
export ANTHROPIC_MODEL=claude-sonnet-4-5
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-5

重新打开终端后，在仓库根目录执行 claude，并使用 /status 确认 Claude Code 已读取目标模型和认证配置。不要把 Key 提交到 .env.example、CI 日志或仓库文档；团队自动化应从 CI 的 Secret 注入 ANTHROPIC_AUTH_TOKEN。

第二步：建立仓库级 CLAUDE.md

在根目录创建 CLAUDE.md，用短而可验证的规则替代冗长的项目介绍。Claude Code 会在开始任务时读取它，因此这里应描述依赖方向、常用命令、测试边界和禁止事项。

示例：根目录 CLAUDE.md

仓库使用 pnpm workspace 和 Turborepo。
apps/web 只能依赖 packages/ui、packages/config 和公开 API。
packages/domain 不得依赖 apps 下的任何模块。
修改共享类型后，运行 pnpm turbo run typecheck lint test。
新增接口必须同时更新 packages/api-contract。
不要修改 lockfile，除非任务明确要求新增或升级依赖。

这种规则能避免模型为了快速修复而跨层引用、复制业务逻辑或遗漏契约更新。对于生成代码的任务，可先要求 Claude Code 说明将修改哪些包，再执行实际编辑，便于控制跨包影响范围。

第三步：为高风险目录增加局部规则

根规则不应塞进所有细节。把领域约束放在相应子目录的 CLAUDE.md 中，例如 packages/payments/CLAUDE.md。进入该目录处理任务时，Claude Code 会获得更贴近当前模块的上下文。

示例：payments/CLAUDE.md

金额使用整数分，不使用浮点数。
所有退款操作必须具备幂等键。
Provider 适配器不得直接访问数据库。
修改结算逻辑后运行 pnpm --filter @repo/payments test。

将规则放在代码附近，能让支付、权限、迁移脚本等敏感区域保持独立约束，也减少每次对话中重复解释业务背景的 token 消耗。

第四步：按任务选择模型并控制范围

• 用 Haiku 处理文件定位、日志归类、批量文档整理等低风险任务。
• 用 Sonnet 处理常规缺陷修复、测试补充和单包功能开发。
• 用 Opus 处理架构评审、循环依赖排查和跨多个应用的迁移方案。
• 一次只指定一个工作区，例如“仅检查 apps/web 与 packages/ui，不要修改文件”。
• 提交前要求执行精确命令，例如 pnpm --filter @repo/web test，而不是模糊地要求“跑一下测试”。

59API 的低成本按量计费适合这类分层使用方式：简单任务不必消耗高阶模型预算，复杂任务再按需升级。注册 59API 后还可通过推荐返利进一步降低团队日常 AI 开发支出。

第五步：把验证要求写进每次任务

大型 Monorepo 最常见的问题不是代码无法生成，而是修改影响了未被检查的包。给 Claude Code 下达任务时，明确要求“先列出受影响 workspace、修改后运行 typecheck 和目标包测试、最后总结未执行的验证项”。结合 CLAUDE.md 的架构规则与 59API 的兼容接口，团队可以在保持工程约束的同时，以更可控的成本持续使用 Claude Code。

Preços · Docs