註冊送額度
繁體中文

OpenCode

OpenCode 接入 DeepSeek：最新 API、模型與故障排查

OpenCode 是一个可在终端、桌面端和网页中使用的开源编程 Agent。它内置 DeepSeek Provider，因此最新版 OpenCode 可以直接调用 DeepSeek，不需要额外搭建 Responses API 桥。

准备工作

  • OpenCode v1.14.24 或更高版本。
  • 一枚兼容 DeepSeek 的 API Key。
  • 日常快速编程使用 deepseek-v4-flash，复杂全仓任务使用 deepseek-v4-pro。

1. 安装或升级 OpenCode

前往 OpenCode 下载页面 安装最新版，然后确认版本：

opencode --version

排查 Provider 错误前应先升级。旧版本可能无法识别当前 DeepSeek V4 模型 ID 或推理字段。

2. 将 OpenCode 接入 DeepSeek

  1. 在项目目录运行 opencode。
  2. 输入 /connect。
  3. 搜索 deepseek，选择内置 DeepSeek Provider。
  4. 粘贴兼容 DeepSeek 的 API Key。
  5. 选择 deepseek-v4-flash 或 deepseek-v4-pro。

OpenCode 会把 Provider 凭据保存在本地。不要把 API Key 写进仓库文件，更不要提交到 Git。

3. DeepSeek V4 Flash 和 Pro 怎么选

模型适合场景取舍
deepseek-v4-flash快速修复、代码搜索、解释、重复编辑成本和延迟更低，推理上限较低
deepseek-v4-pro跨文件重构、调试、架构、长程 Agent推理更强，但更慢、成本更高

建议先用 Flash。只有任务需要更深规划，或者 Flash 反复违反同一个约束时，再切换到 Pro。

4. 使用自己的 DeepSeek 兼容 API

如果你的 API 服务提供 OpenAI Chat Completions 格式，可以在 OpenCode 中把它添加为自定义 OpenAI 兼容 Provider：

API 类型：OpenAI-compatible / Chat Completions
Base URL：https://your-api.example/v1
API Key：你的服务商 Key
模型：deepseek-v4-flash 或 deepseek-v4-pro

该 Base URL 最终必须提供 /chat/completions。这套 OpenCode 配置不需要 OpenAI Responses。

5. 验证连接

打开一个小型仓库，先执行边界清晰的任务：

读取 package.json，找出测试命令，并解释你准备运行什么。
暂时不要修改文件。

能正常返回，说明认证、模型路由和基础工具访问已经工作。之后再测试一次文件编辑和终端命令，确认无误后再运行长程 Agent。

OpenCode 接入 DeepSeek 常见问题

找不到 Provider 或模型

先升级 OpenCode，重新连接 Provider，并使用当前准确的模型 ID。如果 Provider 已明确列出 V4 模型，不要继续使用旧别名。

401 认证错误

重新创建 API Key，检查是否复制了空格，并确认 Key 与当前 Base URL 属于同一个服务。

404 端点错误

确认服务商是否要求 Base URL 以 /v1 结尾。最终请求必须到达 /chat/completions；不要把这套 OpenCode 配置指向 /v1/responses。

第二轮开始推理或工具调用失败

先升级 OpenCode。DeepSeek 思考模型可能要求下一轮回传推理状态，旧版 Provider 集成可能丢失该字段。如果内置 Provider 仍失败，可以先用 Flash 的非思考模式测试，以缩小问题范围。

OpenCode DeepSeek FAQ

OpenCode 支持 DeepSeek 吗？

支持。当前 OpenCode 已内置 DeepSeek Provider。输入 /connect，选择 DeepSeek，粘贴 API Key，再选择当前 V4 模型即可。

OpenCode 应该用哪个 DeepSeek 模型？

高频编程和快速编辑使用 DeepSeek V4 Flash；复杂调试、跨文件重构和长程 Agent 任务使用 DeepSeek V4 Pro。

OpenCode 接 DeepSeek 需要 Responses API 吗？

不需要。OpenCode 可以通过内置 Provider 或 OpenAI 兼容的 Chat Completions 端点使用 DeepSeek。Codex 等只认 Responses 的客户端才需要协议桥。

OpenCode 可以使用我们自己的 DeepSeek 兼容 API 吗？

可以。将其添加为自定义 OpenAI 兼容 Provider，填写 Base URL、API Key 和可用的 DeepSeek 模型 ID。该端点需要实现 Chat Completions 与工具调用。