选择模型供应商
下方展示当前供应商的完整配置,切换后查看对应方案。
OpenCode
DeepSeek
- 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
# 在测试项目目录中启动
opencode02
连接内置供应商
在 OpenCode 输入 /connect,搜索并选择 DeepSeek,在凭据输入位置填写平台 Key。不要误选聚合渠道,计费方和请求路径会不同。
官方文档说明凭据保存在 ~/.local/share/opencode/auth.json,不要提交。第一轮无需自建代理。
/connect
# 选择 DeepSeek 并在凭据输入框填写 Key
/models
# 选择 DeepSeek 供应商下的可用模型03
选择模型
DeepSeek 官方接入教程核对时选择 DeepSeek-V4-Flash。列表与教程不同时先检查版本和当前支持,不能猜显示名写进配置。确认默认模型没有被旧项目配置改回其他供应商。
04
只读任务验收
逐条打开引用文件,核对启动和测试命令,并到平台核对调用。通过后再让 Agent 提出一处小修改的计划。
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。05
回退与常见问题
供应商或模型不出现先更新客户端,再查 /connect 和 /models。聊天可用但读取失败,检查工作目录和授权。切换前记录原供应商、模型与相关配置,恢复后重跑相同任务。
卡在哪一步?按错误定位。
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/