国产模型接入教程
OpenCode · 模型接入

选择模型供应商

下方展示当前供应商的完整配置,切换后查看对应方案。

配置实操 / macOS · Linux · Windows

OpenCode 接入 DeepSeek

使用内置供应商,通过 /connect 认证、/models 选择模型。

5 个步骤约 9 分钟文档核对 2026-10-29
开始第一步
接入配置示意内置供应商
OpenCodeDeepSeek
MODEL
从 DeepSeek 模型列表选择
BASE URL
内置 DeepSeek Provider,无需手写
AUTH
DeepSeek 平台 API Key
已安装客户端 模型权限与额度 原配置已备份

配置速查

接口与凭据必须对应同一方案
阶段操作核对
连接/connect → DeepSeek选择直接供应商
认证输入平台 Key在凭据输入框填写
模型/models选择 DeepSeek 模型
01

安装兼容版本

从 OpenCode 官方安装文档选择对应系统方式。DeepSeek 文档核对时建议版本至少 v1.18.30;先确认 opencode --version。

按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。

终端
opencode --version
# 在测试项目目录中启动
opencode
02

连接内置供应商

在 OpenCode 输入 /connect,搜索并选择 DeepSeek,在凭据输入位置填写平台 Key。不要误选聚合渠道,计费方和请求路径会不同。

官方文档说明凭据保存在 ~/.local/share/opencode/auth.json,不要提交。第一轮无需自建代理。

OpenCode 内操作(不是 Shell 命令)
/connect
# 选择 DeepSeek 并在凭据输入框填写 Key
/models
# 选择 DeepSeek 供应商下的可用模型
03

选择模型

DeepSeek 官方接入教程核对时选择 DeepSeek-V4-Flash。列表与教程不同时先检查版本和当前支持,不能猜显示名写进配置。确认默认模型没有被旧项目配置改回其他供应商。

04

只读任务验收

逐条打开引用文件,核对启动和测试命令,并到平台核对调用。通过后再让 Agent 提出一处小修改的计划。

复制到 OpenCode
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。
05

回退与常见问题

供应商或模型不出现先更新客户端,再查 /connect 和 /models。聊天可用但读取失败,检查工作目录和授权。切换前记录原供应商、模型与相关配置,恢复后重跑相同任务。

TROUBLESHOOTING

卡在哪一步?按错误定位。

401 / 403

凭据、套餐或模型权限不匹配

检查 Key 来源、地域和套餐;检查当前进程是否读取了旧认证。

404

地址或 API 协议不匹配

使用本文对应协议的 Base URL,不手工追加请求路径。

429

额度或调用频率限制

到供应商控制台核对余额、套餐与限流,降低并发后重试。

工具调用失败

文件权限、客户端版本或模型兼容性问题

先确认工作目录,验证一次只读文件任务,再增加其他能力。

完成前,确认这四项

  • 客户端版本可用,原配置已备份
  • 接口地址、Key 和模型属于同一产品方案
  • 只读任务引用了真实文件,并已核对调用用量
  • 没有提交真实 Key,能够还原原配置

官方参考来源

配置依据以下资料整理,验证任务与排查顺序为本站编辑建议。模型和客户端更新后,请重新核对接口与支持范围。

01https://api-docs.deepseek.com/quick_start/agent_integrations/opencode/02https://opencode.ai/docs/providers/03https://opencode.ai/docs/
查看其他工具的接入方式