OpenCode 接入教程

OpenCode 是一款基于 Go 的开源免费命令行编程工具 (CLI)，核心优势在于打破模型限制——你可以同时接入 Claude、GPT、Gemini 等模型自由切换。内置基于 Bubble Tea 的流畅 TUI 体验和 LSP 代码智能。

前置条件

1. 前往 一元模型控制台 注册并获取 API Key
2. 安装 Node.js 18+ (npm 方式) 或 bash (脚本方式)

1. 安装

macOS / Linux：

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

NPM 安装（全平台，推荐 Windows）：

npm i -g opencode-ai@latest

macOS Homebrew 桌面客户端：

brew install --cask opencode-desktop

2. API 配置

步骤 1：注册自定义服务商

安装后先不要启动 OpenCode，在终端执行：

opencode auth login

在服务商列表中选择 other（最下面，可搜索），然后：

• Provider ID：输入 yiyuanapi（后续配置需一致）
• API Key：输入从 一元模型控制台 获取的 Key

步骤 2：修改配置文件

编辑 ~/.config/opencode/opencode.json（Windows: Users\用户名\.config\opencode\opencode.json）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "yiyuanapi": {
      "npm": "@ai-sdk/anthropic",
      "name": "一元模型",
      "options": {
        "baseURL": "https://timesniper.club/v1"
      },
      "models": {
        "claude-opus-4-6": { "name": "claude opus 4.6" },
        "claude-sonnet-4-5": { "name": "claude-sonnet-4-5" }
      }
    },
    "yiyuanapi-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "一元模型-GPT",
      "options": {
        "baseURL": "https://timesniper.club/v1",
        "apiKey": "sk-你的GPT分组Key"
      },
      "models": {
        "gpt-4o": { "name": "gpt-4o" }
      }
    }
  }
}

注意："yiyuanapi" 必须和步骤 1 输入的 Provider ID 完全一致。baseURL 必须以 /v1 结尾。想同时使用 GPT 模型需另建服务商条目。

步骤 3：启动

重启终端后运行 opencode，输入 /models 选择模型即可。

使用技巧

1. 利用会话管理保存和切换不同项目的对话
2. 在 models 中配置多个模型，按需切换
3. 善用 LSP 集成获取代码智能提示

---

常见问题与异常处理 (FAQ)

错误	原因	解决方案
401 Unauthorized	API Key 错误或为空	前往 一元模型控制台 重新获取密钥
404 Not Found	接口地址格式错误	确认 Base URL 是否正确（大部分需要 https://timesniper.club/v1）
429 Too Many Requests	请求频繁或额度耗尽	等待冷却或在充值页面充值
连接超时 / Network Error	网络或代理冲突	检查代理/VPN，确认 URL 无空格
SSE 流式输出乱码	端点类型不匹配	将端点类型改为 OpenAI 或 OpenAI-Response

提示: 如果依然无法解决，请携带完整报错截图到客服群中寻求帮助。