OpenCode CLI 配置指南（CC Switch）

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。

配置速查

配置项	填写内容
Base URL	`https://koalaapi.com`；OpenAI 兼容接口填 `https://koalaapi.com/v1`
API Key	控制台 → 令牌管理创建的令牌，形如 `sk-...`
模型名称	与控制台【模型广场】完全一致；不同令牌分组可用的模型不同

一、准备工作

开始配置前，请先确认已具备以下条件：

已拥有可正常登录的 KoalaAPI 账号。

已安装或准备安装 OpenCode CLI。

已安装或准备安装 CC Switch。

当前网络环境可以正常访问 https://koalaapi.com/。

已确认要使用的 KoalaAPI 令牌分组中包含 OpenCode 可用的模型。

如果使用 npm 安装 OpenCode CLI，请提前安装 Node.js 和 npm。可以在 PowerShell 或 CMD 中执行下面的命令检查：

如果两条命令都能正常显示版本号，说明 Node.js 和 npm 已安装完成。

二、安装 OpenCode CLI

OpenCode 官方建议 Windows 用户优先使用 WSL 获得更完整的终端体验。如果你已经在使用 WSL，可以在 WSL 终端中执行：

如果你希望直接在 Windows 的 PowerShell 或 CMD 中使用 OpenCode CLI，可以使用 npm 安装：

注意：opencode-ai 包、opencode.ai/install 脚本以及 Scoop / Chocolatey 安装的都是旧的 1.x 版本，请按上面的命令安装 2.x。

安装完成后，关闭当前终端，再重新打开 PowerShell、CMD 或 WSL 终端，执行下面的命令确认安装是否成功：

如果能正常显示版本号，说明 OpenCode CLI 已安装完成。

（截图待补）

三、安装 CC Switch

请先按照 KoalaAPI 官方文档完成 CC Switch 安装：

【CC Switch 安装教程】https://koalaapi.apifox.cn/8463188m0

安装完成后，请确认 CC Switch 可以正常打开。后续需要在 CC Switch 中手动添加 OpenCode 供应商配置。

打开 CC Switch 后，请确认应用列表中可以找到 OpenCode 对应入口。

（截图待补）

四、在 CC Switch 中手动添加 OpenCode 配置

点击右上角的 添加供应商。

（截图待补）

在添加供应商页面中，点击 自定义配置。

（截图待补）

进入自定义配置页面后，按以下要求填写：

供应商名称：填写容易识别的名称，例如 My OpenCode。

备注：可选，可填写用途说明。

官网链接：填写 https://koalaapi.com/v1。

API Key：粘贴刚刚从 KoalaAPI 令牌列表复制的密钥。

请求地址：填写 KoalaAPI 的 OpenAI 兼容请求地址，通常为 https://koalaapi.com/v1。如果 KoalaAPI 页面或客服给出的地址不同，请以实际地址为准。

额外选项：键名和值保持默认。

模型 ID：填写要在 OpenCode CLI 中使用的模型 ID。模型 ID 必须来自当前令牌分组中的可用模型。

如果页面支持 获取模型列表，可以先点击 获取模型列表。如果无法自动获取，请点击 添加模型，手动填写模型 ID。

模型添加完成后，然后点击保存。

（截图待补）

五、验证 OpenCode CLI

重新打开 PowerShell、CMD 或 WSL 终端，进入你的项目目录。

执行下面的命令启动 OpenCode CLI：

如果首次进入时提示选择供应商、登录或初始化，请先确认 CC Switch 中 OpenCode 配置已经处于 使用中 状态，再回到终端继续。

（截图待补）

选择自己模型后，输入一个简单问题进行测试，例如：

请用一句话说明你已经连接成功。

如果模型可以正常回复，说明 OpenCode CLI 已通过 CC Switch 使用 KoalaAPI 配置完成。

（截图待补）

如果这是第一次在当前项目中使用 OpenCode，也可以在 OpenCode CLI 中执行：

/init

该命令会让 OpenCode 分析项目，并在项目根目录创建或更新 AGENTS.md。

七、常见问题

输入 `opencode` 后提示命令不存在

通常是 OpenCode CLI 没有安装成功，或者 npm、Scoop、Chocolatey 的全局命令目录没有加入环境变量。

请重新执行安装命令，安装完成后 关闭终端，再重新打开 PowerShell、CMD 或 WSL 终端。

启用配置后 OpenCode CLI 仍然走默认服务

请优先检查以下内容：

CC Switch 当前启用的是刚添加的 My OpenCode 配置。

当前选中的是 OpenCode 页面。

启用配置后，是否已经重新打开 PowerShell、CMD 或 WSL 终端。

项目目录下是否存在 .env 文件，并且里面配置了旧的 API Key 或 Base URL。

本机是否手动设置过旧的 OPENAI_API_KEY、OPENAI_BASE_URL 或其他相关环境变量。

如果之前手动执行过 opencode auth login，OpenCode 可能已经保存过旧供应商凭据。可以执行下面的命令查看已登录的供应商：

如确认旧凭据会干扰当前配置，请先在 OpenCode 或 CC Switch 中清理旧配置后再测试。

添加后无法连通

请优先检查以下内容：

KoalaAPI 令牌是否已启用。

令牌分组中是否包含所选模型。

CC Switch 中是否已点击启用。

API Key 是否复制完整。

请求地址 是否为 KoalaAPI 的 OpenAI 兼容请求地址。

模型 ID 是否和 KoalaAPI 后台可用模型 ID 完全一致。

当前网络是否可以正常访问 https://koalaapi.com/。

运行 `opencode` 后提示需要登录

如果已经通过 CC Switch 启用了 KoalaAPI 配置，但 OpenCode CLI 仍提示登录，请先关闭所有终端窗口，再重新打开终端运行 opencode。

如果仍然提示登录，请回到 CC Switch，确认 My OpenCode 配置处于 使用中 状态，并重新执行 连通性测试。

可以从 KoalaAPI 官网一键导入 OpenCode 配置吗

当前 OpenCode CLI 配置需要在 CC Switch 中手动添加。KoalaAPI 官网用于创建令牌并复制密钥，不要使用官网的一键 CC Switch 导入流程配置 OpenCode CLI。

找不到 OpenCode 应用入口

请先确认 CC Switch 已更新到较新的版本。如果当前版本没有 OpenCode 入口，请参考 KoalaAPI 的 CC Switch 使用教程更新或重新安装 CC Switch。

更新于 2026-11　官方文档：https://opencode.ai/docs

OpenCode CLI 配置指南 (CC Switch)

OpenCode CLI 配置指南（CC Switch）#

一、准备工作#

二、安装 OpenCode CLI#

三、安装 CC Switch#

四、在 CC Switch 中手动添加 OpenCode 配置#

五、验证 OpenCode CLI#

七、常见问题#

输入 opencode 后提示命令不存在#

启用配置后 OpenCode CLI 仍然走默认服务#

添加后无法连通#

运行 opencode 后提示需要登录#

可以从 KoalaAPI 官网一键导入 OpenCode 配置吗#

找不到 OpenCode 应用入口#

OpenCode CLI 配置指南（CC Switch）

一、准备工作

二、安装 OpenCode CLI

三、安装 CC Switch

四、在 CC Switch 中手动添加 OpenCode 配置

五、验证 OpenCode CLI

七、常见问题

输入 `opencode` 后提示命令不存在

启用配置后 OpenCode CLI 仍然走默认服务

添加后无法连通

运行 `opencode` 后提示需要登录

可以从 KoalaAPI 官网一键导入 OpenCode 配置吗

找不到 OpenCode 应用入口