Claude Code 开源版！支持 Gemini-3 等任意模型，OpenCode 接入API配置使用教程

OpenCode是一款创新的开源命令行编程工具，支持多模型自由切换是其最大亮点。该工具提供直观的终端界面、会话管理、自定义命令等功能，开发者可灵活接入OpenAI、Gemini等各类模型，甚至本地部署的LLM。安装配置简单，通过修改JSON配置文件即可添加自定义API服务商和模型。OpenCode打破了AI编程工具对单一模型的依赖，为开发者提供了更自由的选择空间，是提升编程效率的利器。

狠活科技

813人浏览 · 2025-12-29 21:36:24

狠活科技 · 2025-12-29 21:36:24 发布

Claude Code 带火了命令行编程工具赛道，虽然大厂们纷纷跟进，但推出的产品大都大同小异，缺乏新意。不过，最近发现的这款工具 OpenCode 却让人眼前一亮！

它不仅完全开源免费，最核心的优势在于打破了模型限制——你可以随意接入 Gemini-3、Opus 等任何一家的模型。如果你也想体验，请看下面这份详细的第三方 API 配置指南。

关于 OpenCode

OpenCode 是一款基于 Go 的命令行编程工具（CLI），为开发者提供强大的 AI 协助，帮助编程、除错等工作。

该工具提供了直观的终端用户界面（TUI），支持多个大语言模型（LLM）供应商，包括 OpenAI、 Anthropic、Gemini 等，同时也兼容通过 Ollama 等工具运行的本地模型，提供灵活的推理部署选项。

💻 交互式终端界面：利用 Bubble Tea 提供顺畅的终端体验。
🗃️ 会话管理：可储存和管理多个会话，支持持久化存储。
⚙️ 自定义命令：支持自定义命令，可预设多个占位符和参数。
📝 集成 LSP：提供代码智能和诊断功能。
📦 安装和配置简便：支持多种安装方式，并提供丰富的环境变数配置选项。

安装 OpenCode

OpenCode 官方提供提供终端界面、桌面应用程序和 IDE 扩展三种使用方式，安装 CLI 最简单的方法是通过这行安装脚本：

curl -fsSL https://opencode.ai/install | bash

Windows 系统推荐下载 Node.js （https://nodejs.org/zh-cn/download），然后通过 NPM 命令安装 OpenCode 官方 CLI 程序。

npm i -g opencode-ai@latest

如果你更喜欢图形界面，OpenCode 也提供了桌面应用版本。可以直接从其 GitHub 发布页面或官网下载安装。

OpenCode 下载地址：https://opencode.ai/download

macOS 用户可以通过 Homebrew 安装桌面客户端

brew install --cask opencode-desktop

OpenCode 接入API

1️⃣初始化服务商（Provider）

安装后先不要直接启动 OpenCode，而是需要在终端中执行以下命令：

opencode auth login

（1）然后在服务商列表中，选择 other（在最下面，可以直接搜索）。

（2）系统会提示你输入 Provider ID：请填写一个唯一标识名（例如 wolfai），后续配置需与之严格一致。

（3）接着输入 API Key 令牌：可填写任意内容（如 admin），实际密钥可通过配置文件安全引用（见下一步）。

这一步的作用是让 OpenCode 在本地凭证管理器中注册一个自定义服务商，便于后续引用密钥。

2️⃣修改配置文件

打开 OpenCode 配置目录（文件路径因系统而异）：

macOS / Linux: ~/.config/opencode/
Windows: Users\你的用户名\ .config\opencode

然后在该目录下创建或编辑配置文件：opencode.json，文件内容如下：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deeprouter": {  // 这里必须和上一步的提供商 ID 完全一致！
      "npm": "@ai-sdk/openai-compatible",
      "name": "DeepRouter",  // 在终端中显示的名称，可自定义
      "options": {
        "baseURL": "https://deeprouter.top/v1",  
        "apiKey": "sk-XXXXXXXX" // 改为你自己的 API 令牌
      },
      "models": {
        "gpt-5.2-codex": {  // 支持任意模型 ID，例如 gpt-4o、claude-sonnet-4-5 等
          "name": "GPT-5.2"
        },
        "claude-sonnet-4-5-20250929": {
          "name": "Claude-4.5-Sonnet"
        },
        "gemini-3-pro-preview": {
          "name": "Gemini-3-Pro"
        }
        // 添加更多模型...
      }
    }
  }
}

API 令牌生成获取地址：https://deeprouter.top/console/token

令牌分组建议使用 Default 默认分组（所有模型可用），打开无限额度和永不过期，其他全部保持默认即可。