AIGoCode Docs

OpenCode 接入

通过全局配置文件将 OpenCode 接入 AIGoCode

下面的全局配置会被 OpenCode 的不同启动方式共同读取。选择一种接入方式,保存对应配置后重新打开 OpenCode 即可。

配置文件位置

如果 OpenCode 正在运行,请先将它关闭,然后打开全局配置文件:

Windows
%USERPROFILE%\.config\opencode\opencode.json
macOS / Linux
~/.config/opencode/opencode.json

如果目录或文件不存在,请先创建。

如果不想手动修改配置文件,也可以把本页链接交给 Claude Code、Codex 等 Agent 工具,让它按照你选择的接入方式完成配置。

OpenAI 接入

  1. 前往 AIGoCode API Key 页面,选择 Codex(可外接) 分组并创建 API Key。

选择 Codex(可外接)分组

  1. 将下面配置中的 sk-your-api-key 替换为刚创建的 API Key,再将完整内容写入 opencode.json 并保存。
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "aigocode/gpt-6-astra",
  "provider": {
    "aigocode": {
      "npm": "@ai-sdk/openai",
      "name": "AIGoCode",
      "options": {
        "baseURL": "https://api.aigocode.app/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "gpt-6-astra": {
          "name": "GPT-6 Astra"
        }
      }
    }
  }
}
  1. 保存配置后,重新打开 OpenCode。

Claude 接入

  1. 前往 AIGoCode API Key 页面,选择 Claude Code(可外接) 分组并创建 API Key。

选择 Claude Code(可外接)分组

  1. 将下面配置中的 sk-your-api-key 替换为刚创建的 API Key,再将完整内容写入 opencode.json 并保存。
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "aigocode/claude-sonnet-5",
  "provider": {
    "aigocode": {
      "npm": "@ai-sdk/anthropic",
      "name": "AIGoCode",
      "options": {
        "baseURL": "https://api.aigocode.app/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5"
        }
      }
    }
  }
}
  1. 保存配置后,重新打开 OpenCode。

Gemini 接入

  1. 前往 AIGoCode API Key 页面,选择 Gemini 分组并创建 API Key。

选择 Gemini 分组

  1. 将下面配置中的 sk-your-api-key 替换为刚创建的 API Key,再将完整内容写入 opencode.json 并保存。
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "aigocode/gemini-3.8-flash",
  "provider": {
    "aigocode": {
      "npm": "@ai-sdk/google",
      "name": "AIGoCode",
      "options": {
        "baseURL": "https://api.aigocode.app/v1beta",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "gemini-3.8-flash": {
          "name": "Gemini 3.8 Flash"
        }
      }
    }
  }
}
  1. 保存配置后,重新打开 OpenCode。

验证

新建会话并发送一条消息。OpenCode 能正常回复,并且 AIGoCode 的用量记录中出现这次请求,即表示接入成功。

OpenCode 接入成功

遇到 401403429 时查看 错误码。如果模型不可用,请确认 API Key 来自对应分组,并检查配置中的 Key 和请求地址。

On this page