OpenCode 一键配置安装教程

一条命令安装 OpenCode，并同时接入AI驿站的 Claude 和 GPT。默认模型 aizhan-claude/claude-opus-5-5，推理强度中档（medium）。

1. 运行一键配置命令

macOS / LinuxWindows PowerShell

bash

curl -fsSL https://docs.aizhan.space/sh/opencode.sh | bash

powershell

irm https://sh.api.aizhan.space/opencode.ps1 | iex

菜单：1 安装 OpenCode、2 配置AI驿站 (Claude + GPT)、3 一键全部安装（第一次用选这个）。

2. 安装方式

macOS / Linux：优先用官方安装脚本（下载独立程序到 ~/.opencode/bin，不需要 Node.js）；失败时改用 npm i -g opencode-ai@latest，再失败切换国内镜像。
Windows：OpenCode 没有官方 PowerShell 安装器，脚本依次尝试 npm、国内镜像、scoop。需要先装 Node.js：安装 Node.js。
新版 npm（11+）默认不执行全局包的安装脚本，会导致 OpenCode 装好却运行不了；一键脚本已自动处理。手动安装时请用：npm i -g opencode-ai@latest --allow-scripts=opencode-ai。

关于两把 Key

Claude 和 GPT 在官网是不同的令牌分组。脚本会先让你选择要配置的模型家族（1 Claude + GPT（回车默认）/ 2 仅 Claude / 3 仅 GPT），然后依次输入：

Claude 分组 API Key
GPT 分组 API Key（直接回车 = 与 Claude Key 相同）

每把 Key 都会先用 /v1/models 验证，并拉取这个分组下可用的模型列表一起写进配置。

报错 "Requests from the ... framework are not supported"

说明你的 Claude Key 所在令牌分组只允许 Claude 官方客户端使用。请到 api.aizhan.space 在允许第三方工具的分组下新建令牌，然后重新运行脚本选「2) 配置」。

3. 脚本会写哪些文件

配置文件：~/.config/opencode/opencode.json（Windows 为 %USERPROFILE%\.config\opencode\opencode.json；如已有 opencode.jsonc 则写它；设置了 OPENCODE_CONFIG / OPENCODE_CONFIG_DIR 时以它们为准）。

json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aizhan-claude/claude-opus-5-5",
  "provider": {
    "aizhan-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI驿站 Claude",
      "options": { "baseURL": "https://api.aizhan.space/v1", "apiKey": "sk-你的Claude Key" },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5",
          "limit": { "context": 1000000, "output": 128000 },
          "options": { "thinking": { "type": "adaptive", "display": "summarized" }, "effort": "medium" }
        }
      }
    },
    "aizhan-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "AI驿站 GPT",
      "options": { "baseURL": "https://api.aizhan.space/v1", "apiKey": "sk-你的GPT Key" },
      "models": {
        "gpt-6.1-sol": {
          "name": "GPT-6.1 Sol",
          "limit": { "context": 1050000, "output": 128000 },
          "options": { "reasoningEffort": "medium", "reasoningSummary": "auto" }
        }
      }
    }
  }
}

注意：OpenCode 的 Claude 地址要带 /v1，这一点和其他工具不同。
OpenCode 没有全局的推理强度设置，所以写在每个模型的 options 里；会话中按 Ctrl+T 或命令行 --variant high 可以临时切换。
你原有的其他 provider、插件等配置都会保留；改动前备份为 opencode.json.bak.时间戳。如果原文件里有注释，会被去掉（原文件已备份）。

4. 验证与使用

bash

opencode run -m aizhan-claude/claude-opus-5-5 "Reply with exactly: OK"
opencode run -m aizhan-gpt/gpt-6.1-sol "Reply with exactly: OK"

启动：opencode
会话中切换模型：输入 /models 选择
默认改成 GPT：把配置里的 "model" 改为 "aizhan-gpt/gpt-6.1-sol"
项目目录里的 opencode.json 会覆盖全局默认模型，这是 OpenCode 本身的规则。

5. 回滚

把 opencode.json.bak.时间戳 改回原文件名即可。

OpenCode 一键配置安装教程 ​

1. 运行一键配置命令 ​

2. 安装方式 ​

关于两把 Key ​

3. 脚本会写哪些文件 ​

4. 验证与使用 ​