Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.xcompute.us/llms.txt

Use this file to discover all available pages before exploring further.

OpenCode 支持自定义 provider 配置，所以它很适合通过 OpenAI 兼容方式接入 Xcompute。

​
安装

如果你还没准备 Node 环境，先看 环境准备：NVM、Node.js 22 和 npm。 
npm install -g opencode-ai
安装后验证： 
opencode --version

​
配置 Xcompute

推荐使用全局配置文件：~/.config/opencode/opencode.json 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xcompute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Xcompute",
      "options": {
        "baseURL": "https://xcompute.us/v1",
        "apiKey": "{env:XCOMPUTE_API_KEY}"
      },
      "models": {
        "gpt-5": {
          "name": "GPT-5"
        },
        "claude-sonnet-4-5-20250929": {
          "name": "Claude Sonnet 4.5"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        }
      }
    }
  },
  "model": "xcompute/gpt-5"
}
然后设置环境变量： 
export XCOMPUTE_API_KEY="YOUR_XCOMPUTE_API_KEY"

​
启动与验证

opencode
如果你能正常进入界面并开始新会话，说明 OpenCode 已经可以通过 Xcompute 调用模型。

​
什么时候适合用 OpenCode

  1. 你想在同一套代码 Agent 工作流中切换不同模型。
  2. 你希望把多个开发工具的调用都统一到一个平台管理。
  3. 你想通过配置文件精细控制 provider、model 和权限策略。

​
为什么推荐 OpenCode 这样配

1

走 OpenAI 兼容协议

你只需要把 baseURL 指向 Xcompute 的 /v1 入口。
2

把密钥放到环境变量

避免把真实密钥直接写死在配置文件里。
3

按工具拆分密钥

建议给 OpenCode 单独一个 API Key，和 Claude Code、应用服务分开。

控制台

管理 API Key、额度和调用记录。

API 参考

在正式接入前先核对请求格式和示例代码。