OpenCode CLI 配置教程

OpenCode 第三方 API 接入配置详解

本文档旨在说明如何将符合 OpenAI 接口规范的第三方 API 服务集成到 OpenCode 环境中。

📌

如果你想在 OpenCode 中使用 Gemini 模型，可以尝试使用 Chat 格式，如果使用原生格式请使用其他编程工具，OpenCode 使用 Gemini 模型因格式协议问题会报错不兼容，请大家知悉！

1. OpenCode 环境准备

安装 OpenCode 最简单的方式是使用官方安装脚本：

你也可以使用 npm 安装：

npm install -g opencode-ai

配置步骤

方式一：使用 CC-Switch 快速配置（推荐）

1. 启动 CC-Switch 并添加 OpenCode 配置

打开 CC-Switch 应用程序

点击顶部的「OpenCode」标签页

点击右上角橙色「+」按钮添加新配置

选择自定义配置

2. 填写提供商配置信息

提供商名称：自定义名称（如"zeta-router"）

官网链接：https://plan.zetarouter.com

接口格式：选择Anthropic

API Key：粘贴您从 ZetaRouter 平台获取的令牌

Base URL：https://plan.zetarouter.com/v1

模型配置：点击添加模型，输入模型ID claude-sonnet-4-5,模型名称Claude Sonnet 4.5

3. 启用配置并使用

1.在配置列表中找到刚创建的「zeta-router」配置

2.点击配置右侧的「当前使用」按钮（或直接点击配置卡片）

3.配置会被标记为「当前使用」状态（绿色标签）

4.重启 OpenCode，新配置即可生效

方式二：手动配置

Windows

MacOS

Linux

  `%USERPROFILE%\.config\opencode\opencode.json`

配置模板

  {
      "models": {
        "claude-sonnet-4-5": {
          "name": "claude-sonnet-4-5"
        }
      },
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "sk-***",
        "baseURL": "https://plan.zetarouter.com/v1"
      }
    }

OpenCode 第三方 API 接入配置详解#

1. OpenCode 环境准备#

配置步骤#

方式一：使用 CC-Switch 快速配置（推荐）#

1. 启动 CC-Switch 并添加 OpenCode 配置#

2. 填写提供商配置信息#

3. 启用配置并使用#

方式二：手动配置#