Skip to content

OpenCode API 设置

通过 OpenCode,你可以接入任意 LLM(大语言模型)提供商,例如 OpenAI、Claude、DeepSeek、阿里百炼等,从而获得更强的 AI 编程能力。

如果你是第一次使用,建议优先选择 OpenCode Zen,它是 OpenCode 官方精选的一组模型,已经过测试和优化,开箱即用,适合新手。

OpenCode Zen 里面也包含了大量的免费大模型,所以基本上可以直接用,不用充钱。


步骤 1:启动配置

直接运行:

bash
opencode

如果出现 EACCES: permission denied, open '' 是权限问题,请使用管理员权限执行,比如:

bash
sudo opencode

你会看到终端界面(TUI):

f0d7fd3e-9f67-4c55-ab21-bd08ebc9a09e.png

在 OpenCode 终端界面中输入:

bash
/connect

53b109ec-a51f-44b6-b20f-04889c867e54.png

注:使用 /connect 命令添加提供商的 API 密钥后,凭据会存储在 ~/.local/share/opencode/auth.json 中。

然后选择:opencode

2c25238f-debb-4590-94cb-1244533a2df0.png

如果有其他的大模型 Key,你也可以通过这个列表选择配置。

步骤 2:获取 API Key

打开以下页面并登录: https://opencode.ai/auth

  • 登录账号
  • 添加账单信息
  • 创建 API Key

步骤 3:粘贴 API Key

回到终端,将获取到的 API Key 粘贴进去:

b6d2084f-4a4c-478a-9355-4f1cc15b989c.png

完成后,即可开始使用 OpenCode。

我们可以按下 Ecs 退出配置 LLM 提供商,然后在对话窗口输入 /model 命令来查看支持的模型:

1f43d28d-65b0-4ac0-a5e1-52faa7e069d7.png

看到有 Free 字样的就是免费的模型:

666d0340-63fe-4ad2-891b-edd8da69dfae.png

选择完成后按下 Ecs 退出配置,就可以看到当前用的大模型:

db7d55c8-29f3-472f-a9b5-f07fac8f23f4.png

国内 Coding Plan 套餐

现在市面上有很多大模型厂商, 国外的有 Anthropic、Open AI、Grok、Gemini等,但是访问国外现在不方便,国内的有 DeepSeek、千问、ZLM、Minimax 等。

我们使用Claude Code 写代码最费钱的就是 token 了,海外的访问不方便,而且还贵,国内的现在都有包月套餐,如果长期用建议买包月套餐划算。


接入阿里百炼

OpenCode 是开源的 AI 编程工具,可配合阿里云百炼提供的模型推理服务实现高效代码开发。

我们可以先使用阿里云主账号访问百炼模型服务平台 https://bailian.console.aliyun.com/,然后点击右上角登录,登录成功后点击右上角的齿轮⚙️图标,选择 API key,然后复制 API key,如果没有也可以创建 API key:

83536c84-3956-4679-ad14-99d53e697692-scaled.png

p994209.png

可以直接购买资源包,这样用起来更划算:https://cn.aliyun.com/benefit?from_alibabacloud=&userCode=i5mn5r7m

在 OpenCode 中设置

在输入框输入 /connect 并单击 Enter。

Connect a Provider 列表的搜索框中输入 alibaba 进行搜索,选中 Alibaba (China) 并单击 Enter。

p1052260.png

输入我们申请的 API Key 后按 Enter:

58b6aaed-203d-4f12-ba6b-8a62990465ba.png

然后我们可以输入 /model 查看阿里支持的模型,并选择需要的:

c7e1315e-11dc-491c-9b4c-d1eaf89d3410.png

本文档仅适用于按量付费模式,Coding Plan 用户请使用专属 Base URL 和 API Key 接入,详情请参考 OpenCode Coding Plan 说明文档进行配置。


国内 API 配置

国内厂商 API 申请地址:

厂商/品牌简介API 申请入口(点击即达)
DeepSeek(国产高性价比)官方模型:
deepseek-v4-flash
deepseek-v4-pro
deepseek-chat (将于 2026/07/24 弃用)
deepseek-reasoner (将于 2026/07/24 弃用)https://platform.deepseek.com/api_keys
火山方舟 Coding Plan支持在最新版 Doubao-Seed-2.0-pro/lite/Code、Doubao-Seed-Code、MiniMax-M2.5、Kimi-K2.5、GLM-4.7、Deepseek-V3.2 多种模型中自由切换,或使用Auto模式调度。[https://www.volcengine.com/activity/codingplan](https://www.volcengine.com/activity/codingplan?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=runoob
)
阿里百炼(通义千问)阿里云大模型统一入口,支持千问、GLM、Kimi 、MiniMax 等最新版本模型https://bailian.console.aliyun.com
GLM(智谱清言)清华系 ChatGLM 系列,支持 GLM-4、GLM-3-Turbo 等https://open.bigmodel.cn
MiniMax国产多模态,支持文本、语音、图像混合调用https://platform.minimaxi.com

进入对应控制台后,注册/登录 → 完成实名认证 → 创建 API Key 即可开始调用。

API 管理工具

平台一多,配置起来就麻烦,我们可以使用第三方工具 CC Switch 可以帮我们轻松管理这几个热门工具的 API 配置:https://github.com/farion1231/cc-switch/,Windows / macOS / Linux 全支持。

CC Switch 是一个 Claude Code / Codex / Gemini CLI 的全方位辅助工具。

CC Switch 可以帮我们轻松管理这几个热门工具的 API 配置,就好比给你的开发工具箱来了个智能整理助手,所有工具的配置都能在它这有序管理。

3f634726-617d-43a7-9040-a4acaaca9433.png

各平台安装包下载地址:https://github.com/farion1231/cc-switch/releases

claude-code-runoob2.png

这里我们选择 OpenCode 图标,然后点击右上角的添加按钮:

bb378965-0481-452c-bc2e-d91411c65a9b.png

默认有很多供应商,我这里选 DeepSeek 演示:

e1c1edff-a415-4cdc-a3d1-ebfb6e62a525.png

设置你获取的 API key:

afa346ae-bb25-4a4d-9c72-197b488e2635.png

设置模型 deepseek-v4-pro

5a59bad4-d072-46ae-a92a-2410cf3c0f26.png

设置完后,我们就可以到终端测试下:

bash
sudo opencode run 解释一下 JavaScript 中闭包的原理

bce90859-cc14-44d6-a11a-6a763f6ce921.png

更多具体的操作设置参考文章:https://www.runoob.com/ai-agent/cc-switch.html

AI 思考中...

OpenCode 安装

OpenCode 第一次使用

基于 VitePress 构建,部署于 GitHub Pages