OpenCode

安装 OpenCode

Windows 用户可能出现因为数字签名而无法运行脚本的问题，请运行如下命令:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

安装最新 LTS 版本的 Node.js，安装完成后，打开终端（Windows 用户使用 PowerShell）并检查版本号。

macOS、Linux、Windows：

npm install -g opencode-ai

OpenCode CLI 凭证注册

Windows 用户可能出现因为缺少 VC 运行库而无法运行的问题，请下载并安装此软件。

在修改配置文件之前，您需要在本地密钥管理器中注册一个提供商别名（Provider ID）。此步骤确保 API Key 的安全存储，防止其以明文形式硬编码在配置文件中。执行认证命令：

opencode auth login

选择类型：在列表底部找到并选择”other”（可直接输入搜索）。
定义 ID：输入”local”。输入 Key：填入您从 x6.ai 创建的令牌 API Key（sk-xxxx）。

配置 OpenCode

OpenCode 使用 opencode.json 文件解析提供商参数。请根据您的操作系统找到并创建/编辑该文件。编辑或创建 opencode.json 文件macOS 和 Linux：~/.config/opencode/opencode.jsonWindows：C:\Users\<USERNAME>\.config\opencode\opencode.json配置文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "local": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "local",
      "options": {
        "baseURL": "https://api.x6.ai/v1"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5"
        },
        "gemini-3.1-pro-preview": {
          "name": "gemini-3.1-pro-preview"
        },
        "claude-opus-4.7": {
          "name": "claude-opus-4.7"
        }
      }
    }
  }
}

npm：使用 @ai-sdk/openai-compatible 适配 OpenAI 兼容协议。baseURL：填入 x6.ai 平台的 API 端点。models：需要手动声明支持 OpenAI 兼容协议的模型列表。Key 必须与实际的 Model ID 对应。

加载并验证 OpenCode

启动主程序：

opencode

在交互式提示中输入以下命令打开模型菜单：/models

如果配置正确，您将看到其模型列表。

编程智能体

应用场景

OpenCode 简介

步骤

​OpenCode 简介

​步骤

OpenCode 简介

步骤