DeepSeek Claude Code integration：官方 ANTHROPIC_BASE_URL V4 配置

DeepSeek 在 deepseek-ai 组织下发布了新的官方 GitHub 仓库：awesome-deepseek-agent。这不是模型发布，也不是论文——而是一份精心整理的集成手册，涵盖 20 款 coding 工具，每款工具都有专属指南，说明如何将其 API 客户端指向 DeepSeek V4 Pro 和 V4 Flash。对于负责管理多 provider 路由策略的团队来说，这是 DeepSeek 首次为整个 coding agent 生态发布由官方维护的标准配置。

如果你的团队使用 Claude Code、GitHub Copilot Chat、OpenCode、Cline 或 Codex，现在有了官方参考，可以获取准确的 model ID 和环境变量来重定向流量。而在此之前，团队只能在 YouTube 教程、Medium 文章和论坛帖子中拼凑出互相矛盾的配置写法。

DeepSeek 发布了什么

该仓库涵盖 20 款工具，包括：

• Claude Code — 终端和 VS Code 扩展版本均有覆盖
• GitHub Copilot（通过 Vizards VS Code 扩展将 DeepSeek V4 注入模型选择器）
• OpenCode — 开源终端 coding agent，支持 OpenAI 和 Anthropic 双协议
• Cline — VS Code 多 provider coding 助手
• Codex — OpenAI 的 coding agent
• DeepSeek-TUI — Rust 终端助手，Codex 风格架构，支持 MCP、沙盒工具和 1M context
• LangCLI — 与 Claude Code 完全兼容的 CLI，支持主流 LLM
• AstrBot — 面向飞书/Telegram 的开源 agent，支持 skill 和 MCP 扩展
• Cherry Studio、LobeHub、nanobot、Kilo Code 等众多工具

每份指南都是简短的 Markdown 文件，提供英文和简体中文版本，包含向 DeepSeek API 认证并按角色选择正确模型所需的全部配置。

团队普遍忽视的 DeepSeek V4 路由配置

仓库中的 Claude Code 指南揭示了一个对路由运营商至关重要的细节：DeepSeek 将 Anthropic 的三层模型层级（Opus / Sonnet / Haiku）按角色映射到两个 V4 模型。官方推荐的 ~/.claude/settings.json 配置如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "***",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

关键决策在于 CLAUDE_CODE_SUBAGENT_MODEL 将 sub-agent 工作映射到 V4 Flash 而非 V4 Pro。Sub-agent 负责工具调用和并行化的后台任务，在长时间 session 中数量增长最快。将其映射到更低成本的模型，可以在不降低主推理质量的前提下，有效控制长 session 的尾部成本。

这是一种路由策略模式，而不仅仅是配置步骤。设计 provider failover 或多 provider 成本控制方案的团队可以复用同样的角色-模型映射逻辑：编排调用路由到高能力模型，执行子调用路由到性价比高的模型，与使用哪个 agent 框架无关。

对 AI 工程团队的核心价值

awesome-deepseek-agent 仓库为工程团队解决了三个长期痛点：

1. 官方 model ID，不再依赖社区猜测。 此前团队需要从 YouTube 教程、Medium 文章和论坛帖子中自行整合互相矛盾的环境变量写法。deepseek-ai 组织现在是权威来源，且保证持续维护。

2. Anthropic 兼容路由是正式支持的路径，而非 hack。 DeepSeek 的 Anthropic 兼容端点 api.deepseek.com/anthropic 在官方文档中被定位为 Claude Code 用户的首选路径。它原生支持 ANTHROPIC_BASE_URL 覆盖，这与路由网关拦截和重定向请求的机制完全一致。

3. Sub-agent 成本控制正式进入文档体系。 ANTHROPIC_DEFAULT_HAIKU_MODEL 与 CLAUDE_CODE_SUBAGENT_MODEL 的分离配置现在在官方文档中有明确说明。尚未按 agent 角色区分定价层级的团队，终于有了可靠的参考依据。

Router/Operator 视角：需要特别注意的问题

对于在多个 provider 前部署路由网关的团队——根据成本、延迟或任务类型将部分请求发往 Anthropic Claude Fable 5、另一部分发往 DeepSeek V4——awesome-deepseek-agent 仓库带来了一个实际的技术问题：凭证与端点隔离。

Claude Code 从环境变量读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。如果你通过一个呈现 Anthropic 兼容 API 界面的网关路由请求，这些变量同样会被传递给网关。因此必须确认你的网关能够正确处理以下三点：

• 正确转发 ANTHROPIC_MODEL header 或通过路由规则进行映射，确保目标 model ID 能到达正确的 upstream provider。
• 在账单层准确记录 model ID——deepseek-v4-pro[1m] 中的 [1m] context 后缀是 DeepSeek 专有修饰符，可能需要在计费对账时进行去除或标准化处理。
• 如果 sub-agent 发起独立的 API 调用，正确处理 CLAUDE_CODE_SUBAGENT_MODEL 的请求流。在某些网关配置中，sub-agent 调用会绕过网关直接访问 provider 端点，导致路由统计和计费出现偏差。

如果你的团队正在评估将 DeepSeek V4 作为 coding agent 流量的低成本 fallback，该仓库的配置提供了准确的测试基准。将 Anthropic 兼容端点映射到网关的 provider 配置，对 Claude Code 进行测试，并验证请求日志显示编排调用使用 V4 Pro、sub-agent 调用使用 V4 Flash。TheRouter 的 provider 路由文档 介绍了如何跨 provider 定义按角色的模型策略。

值得关注的三个动态

• Model ID 弃用窗口期：deepseek-chat 和 deepseek-reasoner 将于 2026 年 7 月 24 日退役。任何仍引用旧名称而非 deepseek-v4-pro 或 deepseek-v4-flash 的路由配置届时都将失效。awesome-deepseek-agent 仓库中的所有配置均已更新为新名称。参阅我们此前关于 DeepSeek V4 迁移截止日期 的深度报道，了解完整的弃用时间表和 fallback 策略检查清单。
• 通过扩展实现的 GitHub Copilot 集成：Copilot 指南使用的是第三方 VS Code 扩展（Vizards），而非 Copilot 官方 API 集成。有严格扩展管理策略的团队在部署前应评估该扩展的数据处理方式及隐私合规性。
• Context 后缀行为：deepseek-v4-pro[1m] 中的 [1m] 后缀会激活 100 万 token 的上下文窗口。不带后缀时，默认较小的上下文窗口生效。对于长 session 的 coding agent，这一区别会直接影响成本和截断行为，需要在路由规则中加以考量。

awesome-deepseek-agent 仓库是首个集中化的 DeepSeek coding agent 集成配置官方来源，且由 deepseek-ai 官方组织持续维护。建议将其加入团队的 provider 迁移检查清单，在任何涉及 DeepSeek V4 的路由策略变更之前优先查阅。