opencode 小技巧

模型资源配置

两种途径把你的大模型接进 opencode：名录直连，或配置文件自定义。

为什么需要这一步

opencode 是 AI 编程工作台，本身不带模型——你用自己的模型资源（API Key），它替你干活。第一次使用前，把你的模型资源接进来即可。opencode 支持 75+ 家大模型供应商，下面两种途径任选其一。

途径一：名录直连（适合官方大厂资源）

如果你的供应商是 Anthropic、OpenAI、DeepSeek、MiniMax 这类在 opencode 供应商名录里的大厂，直接在 opencode 里完成连接：

打开 opencode，在输入框敲 /connect 回车（也可按 Ctrl+P 打开命令面板选择）
在名录里找到你的供应商，回车选中
按引导到供应商官网申请 API Key，粘贴回 opencode
敲 /models，选中你要用的模型——完成

这条路最省事，密钥由 opencode 统一保管（存在你本机的 auth.json 里）。

途径二：配置文件（名录外的供应商/中转站）

如果你用的供应商或中转站不在名录里，或需要指定自定义接口地址、模型清单，就写全局配置文件。很多人知道有这个文件，却东查西查凑不出一份能跑的配置——这里给你一份带注释的完整打样，照着填空即可。

文件在哪

系统	路径
macOS / Linux	`~/.config/opencode/opencode.json`
Windows	`C:\Users\你\.config\opencode\opencode.json`

文件名也可用 opencode.jsonc——支持写 // 注释（下面的模板就带着注释，建议存成 .jsonc）。改完保存，重启 opencode 生效。

完整打样（三类写法各一段，任选或组合）

模型资源的接口协议大体分三类：Anthropic 系（Claude 类模型）、OpenAI 系（GPT 官方协议端点）、OpenAI 兼容系（各家用 OpenAI 格式的端点，Grok/GLM/DeepSeek 中转等常见）。下面一个模板装了三段示例，复制走之后删掉用不到的段，把占位内容换成你的真实信息：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    // ============ 第一类：Anthropic 系（Claude 类模型） ============
    "my-claude": {
      // 接口协议包——Anthropic 系固定用这个，照抄
      "npm": "@ai-sdk/anthropic",
      "options": {
        // 供应商给你的接口地址（用 Anthropic 官方直连可删掉本行）
        "baseURL": "https://你的供应商地址/anthropic/v1",
        // 供应商给你的 API Key
        "apiKey": "sk-你的密钥",
        // 超时三件套（毫秒·可选）：思考型模型建议调大，防止思考途中被掐断
        "timeout": 43200000,
        "headerTimeout": 43200000,
        "chunkTimeout": 43200000
      },
      "models": {
        // 模型 ID——必须与供应商文档里的写法完全一致
        "claude-sonnet-5": {
          // 显示名（可选·在 /models 列表里更好认）
          "name": "Claude Sonnet 5",
          // 思考型（推理）模型标 true
          "reasoning": true,
          // 上下文窗口 / 最大输出（token 数）——按供应商标称填
          "limit": { "context": 1000000, "output": 128000 }
        }
      }
    },

    // ============ 第二类：OpenAI 系（GPT 官方协议端点） ============
    "my-gpt": {
      // 接口协议包——GPT 官方协议固定用这个
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://你的供应商地址/v1",
        "apiKey": "sk-你的密钥",
        "timeout": 43200000,
        "headerTimeout": 43200000,
        "chunkTimeout": 43200000
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4",
          "reasoning": true,
          // 该模型不支持自定义温度时标 false（GPT 推理系列常见）
          "temperature": false,
          "limit": { "context": 1050000, "output": 128000 }
        }
      }
    },

    // ============ 第三类：OpenAI 兼容系（Grok / GLM / DeepSeek 等中转常见） ============
    "my-relay": {
      // 接口协议包——凡「OpenAI 格式兼容」的端点都用这个
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://你的中转站地址/v1",
        "apiKey": "sk-你的密钥",
        "timeout": 43200000,
        "headerTimeout": 43200000,
        "chunkTimeout": 43200000
      },
      "models": {
        "grok-4.5": {
          "name": "Grok 4.5",
          "reasoning": true,
          "temperature": false,
          "limit": { "context": 500000, "output": 500000 }
        }
      }
    }
  }
}

字段速查

provider 下第一层键（如 my-claude）：自定义供应商标识，随意起名，会作为模型的前缀显示
npm：接口协议包，三类各对应一个，照抄不要改
baseURL：供应商给你的接口地址（用官方直连、且名录内已含的供应商可省略）
apiKey：供应商给你的密钥
timeout / headerTimeout / chunkTimeout：超时三件套（毫秒）。默认各 5 分钟；思考型模型建议调大，防止长时间思考途中被掐断
models 下的键：模型 ID，必须与供应商文档里的 ID 完全一致
reasoning：思考型（推理）模型标 true
temperature: false：该模型不支持自定义温度时标注（GPT 推理系列常见）
limit.context / limit.output：上下文窗口与最大输出 token 数，按供应商标称填，帮助 opencode 合理规划长任务

进阶：密钥不落配置文件如果不想把 API Key 明文写在配置里，可引用环境变量："apiKey": "{env:MY_PROVIDER_KEY}"——key 存在 shell 环境变量里，配置文件可以放心提交或分享。详见 opencode 官方文档。

隐私与安全

你的 API Key 只会保存在你自己的电脑上：途径一存在 ~/.local/share/opencode/auth.json，途径二存在你的配置文件里。Spiry 的安装器与插件不读取、不收集、不上传你的模型密钥。请像保管密码一样保管 key，不要提交进 git 仓库、不要贴进聊天窗口。

配好之后

重启 opencode，敲 /models 就能看到你配置的供应商与模型，选中即用。之后 Spiry 在每个环节的把关（需求体检、方案自审、收尾四态）都跑在你选定的模型上。