LAYSO

简体中文

English

简体中文

English

切换主题

OpenCode 配置 ​

OpenCode ↗ 是一款开源的 AI 编程智能体，可在终端、桌面客户端和 IDE 中使用。下面通过 OpenCode 官方的自定义 Provider 方式接入 LAYSO AI。

一个 Key，访问全平台模型

模型按照 LAYSO AI 模型与价格 页面显示的当前价格计费。每个成功请求都有独立扣费明细，失败任务不会产生扣费。

配置步骤 ​

第 1 步：安装 OpenCode ​

macOS / Linux / WSL ​

推荐使用官方安装脚本：

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

也可以使用 npm 或 Homebrew：

bash
npm install -g opencode-ai
# 或
brew install anomalyco/tap/opencode

Windows ​

OpenCode 官方推荐在 Windows 上使用 WSL。也可以选择 npm、Chocolatey 或 Scoop：

powershell
npm install -g opencode-ai
# 或
choco install opencode
# 或
scoop install opencode

验证安装 ​

bash
opencode --version

能够正常显示版本号即表示安装完成。

第 2 步：获取 API Key 和模型 ID ​

  1. 前往 LAYSO AI API Key 页面 ↗ 创建并复制 API Key。
  2. 打开 LAYSO AI 模型与价格 ↗，选择模型并复制页面显示的完整模型 ID。

一个 LAYSO AI API Key 可以访问平台模型。不要猜测模型别名，也不要把真实 Key 写进项目文件或提交到 Git。

第 3 步：保存 API Key ​

启动 OpenCode：

bash
opencode

在终端界面输入：

text
/connect

按照下面的顺序完成设置：

  1. 在 Provider 列表底部选择 Other。
  2. Provider ID 输入 layso_ai。
  3. 粘贴从 LAYSO AI API Key 页面获取的完整 Key。

/connect 只负责保存凭据；仍需要在下一步的 opencode.json 中定义 Provider 和模型。Provider ID 必须与配置文件中的 layso_ai 完全一致。

为什么使用 /connect

OpenCode 会管理认证文件，无需手动把真实 Key 写进 opencode.json。再次运行 /connect 可以替换或删除已保存的凭据。

第 4 步：打开全局配置文件 ​

全局配置会对当前用户的所有项目生效：

系统配置文件位置
macOS/Users/<用户名>/.config/opencode/opencode.json
WindowsC:\Users\<用户名>\.config\opencode\opencode.json
Linux / WSL/home/<用户名>/.config/opencode/opencode.json

macOS、Linux 和 WSL 可以先创建目录：

bash
mkdir -p ~/.config/opencode

Windows PowerShell：

powershell
New-Item -ItemType Directory -Force "$HOME\.config\opencode"
notepad "$HOME\.config\opencode\opencode.json"

如果项目根目录也存在 opencode.json，项目配置会覆盖全局配置中的同名字段。排错时请同时检查这两个位置。

第 5 步：配置 LAYSO AI Provider ​

把 <MODEL_ID> 替换为 模型与价格页面 显示的完整模型 ID：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "layso_ai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LAYSO AI",
      "options": {
        "baseURL": "https://api.layso.ai/v1"
      },
      "models": {
        "<MODEL_ID>": {
          "name": "LAYSO AI Model"
        }
      }
    }
  },
  "model": "layso_ai/<MODEL_ID>"
}

这里使用 OpenAI Chat Completions 兼容方式，适用于 LAYSO AI 的 /v1/chat/completions。配置项含义如下：

配置项作用LAYSO AI 填写值
layso_ai自定义 Provider ID必须与 /connect 时填写的 ID 一致
npmOpenCode 的协议适配包@ai-sdk/openai-compatible
name模型选择器中的 Provider 名称LAYSO AI
options.baseURLOpenAI 兼容请求地址https://api.layso.ai/v1
modelsOpenCode 可选择的模型目录使用模型价格页上的完整模型 ID
model默认模型layso_ai/<MODEL_ID>

第 6 步：验证配置 ​

先确认 OpenCode 已识别 Provider 和模型：

bash
opencode models layso_ai

再执行一次非交互测试：

bash
opencode run --model "layso_ai/<MODEL_ID>" "请用一句话介绍自己"

也可以直接启动终端界面：

bash
opencode

输入 /models，选择 LAYSO AI 下的模型，然后发送一条简短任务。请求成功后，到 LAYSO AI 任务明细核对模型、Token 与扣费记录。

添加多个模型 ​

一个 Provider 可以登记多个模型。下面分别设置主模型和快速模型：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "layso_ai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LAYSO AI",
      "options": {
        "baseURL": "https://api.layso.ai/v1"
      },
      "models": {
        "<PRIMARY_MODEL_ID>": {
          "name": "LAYSO AI Primary"
        },
        "<FAST_MODEL_ID>": {
          "name": "LAYSO AI Fast"
        }
      }
    }
  },
  "model": "layso_ai/<PRIMARY_MODEL_ID>",
  "small_model": "layso_ai/<FAST_MODEL_ID>"
}

model 是默认主模型，small_model 用于标题生成等轻量任务。两者都必须写成 Provider ID/模型 ID。

使用环境变量配置 Key ​

如果不希望使用 /connect 保存凭据，也可以让 Provider 从环境变量读取 Key：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "layso_ai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LAYSO AI",
      "options": {
        "baseURL": "https://api.layso.ai/v1",
        "apiKey": "{env:LAYSO_API_KEY}"
      },
      "models": {
        "<MODEL_ID>": {
          "name": "LAYSO AI Model"
        }
      }
    }
  },
  "model": "layso_ai/<MODEL_ID>"
}

macOS / Linux / WSL ​

bash
export LAYSO_API_KEY="sk-..."
opencode

Windows PowerShell ​

powershell
$env:LAYSO_API_KEY = "sk-..."
opencode

环境变量只对当前终端会话生效。需要长期使用时，可写入操作系统的用户级安全环境配置，但不要把真实 Key 写进项目级 .env 或提交到仓库。

Responses API 配置 ​

如果所选模型或功能明确要求 OpenAI Responses API，可以把适配包改为 @ai-sdk/openai，Base URL 仍为 https://api.layso.ai/v1：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "layso_responses": {
      "npm": "@ai-sdk/openai",
      "name": "LAYSO AI Responses",
      "options": {
        "baseURL": "https://api.layso.ai/v1",
        "apiKey": "{env:LAYSO_API_KEY}"
      },
      "models": {
        "<MODEL_ID>": {
          "name": "LAYSO AI Responses Model"
        }
      }
    }
  },
  "model": "layso_responses/<MODEL_ID>"
}

使用 /connect 时，Provider ID 也必须填写 layso_responses。如果不确定模型应该使用哪种协议，先使用前面的 OpenAI 兼容配置。

项目级配置 ​

如果某个项目需要固定模型，可在项目根目录创建 opencode.json：

json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "layso_ai/<MODEL_ID>"
}

项目配置会与全局配置合并，因此无需重复写 Provider 和 Key。不要在项目配置中加入真实 API Key。

推荐模型 ​

推荐模型以 LAYSO AI 模型与价格 ↗ 页面为准。选择时重点关注：

使用场景优先考虑
日常代码修改响应速度、工具调用、价格
大型仓库分析上下文长度、代码理解能力
复杂重构与排错推理能力、工具调用稳定性
高频轻量任务低延迟、低价格

不要直接照搬其他平台的模型别名；OpenCode 配置中的模型 ID 必须与 LAYSO AI 模型价格页完全一致。

常用命令 ​

命令用途
opencode启动终端界面
/connect添加、替换或删除 Provider 凭据
/models在终端界面选择模型
/init为当前项目创建或更新 AGENTS.md
opencode models layso_ai列出 LAYSO AI Provider 的模型
opencode run "任务"执行一次非交互任务

认证与排查 ​

401 / 403 认证失败 ​

  • 重新运行 /connect，确认 Provider ID 是 layso_ai。
  • 重新粘贴完整 API Key，检查是否包含空格、换行或缺失字符。
  • 如果使用环境变量，确认启动 OpenCode 的终端能够读取 LAYSO_API_KEY。

404 或请求地址错误 ​

确认 options.baseURL 是 https://api.layso.ai/v1。不要重复追加 /v1，也不要在这里填写 /chat/completions 或 /responses 的完整端点。

Provider 或模型不显示 ​

  1. 确认全局文件名是 opencode.json 或 opencode.jsonc。
  2. 确认配置使用 provider，不是旧教程中的 providers 或 TOML 格式。
  3. 确认 models 是以模型 ID 为键的对象。
  4. 检查项目根目录的 opencode.json 是否覆盖了全局配置。
  5. 运行 opencode models layso_ai --refresh 刷新模型列表。

模型不存在 ​

确认以下三处完全一致：

  1. provider.layso_ai.models 中的模型键。
  2. 默认模型 layso_ai/<MODEL_ID> 中的 <MODEL_ID>。
  3. LAYSO AI 模型与价格页面 显示的完整模型 ID。

工具调用异常 ​

先更换为模型价格页中明确支持工具调用的模型，再用简短任务测试。不同模型的工具调用、图片输入和上下文能力可能不同。

计费与安全 ​

  • 一个 LAYSO AI API Key 可以访问全平台模型。
  • 每个成功请求都能在任务明细中查看模型、Token 与逐笔扣费。
  • 失败任务不会产生扣费。
  • 不要在截图、日志、项目配置或 Git 仓库中暴露完整 API Key。

LAYSO AI API 文档

MIT 2026 © LAYSO AI