OpenCode 配置

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

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

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


步骤 1:启动配置

直接运行:

opencode

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

sudo opencode

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

在 OpenCode 终端界面中输入:

/connect

然后选择:opencode

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

步骤 2:获取 API Key

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

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

步骤 3:粘贴 API Key

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

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

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

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

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


接入阿里百炼

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

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

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

在 OpenCode 中设置

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

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

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

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

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


国内 API 配置

国内厂商 API 申请地址:

厂商/品牌 简介 API 申请入口(点击即达)
DeepSeek(国产高性价比) 官方模型:deepseek-chat / deepseek-reasoner https://platform.deepseek.com/api_keys
阿里百炼(通义千问) 阿里云大模型统一入口,支持千问、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 配置,就好比给你的开发工具箱来了个智能整理助手,所有工具的配置都能在它这有序管理。

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

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

如果你不闲麻烦,可以参照下文,自行配置。