OpenCode

专为终端打造的开源编码代理

OpenCode (SST) OpenAI 兼容格式 macOSLinuxWindows

OpenCode 是开源的终端 AI 编码代理，底层用 AI SDK + Models.dev 支持 75+ provider 与本地模型。它自带 TUI、可脚本化的 CLI 与 IDE 扩展，适合希望在终端完成多步任务、又能自定义任意 OpenAI 兼容端点的工程师。

网关 base_url（国内站）https://api.shinloo.com/v1填到各工具的 base_url / OPENAI_BASE_URL / apiBase 之类设置里。OpenAI 线路填 /v1；Anthropic / Gemini 线路填网关根 https://api.shinloo.com。

OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsOpenAI 线路的客户端用这个地址（GET /v1/models 可查你的 Key 可用模型）。

推荐模型（国内站已开通）deepseek-v4.1-flashqwen3.8-max-0902glm-5.3以上为本站公示的模型名，实际可用清单以你的 Key 调 GET /v1/models 返回为准。

省事版 — 一键接入

脚本从 OpenCode 的官方来源安装，把网关配置写进工具自己的配置文件（写之前先备份原文件），再发一次真请求验证。会提示你粘贴网关 Key（也可用 --key 传入）； --uninstall 只还原它写进去的内容。

shell

curl -fsSL https://api.shinloo.com/agents/opencode/setup | bash

1 · 安装

从 OpenCode 自己的官方来源安装。

安装

curl -fsSL https://opencode.ai/install | bash   # macOS/Linux；跨平台可用 npm install -g opencode-ai

2 · 配置 — 指向国内站网关

网关 base URL https://api.shinloo.com/v1；Key 在控制台创建。

配置

1) 在 TUI 里运行 /connect，滚到底部选 Other，输入一个 provider id（如 quantoport）和你的 API Key（存放在 ~/.local/share/opencode/auth.json）。
2) 在项目的 opencode.json，或全局 ~/.config/opencode/opencode.json 中加入该 provider：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "quantoport": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "玺芮算力",
      "options": { "baseURL": "https://api.shinloo.com/v1" },
      "models": { "<model-id>": { "name": "<Model name>" } }
    }
  }
}

3) 运行 /models 选择该模型。

3 · 验证

发一次请求，能返回就说明走的是国内站网关。

验证

opencode run "reply with OK"      # 或 opencode auth list 查看凭证

4 · 常见坑

baseURL 必须带上 /v1 版本段。
npm 字段用 @ai-sdk/openai-compatible（走 /v1/chat/completions）；仅当网关用 /v1/responses 时才用 @ai-sdk/openai。
全局 ~/.config/opencode/opencode.json 与项目 opencode.json 会合并，后加载者覆盖冲突键；也可用 OPENCODE_CONFIG 指定自定义配置。
opencode auth login 等价于 /connect；凭证存在 ~/.local/share/opencode/auth.json。

工具侧步骤的官方来源： opencode.ai/docs/providers/ opencode.ai/docs/config/ opencode.ai/docs/cli/ opencode.ai/docs/