OpenCode自定义模型配置全攻略：公益站与本地代理接入指南

TL;DR

• 5个公益站：GSCC Relay、WZW、AnyRouter、DuckCoding Free、Huan666
• 三种接入方式：公益站直连、本地代理转发、自定义供应商
• 核心价值：突破官方限制,零成本体验 Claude Code
• 配置难度：简单版5分钟,完整版15分钟

公益站推荐

如果你没有官方 API,可以试试这些经过社区验证的公益站。

公益站点一览

商业站点推荐

各站点详细介绍

GSCC Relay

地址: https://gsccrelay.space

特点:
– 不支持注册,最简洁的公益站
– API Key 通过官方公告/社区发放
– 适合临时体验用户

获取方式: 关注站点公告或相关社区,定期发放公共 API Key

OpenCode 配置:

"baseURL": "https://gsccrelay.space/v1"

WZW (de5.net)

地址: https://wzw.de5.net

特点:
– 仅支持 Linux.do 账号注册
– 基于 NewAPI 搭建,界面友好
– 支持多模型聚合

注册条件: 需要 Linux.do 论坛账号,通过 OAuth 登录

OpenCode 配置:

"baseURL": "https://wzw.pp.ua/v1"

AnyRouter

地址: https://anyrouter.top

特点:
– 纯公益站,专注 Claude Code 中转
– 新用户注册送 $50,邀请链接可获 $100
– 每日签到送 $25,长期使用成本极低
– 支持教育邮箱或 Linux.do 账号注册

支持模型:
– claude-sonnet-4-20250514
– claude-opus-4 等主流模型

OpenCode 配置:

"baseURL": "https://anyrouter.top/v1"

注意: 公益站不保证 100% 稳定性,建议非敏感项目使用

DuckCoding Free

地址: https://free.duckcoding.com

官方文档: https://doc.duckcoding.com

特点:
– 原 InstCopilot API,更名后功能更强
– 仅支持 Linux.do 账号注册
– 文档完善,新手友好
– 主站还提供付费服务(1:1汇率)

公益分组:
– Claude Code 专用: 0.2倍率(特定时段)
– 适合轻度使用和学习探索

OpenCode 配置:

"baseURL": "https://free.duckcoding.com/v1"

Huan666

地址: https://ai.huan666.de

特点:
– 仅支持 Linux.do 账号注册
– 模型种类丰富,覆盖 Claude 全系、DeepSeek、Grok、Kimi 等
– 价格透明,按 token 计费
– 支持最新 Grok 4 系列和 Kimi-K2 模型

支持模型及价格:

亮点: Grok 4 系列价格极低($0.01/M),适合大量调用场景

OpenCode 配置:

"baseURL": "https://ai.huan666.de/v1"

方案一：简单粗暴版(推荐新手)

这是最快的方式,5分钟搞定,适合只想用起来的人。

步骤1: 登录认证

opencode auth login

选择 Anthropic → 选择 Manually enter API Key → 输入你的 API Key

这个 Key 从哪来?

• 公益站: 注册后在控制台复制
• 中转站: 部署完成后自动生成
• 本地代理: CLIProxyAPI 启动后显示

步骤2: 修改配置文件

打开 opencode.json:

• macOS: ~/.config/opencode/opencode.json
• Windows: %APPDATA%opencodeopencode.json
• Linux: ~/.config/opencode/opencode.json

在 provider 字段里插入这段:

"provider": {
  "anthropic": {
    "options": {
      "baseURL": "你的API地址/v1"
    }
  }
}

注意: 大部分渠道需要在 URL 后面加 /v1,比如:

• WONG公益站: https://wzw.pp.ua/v1
• AnyRouter: https://anyrouter.top/v1
• 本地代理: http://127.0.0.1:8317/v1

步骤3: 修改模型名称

公益站和中转站的模型名可能和官方不一样,需要手动改一下。

在 opencode.json 里找到或添加:

"model": "anthropic/claude-sonnet-4-5-20250929"

常见模型名对照:

步骤4: 配置 oh-my-opencode(可选)

如果你装了 oh-my-opencode,还需要改它的配置文件:

• macOS: ~/.config/opencode/oh-my-opencode.json

把里面所有 claude-* 模型名都改成:

"model": "anthropic/claude-sonnet-4-5-20250929"

验证

重启 OpenCode,随便问个问题,能正常回复就说明配置成功了。

方案二：自定义供应商版(推荐进阶)

这个方式更灵活,可以同时配置多个渠道,随时切换。

步骤1: 添加自定义供应商

opencode auth login

选择 Other → 输入供应商ID(比如 test,全小写英文) → 输入 API Key

步骤2: 完整配置供应商

打开 opencode.json,在 provider 里加入:

"provider": {
  "test": {
    "npm": "@ai-sdk/anthropic",
    "name": "我的公益站",
    "options": {
      "baseURL": "https://你的API地址/v1"
    },
    "models": {
      "claude-sonnet-4-5-20250929": {
        "name": "Claude 4.5 Sonnet",
        "attachment": true,
        "limit": {
          "context": 1048576,
          "output": 65535
        },
        "modalities": {
          "input": ["text", "image"],
          "output": ["text"]
        }
      },
      "claude-opus-4-5-20251101": {
        "name": "Claude 4.5 Opus",
        "attachment": true,
        "limit": {
          "context": 1048576,
          "output": 65535
        },
        "modalities": {
          "input": ["text", "image"],
          "output": ["text"]
        }
      }
    }
  }
}

步骤3: 指定使用的模型

"model": "test/claude-sonnet-4-5-20250929"

注意这里的 test 要和你第一步输入的供应商ID一致。

多渠道配置示例

如果你有多个API渠道,可以这样配置:

"provider": {
  "wong": {
    "npm": "@ai-sdk/anthropic",
    "name": "WONG公益站",
    "options": {
      "baseURL": "https://wzw.pp.ua/v1"
    },
    "models": { /* 模型配置 */ }
  },
  "anyrouter": {
    "npm": "@ai-sdk/anthropic",
    "name": "AnyRouter",
    "options": {
      "baseURL": "https://anyrouter.top/v1"
    },
    "models": { /* 模型配置 */ }
  }
}

切换渠道只需要改 model 字段:

"model": "wong/claude-sonnet-4-5-20250929"  // 使用WONG
"model": "anyrouter/claude-sonnet-4-5-20250929"  // 使用AnyRouter

方案三：本地代理转发(推荐高级用户)

如果你用的是 Antigravity 或其他需要本地代理的服务,可以用 CLIProxyAPI 搭建本地转发。

为什么要用本地代理

• 统一管理多个 API 渠道的额度
• 方便调试和监控流量
• 支持自定义模型映射
• 可以同时接入 Claude、Gemini 等多个模型

安装 CLIProxyAPI

# 克隆项目
git clone https://github.com/router-for-me/CLIProxyAPI
cd CLIProxyAPI

# 安装依赖
npm install

# 启动服务
npm start

服务启动后会监听 8317 端口,访问 http://localhost:8317/management.html#/quota 可以查看配额使用情况。

配置 CLIProxyAPI

配置文件主要包含这几个参数:

{
  "port": 8317,
  "apiKey": "your-antigravity-api-key",
  "baseURL": "https://api.antigravity.com/v1",
  "models": {
    "claude-sonnet-4-5": "claude-sonnet-4-5-20250929",
    "claude-opus-4-5": "claude-opus-4-5-20251101",
    "gemini-2.5-flash": "gemini-2.5-flash"
  }
}

参数说明:

• port: 监听端口,默认 8317
• apiKey: 你的 Antigravity API Key
• baseURL: Antigravity 的 API 端点
• models: 模型名称映射,把 Antigravity 的模型名映射成 OpenCode 认识的格式

配置 OpenCode

打开 ~/.config/opencode/opencode.json,配置指向本地代理:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "quotio": {
      "name": "Quotio",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "quotio-local-********",
        "baseURL": "http://127.0.0.1:8317/v1"
      },
      "models": {
        "claude-sonnet-4-5-20250929": {
          "name": "Claude Sonnet 4.5",
          "limit": {
            "context": 200000,
            "output": 64000
          }
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash",
          "limit": {
            "context": 1048576,
            "output": 65536
          }
        }
      }
    }
  },
  "model": "quotio/claude-sonnet-4-5-20250929"
}

注意事项:

• apiKey 填 CLIProxyAPI 生成的本地 Key(格式: quotio-local-********)
• baseURL 指向本地代理地址 http://127.0.0.1:8317/v1
• 模型名称必须和 CLIProxyAPI 配置里的映射对应

验证配置

# 测试代理服务
curl http://127.0.0.1:8317/v1/models

# 测试 OpenCode
opencode chat "测试连接"

如果能正常返回,说明整个链路打通了。

公益站推荐

如果你没有官方 API,可以试试这些经过社区验证的公益站。

公益站点一览

各站点详细介绍

GSCC Relay

地址: https://gsccrelay.space

特点:
– 不支持注册,最简洁的公益站
– API Key 通过官方公告/社区发放
– 适合临时体验用户

获取方式: 关注站点公告或相关社区,定期发放公共 API Key

OpenCode 配置:

"baseURL": "https://gsccrelay.space/v1"

常见问题

Q1: 提示 401 Unauthorized

原因: API Key 无效或已过期

解决:
1. 检查 Key 是否正确复制(无多余空格)
2. 确认 Key 未过期
3. 尝试重新获取 Key

Q2: 连接超时

原因: 网络问题或站点维护

解决:
1. 检查网络连接
2. 尝试切换其他公益站
3. 查看站点公告确认是否维护中

Q3: 模型调用报错

原因: 模型名称不匹配

解决:
1. 检查 opencode.json 里的模型名和 API 渠道的模型名是否一致
2. 确认你的账号有对应模型的权限
3. 查看 API 渠道的文档确认正确的模型名

Q4: 某些公益站提示禁止使用

原因: 部分平台(如 88code、WONG 的 Claude Code 专属分组)禁止非官方客户端

解决:
– WONG 可以用 default 分组,但倍率是 1 倍
– 切换到其他不限制的公益站
– 使用本地代理方式可能绕过部分检测

Q5: 显示模型版本不对

比如用的是 Sonnet 4.5 但显示 3.7。

原因: 某些代理(如 CPA)内置了提示词干扰

影响: 无实际影响,只是显示问题

配置对比

实用技巧

持久化环境变量

如果不想每次都手动设置,可以写入 shell 配置文件:

Bash 用户:

echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的key' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL=https://你的API地址' >> ~/.bashrc
source ~/.bashrc

Zsh 用户:

echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的key' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL=https://你的API地址' >> ~/.zshrc
source ~/.zshrc

快速切换配置

如果你有多个配置,可以用脚本快速切换:

#!/bin/bash
# opencode-switch.sh

case $1 in
  wong)
    export ANTHROPIC_BASE_URL=https://wzw.pp.ua/v1
    ;;
  anyrouter)
    export ANTHROPIC_BASE_URL=https://anyrouter.top/v1
    ;;
  local)
    export ANTHROPIC_BASE_URL=http://127.0.0.1:8317/v1
    ;;
  *)
    echo "Usage: $0 {wong|anyrouter|local}"
    exit 1
    ;;
esac

echo "Switched to $1"
opencode

使用方式:

chmod +x opencode-switch.sh
./opencode-switch.sh wong  # 切换到 WONG

总结

OpenCode 的自定义配置虽然繁琐,但掌握方法后就很简单了:

1. 新手: 用简单粗暴版,5分钟搞定
2. 进阶: 用自定义供应商,支持多渠道切换
3. 高级: 用本地代理,统一管理所有 API

配置完成后,OpenCode 的体验还是很不错的:

• UI 炫酷,操作流畅
• 自动识别 Claude Code 的 skill
• 内置 ralph 防止会话终止
• 支持多模型切换

如果公益站和中转站能更好地对接进来,OpenCode 会成为更强大的 AI 编程工具。

参考资源

• OpenCode 官方文档 – OpenCode 配置说明
• CLIProxyAPI GitHub – 本地代理工具
• Claude Code 公益站汇总 – 公益站详细介绍
• Linux.do 社区 – 获取公益站账号

注意: 文中的 API Key 已脱敏,实际使用时替换成你自己的凭证。