Skip to content

OpenCode 安装与配置指南

下载 OpenCode 桌面版,并通过 CC Switch 接入自定义 API 供应商。

下载地址https://opencode.ai/zh/download


目录


第一步:下载桌面版

打开 OpenCode 官网,点击 下载 Windows 版(macOS 用户点击对应的系统版本)。

OpenCode 官网下载页,点击「下载 Windows 版」按钮


第二步:安装 OpenCode

下载完成后双击安装包,按提示完成安装。

⚠️ 安装完成后先不要急着使用,随后打开 CC Switch 完成供应商配置。


第三步:配置 CC Switch

3.1 添加供应商

打开 CC Switch,在顶部图标栏中选中 OpenCode 图标,然后点击 添加供应商

CC Switch 中点击「添加供应商」

如果你之前已有配置,也可以点击 导入当前配置,所有数据会安全保存在 default 供应商中。

3.2 选择自定义配置

在「添加新供应商」页面的预设供应商列表中,选择 自定义配置

添加新供应商页面,选择「自定义配置」

💡 页面底部提示:自定义配置需要手动填写所有必要字段。

3.3 填写供应商信息

按下表填写各字段:

编辑供应商页面:填写接口格式、API Key、Base URL 与额外选项

填写完成后:

  1. 点击右侧 获取模型列表,自动拉取可用模型。
  2. 在「模型配置」区域选择 模型 ID 并填写 显示名称
  3. 点击右下角 保存

3.4 启用供应商

回到供应商列表,找到刚创建的条目(例如 fastaitoken),点击绿色的 + 添加 按钮完成启用。

供应商列表中点击绿色的添加按钮启用配置


第四步:启动并选择模型

最后打开 OpenCode,在输入框下方的模型选择器中,切换到 fastai 分组下配置好的模型(如 claude-opus-4-8),即可成功使用。

OpenCode 新建会话界面,在模型下拉列表中选择配置好的模型

模型列表中带「免费」标签的是官方提供的免费模型;fastai 分组下的则是通过 CC Switch 接入的自定义供应商模型。


常见问题

问题排查方向
模型列表里找不到自定义模型确认 CC Switch 已保存配置并点击了 + 添加 启用
获取模型列表失败检查 API Key 是否正确、Base URL 是否有多余的斜杠或空格