DeepSeek API 怎么接,模型怎么选?

先确认你的工具使用哪种 API 协议,再选择 V4 Flash 或 V4 Pro,最后按对应教程接入你正在使用的 Agent。

这里列的是使用 DeepSeek API 的第三方工具,不是基于 DeepSeek Harness 构建的 Agent。

要找 Harness 原生 Agent,可以前往 DSH Agent 目录。

常用 Agent 怎么接入 DeepSeek

Codex 的 DeepSeek Agent

Codex 使用 OpenAI Responses,而 DeepSeek 官方目前提供 Chat Completions 与 Anthropic Messages 兼容接口,因此通常需要 Moon Bridge 等协议桥或支持转换的切换工具。我们的指南涵盖端点、模型 ID 和常见错误。

Codex 接入 DeepSeek Agent 教程

Claude Code 的 DeepSeek Agent

Claude Code 支持自定义供应商设置。可通过 settings.json 中的环境变量指向 DeepSeek,或使用 CC Switch 进行图形化配置。

Claude Code 使用 DeepSeek API

OpenClaw 的 DeepSeek Agent

OpenClaw 在初始化时支持自定义模型供应商。指南涵盖供应商配置、Skills、MCP 以及以 DeepSeek 为模型后端的聊天平台集成。

OpenClaw DeepSeek API 指南

DeepSeek API 原生支持什么

编程 Agent 讲的协议并不一样。DeepSeek 原生兼容两套:OpenAI Chat Completions 和 Anthropic Messages。它不提供 OpenAI Responses,所以像 Codex 这类工具需要桥接层。 官方文档给出两个 base URL。把对应 SDK 或 Agent 指过去,填入 DeepSeek API Key,再选 deepseek-v4-pro 或 deepseek-v4-flash 即可。

对比项OpenAI Chat CompletionsOpenAI ResponsesAnthropic Messages
端点POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messages
主载荷messages: [{role, content}]input(字符串或 item 列表)messages + 顶层 system
鉴权Authorization: BearerAuthorization: Bearerx-api-key / ANTHROPIC_API_KEY
内容形态多为纯文本字符串带类型的 item(message、function_call、reasoning…)content blocks(type: text 等)
会话状态无状态,每次回传完整历史面向 Agent 循环与更细的 item无状态,每次回传完整历史
典型工具openai SDK、多数 OpenAI 兼容 AgentCodex CLI(只认 Responses)Claude Code、Copilot CLI(Anthropic 模式)

OpenAI Chat Completions

原生支持

对多数 OpenAI 兼容客户端几乎即插即用:改 base_url 和 api_key,继续调 /chat/completions。

https://api.deepseek.com

Anthropic Messages

原生支持

同一把 Key,走 Anthropic 形态路径。Claude Code 等工具改 ANTHROPIC_BASE_URL 就能接。

https://api.deepseek.com/anthropic

OpenAI Responses

不原生支持

没有官方 /v1/responses。Codex 等只讲 Responses 的客户端需要本地桥,例如 Moon Bridge。

需要桥接 → /guides/codex

要用 Codex 接 DeepSeek?

Codex 讲 OpenAI Responses,DeepSeek 讲 Chat Completions 和 Anthropic Messages。Moon Bridge 夹在中间:Codex → Responses → Moon Bridge → DeepSeek。

Codex + Moon Bridge 教程

V4 Flash 和 V4 Pro 怎么选?

两款模型的 API 配置方式相同,主要区别是任务难度、响应速度和长时间运行的成本。

DeepSeek V4 Flash

日常默认用它
deepseek-v4-flash

速度更快、成本更低,适合日常请求和频繁调用。

  • 快速问答、内容整理、信息提取和批量处理
  • 日常代码修改、单文件任务和较短的 Agent 流程
  • 更看重响应速度、并发量和成本的工作

可以先用 Flash。任务开始不断分支、涉及大量代码,或总是卡在复杂约束上时,再切换到 Pro。

查看完整模型介绍

DeepSeek V4 Pro

难任务再用它
deepseek-v4-pro

推理能力更强,适合大型代码工程和需要长时间推进的复杂任务。

  • 跨文件重构、架构调整和全仓库问题排查
  • 条件很多、信息不完整或需要反复验证的复杂推理
  • 需要规划、调用工具、检查结果并处理失败的长流程 Agent 任务

当完成质量比速度和成本更重要时使用 Pro;流程中的常规步骤仍可以交给 Flash。

查看完整模型介绍

找到你正在用的 Agent

进入对应教程,查看接口地址、环境变量或配置文件、模型名称,以及常见错误的处理方法。

  • AstrBot

    开源 Agent 助手,支持接入飞书、Telegram 等消息平台,可通过 Skill、插件和 MCP 扩展能力。

    查看接入教程
  • Claude Code

    运行在终端内的 AI 编程助手。

    查看接入教程
  • Cline

    运行在 VS Code 中的 AI 编程助手扩展,支持多种 API 供应商。

    查看接入教程
  • Codex

    OpenAI 的编程 Agent。

    查看接入教程
  • Crush

    华丽的开源终端 AI 编程 Agent,支持多模型与 LSP 集成。

    查看接入教程
  • Deep Code

    开源终端 AI 编程助手,专为 DeepSeek-V4 适配,支持深度思考、推理强度控制与 Agent Skills。

    查看接入教程
  • DeepSeek-TUI

    面向 DeepSeek-V4 的开源 Rust 终端编程助手 — Codex 风格架构,沙箱化工具执行,内置 MCP 客户端与服务器,支持 100 万 token 上下文。

    查看接入教程
  • GitHub Copilot

    内置于 VS Code 的 AI 编程助手。

    查看接入教程
  • GitHub Copilot CLI

    终端原生的 AI 编程助手,支持 Agent 能力。

    查看接入教程
  • Hermes

    开源自我进化 AI 助手。

    查看接入教程
  • Kilo Code

    支持 CLI 和编辑器扩展的 AI 编程助手。

    查看接入教程
  • Langcli

    100% 兼容 Claude Code、支持 DeepSeek V4 等主流 LLM 模型的开源 AI 编程助手。

    查看接入教程
  • LobeHub

    Chief Agent Operator — 通过招聘、排班并报告整个 AI 团队,将 Agent 组织成 7×24 小时运作。

    查看接入教程
  • nanobot

    开源轻量级 AI 智能体,支持接入聊天工具、记忆、MCP 等。

    查看接入教程
  • Oh My Pi

    基于 Pi 分支扩展的终端 AI 编程 Agent,提供 OMP 专用工具、模型角色、MCP、插件与 Agent 工作流。

    查看接入教程
  • OpenClaw

    开源个人 AI 助手,可接入飞书、微信等聊天工具,并通过 Skill 扩展能力。

    查看接入教程
  • OpenCode

    开源 AI 编程助手,提供终端、网页等多种运行形式。

    查看接入教程
  • Pi

    极简且高度可扩展的终端编码框架,支持树状会话和自定义供应商。

    查看接入教程
  • Qwen Code

    阿里巴巴通义千问团队推出的 Coding Agent CLI,现已全面支持 DeepSeek 提供商。

    查看接入教程
  • Reasonix

    运行在终端内的 DeepSeek 原生编程 Agent — Cache-First 循环,原生支持 MCP。

    查看接入教程
  • WorkBuddy / CodeBuddy

    支持自定义 OpenAI 兼容模型配置的 AI Agent 与编程助手。

    查看接入教程

DeepSeek Agent 与 ChatGPT、Claude、Gemini 的区别

ChatGPT、Claude 和 Gemini 是强大的通用助手。DeepSeek Agent 是另一种思路:保留编程 Agent 外壳(Codex、Claude Code、OpenClaw 等),用 DeepSeek API 作为模型后端。当你需要 Agent 工作流而非单纯聊天,且希望降低 API 成本时,这一点很重要。

平台Agent 支持编程 Agent API典型成本
DeepSeek Agent支持 Codex、Claude Code、OpenClaw 等 20+ Agent兼容 OpenAI Chat Completions 的 DeepSeek API免费额度 / 较低 API 定价
ChatGPT / Codex(默认)Codex、Copilot CLI(仅 OpenAI 模型)OpenAI API — 按量计费订阅 + API 费用
Claude(默认)Claude Code(仅 Anthropic 模型)Anthropic API — 按量计费Pro 套餐 + API 费用
Gemini(默认)Agent 工具支持有限Google AI API免费层 + 付费层

接入前常见问题

修改 API 配置之前,先确认这些问题。

DeepSeek 原生支持哪些 API 协议?

+
DeepSeek 原生支持 OpenAI Chat Completions(https://api.deepseek.com)和 Anthropic Messages(https://api.deepseek.com/anthropic)。它不提供官方的 OpenAI Responses(/v1/responses)。像 Codex CLI 这类只讲 Responses 的工具,需要 Moon Bridge 等桥接层。

DeepSeek 支持 OpenAI Responses API 吗?

+
不支持。DeepSeek 没有官方 /v1/responses 端点。请直接使用 Chat Completions 或 Anthropic Messages;若客户端只认 Responses(例如 Codex),需要本地协议桥把请求转换成 DeepSeek 能理解的格式。

Codex 可以使用 DeepSeek API 吗?

+
实际使用中,许多 Codex 配置通过 OpenAI 兼容转发层或切换工具路由请求,而不是单一官方开关。若你的 Codex 栈支持自定义 OpenAI 兼容端点,我们的 Codex 指南涵盖 Moon Bridge、CC Switch 和手动配置路径。

Claude Code 可以使用 DeepSeek API 吗?

+
可以。在 Claude Code 设置中配置正确的环境变量和 base URL,或通过 CC Switch 进行图形化设置。详见我们的 Claude Code 指南,含具体字段和常见故障排查。

DeepSeek 适合 AI 编程 Agent 吗?

+
许多开发者选择 DeepSeek 驱动编程 Agent,因为 API 兼容 OpenAI Chat Completions、定价相对较低,且模型在代码和推理任务上表现不错。注意,这不等于支持 OpenAI Responses;效果仍取决于 Agent 工具、协议、提示词和具体任务——建议先在你的栈里跑一个小型真实任务。

DeepSeek V4 Flash 和 V4 Pro 应该选哪个?

+
日常编程、内容整理、批量处理和较短的 Agent 任务先用 V4 Flash。跨文件或全仓库改造、复杂推理,以及需要持续调用工具的长任务,再使用 V4 Pro。

DeepSeek 官方资源

在官方平台创建 API Key,并通过 API 文档确认当前可用的模型和参数。