在终端里跑 opencode 的开发者，最近大概率见过这类提问：opencode 接 DeepSeek 是不是可以无限用？有些群里的原话更直接，直接喊“站起来蹬啊”。先不急着判断能不能无限用，这句提问里其实混着三个完全不同的话题：opencode 是什么、DeepSeek 怎么提供模型能力、以及“无限用”到底指哪一层。不把这三件事拆开，很容易被一条“免费通道”的消息带节奏。opencode 本身是开源的终端编程代理，工具本身不向你收费；但它替你写代码时，背后调用的大模型要么走你自己配置的 API Key 计费，要么走某个托管服务限制额度。下面从零开始，先装好 opencode，再接入 DeepSeek 官方 API，跑通一个真实修改任务，最后把安装报错、请求失败、额度异常和“免费无限用”的常见误区按排查链路讲清楚。
1. 先拆开“opencode 无限用 DeepSeek”里的三个概念
1.1 opencode 是终端里的开源 AI 编程代理
opencode 是一类被叫做 AI coding agent 的工具，和 Claude Code、Codex CLI 属于同一个赛道。它运行在终端里，不是简单帮你补全一段代码，而是把整个项目作为上下文：读取文件、分析目录结构、定位报错、修改代码、执行命令、根据测试结果继续调整。开发者只需要在会话里描述目标，剩下的多轮“读代码-改代码-跑命令-看结果”循环由它完成。
opencode 本身是开源项目，代码公开，可以自行构建、审查和改造。但它不会内置无限算力，模型请求全部落在你选择的模型供应商上。这一点决定了后面所有讨论的边界：工具层免费，模型层另算。
开源工具的版本迭代通常很快，命令参数、配置文件字段在不同版本之间可能有差异。后面给出的配置示例，落地时都要以你本机安装版本对应的--help输出和官方文档为准。
1.2 DeepSeek 在对接里到底承担什么角色
DeepSeek 在这里是模型供应商。你从 DeepSeek 开放平台注册账号、创建 API Key，然后 opencode 通过 HTTP 接口把代码相关请求发过去，模型返回补丁、解释或命令结果。DeepSeek 的 API 兼容 OpenAI 的接口风格，所以任何支持自定义模型供应商、支持 OpenAI 兼容接口的客户端，理论上都可以接 DeepSeek，opencode 也不例外。
DeepSeek 目前主要提供两类模型能力：
- deepseek-chat：通用对话和代码生成，适合日常改代码、写脚本、解释报错。
- deepseek-reasoner：推理增强模型，适合复杂问题分析、多步推理、架构设计。
选择哪个模型，直接决定 opencode 在项目里的表现。后面第 3 章会展开说明模型选型。
1.3 “无限用”的常见来源：四种说法，四种真相
“opencode 的 DeepSeek 无限用”这句话，在社区里通常来自以下几种情况，它们的成本和风险完全不同。
| 说法 | 真实情况 | 主要风险或成本
