前置条件
- 1已注册 DeepSeek 账号
- 2电脑能联网
OpenCode 接入 DeepSeek 完整指南
本教程教你把国产 AI「DeepSeek」接到 OpenCode 这个工具里，接好之后就能直接和 AI 聊天、让它帮你写代码、解释文档。DeepSeek 是国产模型，国内直接访问不用梯子、价格还很便宜，对国内用户特别友好。
OpenCode 接入 DeepSeek 有两种方式，选一种就行：
| 方式 A：应用端交互接入 | 方式 B：配置文件手动接入 | |
|---|---|---|
| 适合谁 | 完全不懂代码的新手 | 看得懂 JSON、喜欢自己改配置的进阶用户 |
| 怎么操作 | 在 OpenCode 界面里用 /connect 点点选选 | 手动编辑 opencode.json 配置文件 |
| 要不要写代码 | 不用，全程复制粘贴 + 回车 | 要写一小段 JSON 配置 |
| 推荐度 | ⭐⭐⭐⭐⭐（新手首选） | ⭐⭐⭐（进阶可选） |
提示
小白提示: 如果你不确定选哪个，就选方式 A。本教程提到的「终端」，就是你电脑里那个黑底白字、用来输入命令的窗口。方式 A 只需要复制粘贴一条命令，其余都在 OpenCode 自己的界面里完成。
前置准备
不管选哪种方式，都需要这两样东西：
- 一个 DeepSeek 账号（手机号或微信注册即可）
- 电脑能上网（国内直连，不用梯子）
步骤一：装好 OpenCode
OpenCode 是个免费工具，先把它装到电脑上。
1. 打开终端
- Windows 用户：按键盘上的
Win + R，在弹出的小窗口里输入cmd，然后回车，会弹出黑色的命令窗口。 - Mac 用户：按
Command + 空格，输入「终端」三个字，回车打开。
2. 复制下面这一行命令，粘贴到终端里，按回车
1curl -fsSL https://opencode.ai/install | bash提示
这行命令的意思是「从 OpenCode 官网把安装包下载并装好」。整个过程会自动完成，期间屏幕会滚动一些文字，那是正常现象，等它停下来、出现新的输入提示符就好了。
3. 启动 OpenCode
装好之后，在终端里输入下面这个词并回车：
1opencode你会看到一个蓝紫色的全屏界面，这就是 OpenCode 的「主页」，下面所有操作都在这里完成。
步骤二：领一个 DeepSeek 的「通行证」
OpenCode 只是个「壳」，它本身没有 AI，需要你给它配一个 AI 来源。我们用 DeepSeek，但要先去 DeepSeek 开放平台领一张「通行证」（专业说法叫 API Key，你可以理解成一张门禁卡）。
1. 打开 DeepSeek 开放平台
在浏览器里访问：https://platform.deepseek.com
用手机号或微信登录。第一次进去会让你同意服务条款，点同意即可。
2. 充点钱（新用户通常有免费额度）
DeepSeek 是按用量付费的，价格很便宜（一杯奶茶钱能用很久）。新用户一般会送一点免费额度，先不充值也能跑通流程；用完后再点「充值」充个 10 块钱就够用很久了。
3. 创建通行证
- 点左侧菜单的 「API Keys」（或「API 管理」）
- 点击 「创建 API key」 按钮
- 给它起个名字（随便填，比如「opencode」），点确认
- 页面会显示一串以
sk-开头的长字符串，这就是你的通行证
4. 复制通行证
点通行证旁边的「复制」按钮（或手动选中复制），把它存到记事本里备用。
警告
⚠️ 重要: 这张通行证相当于你 DeepSeek 账户的钥匙，千万不要发到群里、不要传到 GitHub、不要截图发朋友圈。万一泄露了，回到 DeepSeek 平台把它删掉重新生成一张就行。
步骤三：接入 DeepSeek
从这里开始，方式 A 和方式 B 分开走，选一种跟着做即可。
方式 A：应用端交互接入（推荐新手）
回到刚才 OpenCode 的全屏界面，我们要告诉它「我要用 DeepSeek」。DeepSeek 是 OpenCode 原生支持的供应商，所以这一路最顺。
A1. 输入 /connect 命令
在 OpenCode 最下方的输入框里（看起来像个长条输入区域），输入这一行：
/connect
然后按回车。
A2. 在弹出的列表里选 DeepSeek
回车后，屏幕中间会弹出一个列表，里面是一排 AI 来源的名字（Anthropic、OpenAI、Google、DeepSeek 等）。操作方式：
- 用键盘的 ↑ ↓ 方向键上下移动，让高亮条停在 DeepSeek 上
- 按 回车 确认选择
A3. 粘贴通行证
屏幕会变成一个输入框，提示你输入 API key：
- 按
Ctrl + V（Mac 是Command + V）把刚才存的通行证粘进去 - 按 回车 确认
A4. 看到成功提示
屏幕出现 Successfully authenticated（认证成功）字样，就说明 DeepSeek 已经成功加进来了！
提示
小白提示: OpenCode 会自动把这张通行证存到你自己电脑的一个文件里（位置在 ~/.local/share/opencode/auth.json），以后再打开 OpenCode 不用重新连，直接能用。这个文件是你的私人物品，别上传给别人。
方式 B：配置文件手动接入（进阶）
如果你更喜欢直接改配置文件，可以跳过 /connect，手动编辑 OpenCode 的配置。
B1. 找到（或新建）配置文件
OpenCode 的配置文件叫 opencode.json，一般放在项目根目录或用户目录下。如果没有就新建一个。
B2. 写入 DeepSeek 提供商配置
打开 opencode.json，加入下面这段（把 你的-api-key 换成步骤二领到的通行证）：
1{
2 "providers": {
3 "deepseek": {
4 "apiKey": "你的-api-key",
5 "baseURL": "https://api.deepseek.com/v1",
6 "models": ["deepseek-chat", "deepseek-reasoner"],
7 "defaultModel": "deepseek-chat"
8 }
9 },
10 "defaultProvider": "deepseek"
11}关键字段含义：
apiKey：步骤二领到的通行证（sk- 开头）baseURL：DeepSeek 的 API 地址（注意要带/v1，少了会报 404）models：你要用的模型列表defaultModel：默认用哪个模型defaultProvider：默认用哪个来源（这里设成 deepseek）
警告
⚠️ 重要: apiKey 写进配置文件后，这个文件就含敏感信息了。务必把它加进 .gitignore，别提交到代码仓库。生产环境建议改用环境变量 DEEPSEEK_API_KEY 引用，而不是明文写死。
B3. 启动 OpenCode 验证配置生效
保存配置文件后，在终端启动 OpenCode：
1opencode如果配置写对了，启动后顶部会显示当前来源是 deepseek/deepseek-...，说明配置已生效。
步骤四：挑一个 DeepSeek 模型
DeepSeek 不止一个型号，我们要挑一个开始用。
方式 A 用户：用 /models 命令交互选
在 OpenCode 输入框里输入：
/models
回车后会弹出模型列表，新手建议这样选：
- 先选
deepseek-chat：就是 DeepSeek-V3，速度快、便宜，先跑通流程用它最合适 - 要做数学、逻辑推理等复杂题时，再换
deepseek-reasoner（即 DeepSeek-R1，更会思考但慢一些、贵一些）
操作方式：方向键移动 → 回车确认。
方式 B 用户：在配置文件里指定
方式 B 的模型在步骤三 B2 的 defaultModel 字段里已经指定好了，启动 OpenCode 即用，不用再选。想换模型时，改 defaultModel 的值，保存重启即可。
步骤五：发条消息试试
现在一切就绪，发一条消息验证 AI 是否真的能回你。
1. 在输入框打字
在最下面的输入框里打字（就像用微信一样），比如：
你好，请用一句话介绍你自己
2. 按回车发送
按 回车 发送。
3. 查看 AI 回复
如果 DeepSeek 正常返回了一段自我介绍，恭喜你，接入成功！ 🎉
你也可以看 OpenCode 界面顶部，当前用的模型会显示成 deepseek/deepseek-chat，证明现在和你聊天的是 DeepSeek。
场景应用示例
接好之后能干啥？下面是几个常见用法，直接把提示词复制到 OpenCode 输入框发出去就行。
场景1：让 AI 帮你写代码
把这段发给 AI：
请帮我用 Python 写一个读取 CSV 文件并计算每列均值的函数
AI 会给你：
- 一段可以直接复制运行的完整函数
- 函数参数都加了说明和类型注解
- 附带使用示例和边界处理
- 自动加了错误处理，文件不存在时不会崩溃
场景2：让 AI 解释看不懂的代码
把这段发给 AI：
帮我解释这段正则表达式的含义：^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{8,}$
AI 会给你：
- 一段段拆解每个符号的意思
- 说明它整体在匹配什么样的密码
- 给几个能匹配上、几个匹配不上的例子
- 告诉你它等价的、更易读的写法
场景3：让 AI 帮你修 Bug
把这段发给 AI：
这个函数运行时抛出 KeyError，请帮我找出问题并修复
AI 会给你：
- 直接指出问题在哪一行、是什么原因
- 给出修复后的完整代码
- 顺便加上防御性代码，避免以后再犯
最佳实践
提问技巧（让 AI 回答更准）
- 多给背景：告诉 AI 你在做什么项目、用什么语言，它给的答案更靠谱
- 分步问：复杂问题拆成几轮，一次只问一个小目标
- 让它解释：在问题后面加一句「请同时解释原理」，能加深理解
- 指定格式：明确要求「请输出成 Markdown 表格」「请只给 JSON」，输出更规整
安全习惯
- 通行证别外传：方式 A 存在
auth.json、方式 B 写在opencode.json里的 Key，都是你的私人钥匙，绝不外传、不提交代码仓库（方式 B 务必加.gitignore） - AI 写的代码上线前要检查：AI 偶尔会写错，关键代码务必自己过一遍
- 控制权限：按最小权限原则配置 API Key 的访问范围
- 留意余额：DeepSeek 按量付费，账户余额用完会报错，建议设个余额告警或定期充值
出错了怎么办
| 你看到的现象 | 可能的原因 | 怎么解决 |
|---|---|---|
/connect 列表里没有 DeepSeek | OpenCode 版本太老 | 回步骤一重跑安装命令升级，再试一次 |
| 提示 401 或 403 Invalid Key | Key 复制错、已删除或余额用完 | 回 DeepSeek 平台重新生成 Key、确认有余额，再连一次（方式 A 重新 /connect，方式 B 改 opencode.json） |
| 提示 404 Not Found | 方式 B 的 baseURL 写错 | 确认 baseURL 带了 /v1，且没有多余斜杠 |
| 提示 429 Too Many Requests | 问太快或并发太高 | 降低请求频率；或错峰使用 |
| 504 Gateway Timeout | 网络抖动或当时太忙 | 重发一次；或临时切到别的 AI 来源 |
| AI 半天不回 / 转圈超时 | 网络抖动或当时太忙 | 重发一次；或临时 /models 切到别的来源 |
| 响应内容被截断 | maxTokens 设置过低 | 将 maxTokens 调大至 4096 以上 |
提示
💡 下一步：想让它 7x24 常驻？
OpenCode + DeepSeek 跑通后解决的是本机编码问题；如果你还想让它随时在线——挂给团队共用、接进其他工具、不看本机状态稳定响应——就该考虑把它搬到一台自己的服务器上。
可以看 DeepSeek 腾讯云本地部署教程，从选机型到跑起来一步步都有； 也可以直接对照 腾讯云轻量应用服务器 的配置与价格，先按量开一台试试。
扩展与进阶
还能玩出什么花样
- 加多个 AI 来源：重复跑
/connect可以把 Claude、OpenAI、Gemini、本地模型一个个都加进来，之后用/models随时切来切去 - 藏起不用的模型：如果模型列表太长眼花，可以在
opencode.json文件里写一行whitelist，只保留你常用的几个 - 上下文窗口管理：合理控制对话历史长度，避免超出上下文限制
- 流式输出：OpenCode 默认就是一段段往外蹦字的流式输出，体验接近真人打字
- Function Calling：让 DeepSeek 调用本地函数，实现更复杂的自动化任务
团队一起用
- 每个人自己
/connect绑自己的 Key（方式 A），或各自管自己的opencode.json（方式 B），不要共用一个账号抢额度 - 团队统一默认用
deepseek-chat，复杂推理任务再切deepseek-reasoner - 方式 B 在团队协作时，建议用密钥管理工具（如 Vault）统一管 Key，别明文写死
- 月底留意用量，监控 Token 消耗，设置用量告警避免超支
信息
最后一句: DeepSeek 和 OpenCode 都在不停更新，/connect 里能选的来源、配置文件的字段都可能有变化，有空看看官方更新日志，说不定有新惊喜。
常见问题
Q我连终端是什么都不懂，能用吗？
能用。选方式 A，全程只需复制粘贴一条安装命令，其余操作都在 OpenCode 自己的界面里点点选选完成，不用手写任何代码。
Q方式 A 的 /connect 列表里没有看到 DeepSeek 选项？
说明 OpenCode 版本太旧。请重新跑一遍步骤一的安装命令覆盖更新到最新版，然后再试一次。DeepSeek 是 OpenCode 原生支持的供应商，新版一定有。
Q粘贴 Key 后提示无效或报 401/403？
通常是 Key 复制时混进了空格或换行，或者 Key 已被删除/账户余额用完。回到 DeepSeek 开放平台重新生成一个新 Key，确认账户有余额，再连一次即可。
Q方式 B 报 404 Not Found？
baseURL 格式错误是最常见原因，请确认 API 端点 URL 包含正确的版本路径（如 /v1），且不要带多余斜杠。
Q响应很慢或超时怎么办？
先用 deepseek-chat 模型测试连通性；高峰期错峰使用；也可临时切到别的 AI 来源。