Awesome DeepSeek Agent：16 款主流 AI 编程助手接入 DeepSeek 模型完整指南

阅读本文后，你将了解：

• awesome-deepseek-agent 仓库覆盖了哪些工具，它们各自适合什么场景
• Anthropic 兼容 API、OpenAI 兼容 API、模型直连三种接入模式的区别与适用工具
• Claude Code、Deep Code、Reasonix 等核心工具的具体配置步骤
• 如何根据自身需求选择合适的接入工具和模式

目录

• 1. 项目概览
• 2. 三种接入模式
• 3. 16 款工具全景图
• 4. Anthropic 兼容模式详解
• 5. OpenAI 兼容模式详解
• 6. 模型直连模式详解
• 7. 选型建议
• 8. 成本参考
• 9. 常见问题
• 10. 官方资源

1. 项目概览

awesome-deepseek-agent 是 DeepSeek 官方维护的精选指南仓库，每款工具对应一份独立的 docs/<tool-name>.md 文档，涵盖安装、配置和首次运行三个步骤。文档提供英文和简体中文两个版本（docs/<tool-name>.zh-CN.md），由 DeepSeek 团队持续更新。

仓库的目标读者是已经在使用 DeepSeek 模型、希望将它接入日常编程工具链的开发者。如果你还没有 DeepSeek API Key，需要先到 platform.deepseek.com/api_keys 申请。

2. 三种接入模式

16 款工具的接入方式各异，但底层依赖的 API 协议只有三种。理解这三种模式，就能快速判断任意工具的接入路径：

为什么需要区分模式？ 因为不同工具最初对接的 API 协议不同。Claude Code 天然对接 Anthropic 协议，所以 DeepSeek 提供了 Anthropic 兼容端点来适配；大多数开源工具走 OpenAI 协议，DeepSeek 同样兼容；而 Reasonix、Deep Code 这类专为 DeepSeek 打造的工具则直接调用原生 API，省去了协议转换的开销。

选工具时，先确认它支持哪种协议，再对照上表找到对应的配置方式。

3. 16 款工具全景图

编程助手类

终端 Agent 类

跨平台 Agent 类

其他

4. Anthropic 兼容模式详解

Anthropic 兼容模式适用于那些原本对接 Anthropic /v1/messages 接口的工具。DeepSeek 在 https://api.deepseek.com/anthropic 部署了一个协议适配层，让这些工具可以零改动切换到 DeepSeek 模型。

Claude Code 配置

Claude Code 是这一模式下最典型的工具。安装后，通过环境变量将请求指向 DeepSeek：

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 配置环境变量（指向 DeepSeek Anthropic 兼容端点）
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

这里有几个要点：

• deepseek-v4-pro[1m] 中的 [1m] 后缀表示使用 100 万 token 上下文窗口的变体。Opus 和 Sonnet 角色都映射到 deepseek-v4-pro，Haiku 和 Subagent 角色映射到 deepseek-v4-flash，这样可以在主任务中追求质量，在子任务中控制成本。
• CLAUDE_CODE_EFFORT_LEVEL=max 将推理力度拉满，充分利用 DeepSeek-V4-Pro 的推理能力。

GitHub Copilot CLI 配置

Copilot CLI 同样通过 Anthropic 兼容端点接入。注意必须将 COPILOT_PROVIDER_TYPE 设为 anthropic，如果设为 openai 会触发 400 错误——原因是 DeepSeek 要求 reasoning_content 在多轮对话中原样回传，而 Copilot CLI 的 OpenAI 集成不支持这个行为。

export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://api.deepseek.com/anthropic
export COPILOT_PROVIDER_API_KEY=sk-your-deepseek-api-key
export COPILOT_MODEL=deepseek-v4-pro

5. OpenAI 兼容模式详解

这是覆盖工具最多的一种模式。将 BASE_URL 设为 https://api.deepseek.com，填入 API Key，工具就能通过标准的 OpenAI Chat Completions 协议调用 DeepSeek 模型。

WorkBuddy / CodeBuddy 配置

WorkBuddy 通过 ~/.codebuddy/models.json（用户级）或 .codebuddy/models.json（项目级）配置模型，可以精细控制 token 上限、是否支持工具调用和图片等：

{
  "models": {
    "deepseek-v4-pro": {
      "apiBase": "https://api.deepseek.com/v1/chat/completions",
      "apiKey": "<your DeepSeek API Key>",
      "maxInputTokens": 128000,
      "maxOutputTokens": 32000,
      "supportsToolCall": true,
      "supportsImages": false
    }
  }
}

Oh My Pi 的兼容性要点

Oh My Pi 的配置文档中标注了三个关键的兼容性字段，这些字段对其他走 OpenAI 兼容模式的工具同样有参考价值：

如果你在接入过程中遇到工具调用相关的错误，检查这三项配置往往能定位问题。

6. 模型直连模式详解

直连模式的工具内置了对 DeepSeek 的支持，不需要手动配置 API 端点或协议。它们通常在首次运行时提供交互式引导，选择 DeepSeek 作为 Provider 后自动完成配置。

Deep Code 配置

Deep Code 是专为 DeepSeek-V4 打造的终端编程助手，配置存储在 ~/.deepcode/settings.json：

{
  "env": {
    "MODEL": "deepseek-v4-pro",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "sk-..."
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max",
  "webSearchTool": true
}

核心配置项一览：

Deep Code 支持 Agent Skills 扩展机制，Skills 存放在 ~/.agents/skills/<name>/SKILL.md（用户级）或 ./.deepcode/skills/<name>/SKILL.md（项目级），通过 / 命令调起技能选择器。这与 OpenClaw 的 Skills 机制类似——Agent Skills 正在成为 AI 编程助手扩展的主流范式。

Reasonix 配置

Reasonix 是 DeepSeek 原生终端 Agent，无需全局安装：

npx reasonix code

首次运行时，Reasonix 会启动交互式向导，将配置持久化到 ~/.reasonix/config.json。它有几个设计决策值得关注：

• 默认使用 Flash 模型控制成本。日常编码任务走 deepseek-v4-flash，只在需要深度推理时通过 /pro 命令切换到 Pro 模型（仅下一轮生效），或通过 /preset max 让整个会话都使用 Pro。
• 缓存优先循环。自动利用 DeepSeek API 的缓存机制，减少重复 token 的计费。
• 自动修复工具调用。当模型的工具调用格式出错时，Reasonix 会自动修复而非报错中断。

Reasonix 需要 Node.js 20.10+。

OpenClaw 和 AstrBot

OpenClaw 和 AstrBot 都在各自的设置向导中将 DeepSeek 列为内置 Provider，不需要手动填写 API 端点。OpenClaw 提供 openclaw dashboard（Web UI）、openclaw tui（终端 UI）和 openclaw terminal（终端聊天）三种入口；AstrBot 支持 Docker 部署（docker compose up -d），Web UI 位于 http://localhost:6185。

7. 选型建议

面对 16 款工具，选择的核心逻辑是：先看你的工具链，再看接入模式，最后看附加能力。

按使用场景选择

按接入难度排序

从低到高（主观评估）：

1. Reasonix — npx reasonix code 一行命令启动，向导完成配置
2. Deep Code — npm install 后配置 settings.json，字段直观
3. Claude Code — 需要理解环境变量映射关系，但文档给出完整示例
4. OpenClaw / AstrBot — 向导式配置，但涉及消息平台的额外设置
5. WorkBuddy / Pi / Crush — 需要手动编写 JSON 配置文件

8. 成本参考

DeepSeek-V4 系列的 API 定价（来自 Pi 工具文档中记录的数据）：

Flash 模型的输入价格只有 Pro 的 8%，日常编码任务优先使用 Flash 是控制成本的有效手段。Reasonix 默认使用 Flash、需要时才切 Pro 的设计，正是基于这个价差。

定价可能有调整，以 DeepSeek 官方定价页 为准。

9. 常见问题

Q：设置环境变量后 Claude Code 报认证错误

确认 ANTHROPIC_AUTH_TOKEN（不是 ANTHROPIC_API_KEY）填的是 DeepSeek API Key，且没有多余的引号或空格。可以在终端运行 echo $ANTHROPIC_AUTH_TOKEN 检查实际值。

Q：Copilot CLI 设为 openai 类型后报 400 错误

这是预期行为。DeepSeek 要求多轮对话中的 reasoning_content 被原样回传，Copilot CLI 的 OpenAI 集成不处理这个字段。将 COPILOT_PROVIDER_TYPE 改为 anthropic 即可。

Q：工具调用（Tool Call）报错或不生效

检查配置中是否有类似 Oh My Pi 文档中提到的三个兼容性字段。尤其是 tool_choice 参数——DeepSeek V4 的思考模式不支持该参数，如果你的工具强制发送了这个参数，需要关闭对应选项。

Q：应该选 Pro 还是 Flash？

简单规则：需要深度推理（架构设计、复杂 bug 分析）用 Pro，日常补全、简单重构、文档编写用 Flash。Reasonix 的 /pro 命令提供了按需切换的能力，推荐先用 Flash，遇到瓶颈时再切 Pro。

Q：Anthropic 兼容端点和 OpenAI 兼容端点有什么区别？

两个端点都指向 DeepSeek 的同一组模型，区别在于请求/响应的协议格式。Anthropic 兼容端点（/anthropic）遵循 Anthropic Messages API 格式，OpenAI 兼容端点遵循 OpenAI Chat Completions 格式。选哪个取决于你的工具原生支持哪种协议，功能上没有差异。

10. 官方资源

• DeepSeek API Key 申请：platform.deepseek.com/api_keys
• DeepSeek API 文档：api-docs.deepseek.com
• 仓库地址：github.com/deepseek-ai/awesome-deepseek-agent
• DeepSeek 官方定价：platform.deepseek.com