lxai 文档

Appearance

OpenCode 配置指南 ​

适用场景：希望在终端中使用 OpenCode，并通过 lxai 接入 GPT、Claude、Gemini 等模型的用户。

你会得到什么：

  • OpenCode 的安装方法
  • lxai 的配置方式
  • GPT / Claude / Gemini 三类模型的正确写法
  • 一份可直接照抄的最小可用配置
  • 常见报错排查方法

0. OpenCode 和 Claude Code CLI / Codex CLI 有什么区别 ​

  • Claude Code CLI / Codex CLI / Gemini CLI：更像是单一模型厂商推出的官方客户端
  • OpenCode：更像是一个统一的 AI 编码工作台 / 终端容器

一句话理解 ​

  • Claude Code CLI：最适合把 Anthropic 生态用到最深
  • Codex CLI：最适合把 OpenAI / Codex 生态用到最深
  • Gemini CLI：最适合直接使用 Google / Gemini 生态
  • OpenCode：最适合在一个终端工具里统一接入 GPT / Claude / Gemini，并按需要切换 provider、模型和编排方式

只深用单一模型 → 优先官方 CLI；想统一接入多模型并长期扩展 → 优先 OpenCode。

1. 安装 OpenCode ​

bash
npm install -g opencode-ai

安装完成后，检查是否成功：

bash
opencode --help

如果你的环境里 opencode 命令还没进 PATH，通常重新打开一个终端窗口即可。

2. 在 lxai 创建 API Key ​

  1. 打开 lxai 控制台 - 令牌管理
  2. 新建一个令牌
  3. 建议设置：
    • 名称：例如 opencode
    • 过期时间：建议选 永不过期
    • 额度：按你的预算设置
    • IP 白名单：没有固定出口时先留空
  4. 复制生成的 sk- 开头令牌

如果你后面准备分别给 GPT / Claude / Gemini 配不同分组，也可以为不同用途创建不同 token。

3. OpenCode 配置文件放哪里 ​

OpenCode 的主配置文件：

bash
~/.config/opencode/opencode.json

如果目录不存在，先创建：

bash
mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json

4. 最小可用配置（推荐先跑通这个） ​

先用一份最小配置跑通，再逐步加模型。

json
{
  "$schema": "https://opencode.ai/config.json",
  "autoupdate": true,
  "permission": "allow",
  "provider": {
    "lxai": {
      "name": "lxai GPT",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "你的lxai令牌",
        "baseURL": "https://www.lxai.pro/v1"
      },
      "models": {
        "gpt-5.4": {
          "id": "gpt-5.4",
          "name": "GPT-5.4"
        }
      }
    }
  },
  "tools": {
    "bash": true,
    "edit": true,
    "glob": true,
    "grep": true,
    "read": true,
    "write": true
  }
}

这份配置里最重要的 4 个点 ​

1) apiKey — 填你在 lxai 控制台创建的 token：

json
"apiKey": "sk-xxxxxxxx"

2) baseURL — 走 OpenAI-compatible 协议时必须带 /v1：

json
"baseURL": "https://www.lxai.pro/v1"

3) models — 声明 OpenCode 可以使用的模型。

4) tools — 如果你希望 OpenCode 能读写文件、搜索代码、执行命令，建议把这些工具打开。

5. GPT / Claude / Gemini 分别怎么配 ​

核心原则：

  • GPT 类模型 → 走 OpenAI-compatible
  • Claude 类模型 → 走 Anthropic 协议
  • Gemini 类模型 → 走 Google 协议

5.1 配 GPT（推荐） ​

json
{
  "provider": {
    "lxai-openai": {
      "name": "lxai GPT",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "你的API密钥",
        "baseURL": "https://www.lxai.pro/v1"
      },
      "models": {
        "gpt-5.4": {
          "id": "gpt-5.4",
          "name": "GPT-5.4"
        },
        "gpt-5.3-codex": {
          "id": "gpt-5.3-codex",
          "name": "GPT-5.3-Codex"
        }
      }
    }
  }
}

5.2 配 Claude ​

json
{
  "provider": {
    "lxai-claude": {
      "name": "lxai Claude",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "你的API密钥",
        "baseURL": "https://www.lxai.pro"
      },
      "models": {
        "claude-4-5-sonnet-20250929": {
          "id": "claude-4-5-sonnet-20250929",
          "name": "Claude Sonnet 4.5"
        },
        "claude-4-5-opus": {
          "id": "claude-4-5-opus",
          "name": "Claude Opus 4.5"
        }
      }
    }
  }
}

注意: Claude 的 baseURL 不带 /v1，即 https://www.lxai.pro。

5.3 配 Gemini ​

json
{
  "provider": {
    "lxai-gemini": {
      "name": "lxai Gemini",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "你的API密钥",
        "baseURL": "https://www.lxai.pro/v1"
      },
      "models": {
        "gemini-2.5-pro": {
          "id": "gemini-2.5-pro",
          "name": "Gemini 2.5 Pro"
        },
        "gemini-3-pro-preview": {
          "id": "gemini-3-pro-preview",
          "name": "Gemini 3 Pro Preview"
        }
      }
    }
  }
}

5.4 三个 provider 合并配置 ​

json
{
  "$schema": "https://opencode.ai/config.json",
  "autoupdate": true,
  "permission": "allow",
  "provider": {
    "lxai-openai": {
      "name": "lxai GPT",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "你的API密钥",
        "baseURL": "https://www.lxai.pro/v1"
      },
      "models": {
        "gpt-5.4": {"id": "gpt-5.4", "name": "GPT-5.4"}
      }
    },
    "lxai-claude": {
      "name": "lxai Claude",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "你的API密钥",
        "baseURL": "https://www.lxai.pro"
      },
      "models": {
        "claude-4-5-sonnet-20250929": {"id": "claude-4-5-sonnet-20250929", "name": "Claude Sonnet 4.5"}
      }
    },
    "lxai-gemini": {
      "name": "lxai Gemini",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "apiKey": "你的API密钥",
        "baseURL": "https://www.lxai.pro/v1"
      },
      "models": {
        "gemini-2.5-pro": {"id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro"}
      }
    }
  },
  "tools": {
    "bash": true,
    "edit": true,
    "glob": true,
    "grep": true,
    "read": true,
    "write": true
  }
}

6. 验证配置 ​

保存配置文件后，在项目目录下运行：

bash
opencode

启动后 OpenCode 会进入交互式界面，尝试输入一条指令验证连接是否正常。

7. 常见问题 ​

报错 provider not found 或 model not found?

检查配置文件中 provider 和 models 的 key 拼写，确保和 id 字段一致。

Claude 报 401 / 403?

确认 baseURL 是 https://www.lxai.pro（不带 /v1），且 apiKey 格式为 sk- 开头。

GPT 报 404?

确认 baseURL 是 https://www.lxai.pro/v1（带 /v1）。

配置文件改了没有生效?

重新启动 OpenCode 进程。配置文件在启动时读取，运行时修改不会热重载。

额度不足

登录 lxai 控制台 检查余额，必要时充值。

一个 API Key，解锁全球顶级 AI 大模型

Copyright © 2026 lxai