2026-01-07 · 工具
32
工具 · 2026-01-07

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

TL;DR


公益站推荐

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

公益站点一览

站点
地址
注册方式
免费额度
特点

GSCC Relay
gsccrelay.space
不支持注册
公告发放sk
最纯粹,无需账号

WZW
wzw.de5.net
Linux.do账号
注册即送
稳定可靠

AnyRouter
anyrouter.top
教育邮箱/Linux.do
$50-100
每日签到+25刀

DuckCoding Free
free.duckcoding.com
Linux.do账号
公益额度
文档完善

Huan666
ai.huan666.de
Linux.do账号
注册即送
模型丰富,含Grok/Kimi


商业站点推荐

站点
地址
注册方式
价格
特点

FoxCode
foxcode.rjj.cc
邮箱注册
按量付费
稳定商业服务

DuckCoding
duckcoding.com
邮箱注册
1:1汇率
专业付费服务

各站点详细介绍

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 模型

支持模型及价格:

模型
价格

claude-haiku-4-5-20251001
输入$1/M,输出$5/M

claude-sonnet-4-5-20250929
输入$3/M,输出$15/M

claude-opus-4-5-20251101
输入$5/M,输出$25/M

deepseek-r1 / deepseek-v3.1
$0.05-0.1/M

grok-4-fast / grok-4.1
$0.01/M

grok-4.1-thinking
$0.02/M

Kimi-K2 / Kimi-K2-Thinking
$0.1/M

GLM-4.5 / GLM-4.6
$0.1-0.2/M

亮点: 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 从哪来?

步骤2: 修改配置文件

打开 opencode.json:

provider 字段里插入这段:

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

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

步骤3: 修改模型名称

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

opencode.json 里找到或添加:

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

常见模型名对照:

官方名称
公益站/中转站名称

claude-sonnet-4.5
claude-sonnet-4-5-20250929

claude-opus-4.5
claude-opus-4-5-20251101

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

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

把里面所有 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 搭建本地转发。

为什么要用本地代理

安装 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"
  }
}

参数说明:

配置 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"
}

注意事项:

验证配置

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

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

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


公益站推荐

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

公益站点一览

站点
地址
注册方式
免费额度
特点

GSCC Relay
gsccrelay.space
不支持注册
公告发放sk
最纯粹,无需账号

WZW
wzw.de5.net
Linux.do账号
注册即送
稳定可靠

AnyRouter
anyrouter.top
教育邮箱/Linux.do
$50-100
每日签到+25刀

DuckCoding Free
free.duckcoding.com
Linux.do账号
公益额度
文档完善

Huan666
ai.huan666.de
Linux.do账号
注册即送
模型丰富,含Grok/Kimi

各站点详细介绍

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 的体验还是很不错的:

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


参考资源


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

目录 最新
← 左侧翻上一屏 · 右侧翻下一屏 · 中间唤出菜单