OpenCode

OpenCode 是一个开源的终端 AI 编程 Agent，定位类似 Claude Code，但支持接入任意 OpenAI 兼容的服务商。

特点

• 完全开源，可自托管
• 支持多模型切换
• 终端界面，适合喜欢 CLI 的开发者

安装

npm install -g opencode-ai

或者按官网指引用其他方式安装。

配置 Aivisx Link

OpenCode 读取 ~/.config/opencode/opencode.json（Windows 是 %USERPROFILE%\.config\opencode\opencode.json）。

创建或编辑该文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aivisx": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Aivisx Link",
      "options": {
        "baseURL": "https://aivisx.link/v1",
        "apiKey": "sk-你的KEY"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" },
        "gpt-5.4-mini": { "name": "GPT-5.4 mini" },
        "gpt-6-astra": { "name": "GPT-6 Astra" }
      }
    }
  },
  "model": "aivisx/gpt-5.5"
}

要点：

• baseURL 需要带 /v1
• apiKey 填 gpt-plus 或 gpt-pro 分组的 Key
• models 里列出你想用的模型，键名必须是平台的真实模型名
• 最后的 model 字段指定默认模型，格式是 供应商名/模型名

验证

opencode

启动后随便提一个需求，能正常响应即成功。

用 Claude 模型

OpenCode 走的是 OpenAI 兼容协议，所以 不能直接用 claude 分组的 Key。如果想在 OpenCode 里用 Claude，需要走平台的 OpenAI 兼容桥接（即用 gpt-* 分组的 Key 并指定对应模型），具体以「模型广场」展示的可用组合为准。

常见问题

Q：报 404baseURL 少了 /v1。

Q：模型名无效 确认模型名和「模型广场」里展示的完全一致，包括大小写和连字符。

Q：想换模型 在 OpenCode 里用 /models 命令切换，或修改配置文件里的 model 字段。

相关文档

• 模型选择
• API 参考
• Codex 接入