先看结论：免费线路和 Go 线路怎么选#

OpenCode 目前提供两种相关线路：

OpenCode 官方页面目前把 DeepSeek V4 Flash Free 的输入、输出和缓存读取价格都标记为 Free，并说明该免费模型只在一段时间内开放，用于收集反馈和改进模型。OpenCode Zen 官方文档

如果你准备长期使用，可以了解 OpenCode Go。官方页面显示，Go 首月 5 美元，之后每月 10 美元；使用额度按美元价值计算，包括 5 小时 12 美元、每周 30 美元、每月 60 美元的限制。OpenCode Go 官方说明

我个人的建议很简单：免费线路先体验，长期使用再考虑 Go 或 DeepSeek 官方 API。不要把限时免费活动当成生产环境的永久依赖。

你需要准备什么#

本教程需要三个东西：

1. OpenCode Zen API 密钥；
2. Cockpit Tools；
3. Codex。

相关下载链接和安装包，我会放在视频简介与置顶评论区。本文重点放在 API 和客户端配置，安装过程不再重复展开，否则五分钟教程很容易变成“观看安装进度条”。

一、注册 OpenCode Zen 并创建 API 密钥#

先通过我的邀请链接进入注册页面：

点击注册 OpenCode Go

配套的 Cockpit Tools、Codex 和配置文件打包下载：

夸克网盘打包下载

邀请活动的适用条件、奖励金额和有效期，请以打开页面后显示的规则为准。网盘文件由我整理提供，下载后请先确认文件名和来源，再运行安装程序。

打开 OpenCode Zen 页面，注册并登录账号后，进入 API Key 管理页面，创建一条新的密钥。

密钥名称可以填写：

1
Codex

创建完成后，复制 API 密钥并临时保存好。后面配置 Cockpit Tools 时需要使用它。

API 密钥等同于账户通行证。不要把密钥发到群聊、评论区、截图或公开仓库中。如果怀疑泄露，请立即在 OpenCode 控制台撤销并重新创建。

关于“启用部署在中国的模型”#

如果你的 OpenCode 账户页面中出现 启用部署在中国的模型 开关，可以按照页面提示打开：

这个开关是否出现、具体影响哪些模型，以你的账户页面实际显示为准。不要把它理解成 OpenCode 对所有模型都作出了永久的中国境内部署承诺；网络延迟、可用区域和模型路由仍可能变化。

另外，OpenCode 官方隐私说明显示，部分免费模型在免费期间收集的数据可能被用于改进模型。因此，不建议把密码、Token、客户资料、未公开源代码或其他敏感信息直接提交给免费模型。OpenCode Zen 隐私说明

二、在 Cockpit Tools 中添加 Codex 账号#

打开 Cockpit Tools，在左侧菜单找到 Codex，点击页面中的加号，添加一个新账号。

1
API Key

2. 填写基础地址#

如果使用免费线路，基础地址填写：

1
https://opencode.ai/zen/v1

如果使用 OpenCode Go，基础地址改为：

1
https://opencode.ai/zen/go/v1

这两个地址不要混用。免费线路对应免费模型，Go 线路对应不带 free 后缀的 Go 模型。

供应商名称可以随意填写，例如：

1
OpenCode

Cockpit Tools 的界面大致如下：

3. 从上游获取模型#

在模型列表中点击：

1
从上游获取

等待模型列表加载完成后，滚动到列表底部。

免费线路只保留：

1
deepseek-v4-flash-free

Go 线路选择：

1
deepseek-v4-flash

注意最后的 free 后缀。免费线路和 Go 线路的模型名称不要交叉填写。

如果页面提供 同步供应商模型到 Codex 选项，可以勾选它，让模型映射同步到 Codex 配置中。

确认基础地址、API 密钥和模型名称都正确后，点击 添加账号。

三、把协议改成 Chat Completions#

账号添加完成后，还需要完成一次协议设置。

回到账号或供应商列表，找到刚才添加的 OpenCode，点击编译或编辑按钮，将协议能力修改为：

1
Chat Completions

保存配置。

这是因为 OpenCode 官方文档给 DeepSeek V4 Flash 和 DeepSeek V4 Flash Free 标注的接口是 OpenAI 兼容的 Chat Completions。若协议选错，常见表现是账号看起来添加成功，但 Codex 实际调用时报接口格式不匹配、模型不存在或请求失败。OpenCode Zen 模型与接口列表

完成后回到账号列表，找到 OpenCode，点击启动按钮。

四、在 Codex 中验证是否接入成功#

打开 Codex，新建一个会话。第一次不要直接让它重构整个项目，先用一个只读问题确认模型名称：

1
请告诉我你当前使用的模型名称，不要修改任何文件。

如果能正常返回内容，说明基础地址、API 密钥和模型映射基本正确。

接着进入一个测试项目，发送：

1
请先分析当前项目的目录结构，不要修改任何文件，告诉我这个项目使用了哪些主要技术，以及可能的启动方式。

如果 Codex 能读取项目并给出合理分析，再继续测试工具调用：

1
请帮我检查当前项目是否可以在本地启动。
2
先只执行读取和检查命令，不要修改文件、安装依赖或删除内容；如果需要进一步操作，请先列出方案并等待确认。

这里建议分三步验证：

1. 能否正常返回模型文本；
2. 能否读取项目文件；
3. 能否在用户确认后执行命令。

不要一上来就把删除文件、修改系统配置、安装依赖等高风险操作交给新线路。

五、使用 CC Switch 接入 Claude Code#

如果你平时使用 Claude Code，也可以通过 CC Switch 管理这条 OpenCode 线路。

这一步不是 Codex 配置的必需步骤，主要用于 Claude Code 用户统一切换供应商和路由。

在 CC Switch 中添加或选择 OpenCode 配置，填入对应的 API 密钥、基础地址和模型后，一定要打开“本地路由”开关：

重点提醒：如果本地路由没有打开，Claude Code 可能仍然使用原来的服务地址，表面上看配置已经保存，实际请求却没有经过 CC Switch。遇到“配置了但模型没变化”，第一件事就是检查本地路由开关、路由状态和当前生效的配置。

启用本地路由后，再启动 Claude Code，先发送一个简单问题验证。确认模型能够正常返回后，再进入项目执行只读分析。

六、OpenCode Go 和邀请链接#

如果你后续确实有长期需求，可以考虑 OpenCode Go。官方当前显示的价格是首月 5 美元，之后每月 10 美元；额度不是固定请求次数，而是按模型价格折算的美元使用量。DeepSeek V4 Flash 价格较低，因此同样的额度通常可以支持更多请求，但实际次数仍会受到上下文长度、请求频率和平台规则影响。

这是我的 OpenCode Go 邀请链接：

使用一万的 OpenCode Go 邀请链接

邀请活动、奖励金额、适用地区和有效期，请以打开链接后页面显示的规则为准。当前账户页面如果显示受邀用户和邀请人各获得 5 美元额度，再按照页面规则完成订阅即可；如果页面规则发生变化，请不要以本文旧截图或旧文字为准。

如果你决定订阅，建议先确认：

• 首月和后续月费金额；
• 5 小时、每周和每月使用限制；
• 是否允许超额使用余额；
• 当前可用模型列表；
• 取消订阅和自动续费规则。

七、免费线路的限制和隐私提醒#

DeepSeek V4 Flash Free 适合体验、代码阅读、简单修改和轻量项目分析，但不建议把它当成重要生产项目的唯一线路。

免费模型可能遇到：

• 限时活动结束；
• 请求排队或限流；
• 服务容量变化；
• 模型名称或接口地址调整；
• 上下文长度、工具调用或稳定性变化。

使用免费模型时，还要特别注意数据隐私。不要直接提交：

• API 密钥、登录凭据和 Token；
• 客户资料、订单信息和内部文档；
• 未公开的商业代码；
• 数据库密码、服务器配置和私钥。

真正重要的项目，建议使用自己能够控制账单、权限、日志和数据策略的 API 服务，并提前准备备用模型。

常见问题#

总结#

完整流程可以概括为：

1. 注册 OpenCode Zen，创建 API 密钥；
2. 免费线路使用 https://opencode.ai/zen/v1 和 deepseek-v4-flash-free；
3. Go 线路使用 https://opencode.ai/zen/go/v1 和 deepseek-v4-flash；
4. 在 Cockpit Tools 中添加 Codex 账号；
5. 将协议改成 Chat Completions；
6. 启动 OpenCode 账号，在 Codex 中做只读测试；
7. Claude Code 用户通过 CC Switch 接入时，务必打开本地路由开关。

如果只是想体验，可以先用免费线路；如果需要长期稳定使用，再根据自己的预算和隐私要求选择 OpenCode Go 或官方 API。

相关安装包和配置说明会放在视频简介与置顶评论区。觉得文章有帮助，欢迎收藏并分享给同样在寻找 AI 编程额度的朋友。

关注一万 AI 分享