X-Code Docs

主题

OpenCode 配置指南 ​

安装 ​

安装脚本 ​

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

NPM ​

bash
npm i -g opencode-ai@latest

Homebrew ​

bash
brew install anomalyco/tap/opencode

Scoop（Windows） ​

powershell
scoop install opencode

Chocolatey（Windows） ​

powershell
choco install opencode

Arch Linux ​

bash
sudo pacman -S opencode

API 配置 ​

配置文件 ​

编辑 ~/.config/opencode.json：

Anthropic 模型（Claude） ​

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xcodeapi": {
      "models": {
        "claude-opus-4-6": {
          "name": "claude-opus-4-6"
        },
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        }
      },
      "name": "X-Code API",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "your-api-key",
        "baseURL": "https://api-cn.x-code.cc/v1"
      }
    }
  }
}

OpenAI 模型（GPT） ​

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xcodeapi-openai": {
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4"
        }
      },
      "name": "X-Code API",
      "npm": "@ai-sdk/openai",
      "options": {
        "apiKey": "your-api-key",
        "baseURL": "https://api-cn.x-code.cc/v1"
      }
    }
  }
}

同时配置多个 Provider ​

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xcodeapi-anthropic": {
      "models": {
        "claude-opus-4-6": {
          "name": "claude-opus-4-6"
        },
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6"
        }
      },
      "name": "X-Code API (Anthropic)",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "your-api-key",
        "baseURL": "https://api-cn.x-code.cc/v1"
      }
    },
    "xcodeapi-openai": {
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4"
        }
      },
      "name": "X-Code API (OpenAI)",
      "npm": "@ai-sdk/openai",
      "options": {
        "apiKey": "your-api-key",
        "baseURL": "https://api-cn.x-code.cc/v1"
      }
    }
  }
}

配置文件位置 ​

文件路径
配置文件~/.config/opencode.json

启动 ​

配置完成后，在项目目录中运行：

bash
cd your-project
opencode