Agent 客户端配置大全

本页汇总 17 类主流 Agent / CLI / IDE 客户端接入 小关API 的配置方法。 所有配置都遵循同一套原则：换地址 + 换 key + 换模型名。

先记住三件事

1. Base URL 分两种协议，不能混用（见下方「协议对照」）。
2. 模型名用本站实际可用的：claude-opus-4-5、MiniMax-M3.1-Flash。
3. 教程里别人给的模型名（glm-5.2、kimi-k2.7-code 等）是上游商家的，小关API 上要用本站模型名。

协议对照（最容易踩的坑）

协议	Base URL	用于
Anthropic	https://api.yzgz.cn（不带 /v1）	Claude Code、Claude 桌面版、CC-Switch
OpenAI	https://api.yzgz.cn/v1（带 /v1）	Codex、Cherry Studio、Chatbox、OpenCode、Trae 等

危险

• 教程里 URL 以 /v1 结尾 → 用 OpenAI 协议
• 教程里 URL 不带 /v1 → 用 Anthropic 协议
• OpenAI 协议和 Anthropic 协议互不兼容，填错会 404 或报「找不到 chat/completions」

01｜Claude Code（CLI）

非 Windows 下只需改环境变量：

export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_BASE_URL=https://api.yzgz.cn
export API_TIMEOUT_MS=9000000
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export hasCompletedOnboarding=true
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

export ANTHROPIC_MODEL=claude-opus-4-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-opus-4-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-opus-4-5

claude

提示

• Windows 下请用 CC-Switch 配置 或桌面版，见 Claude Code 完整配置。
• 想要「跳过权限确认」可加 --dangerously-skip-permissions，请自行评估风险。

02｜CC-Switch 配置

CC-Switch 用来在多个供应商之间一键切换。下载：https://github.com/farion1231/cc-switch/releases。

添加自定义供应商，填入：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_BASE_URL": "https://api.yzgz.cn",
    "ANTHROPIC_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-opus-4-5"
  },
  "model": "sonnet"
}

终端版 Claude Code、桌面版 Claude Code 都用这份配置。

03｜Claude Code for VS Code

在 VS Code 的 settings.json 里填：

{
  "security.workspace.trust.untrustedFiles": "open",
  "claudeCode.environmentVariables": [
    {
      "claudeCode.preferredLocation": "panel",
      "claudeCode.environmentVariables": [
        { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" },
        { "name": "ANTHROPIC_BASE_URL", "value": "https://api.yzgz.cn" },
        { "name": "ANTHROPIC_MODEL", "value": "claude-opus-4-5" },
        { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-opus-4-5" },
        { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-4-5" },
        { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-opus-4-5" },
        { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "claude-opus-4-5" }
      ],
      "claudeCode.selectedModel": "claude-opus-4-5"
    }
  ],
  "claudeCode.preferredLocation": "panel",
  "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}

04｜Zcode

有两种接入方式。**如果使用时持续报错，请换另一种。**两种都是填 Base URL、key、模型名三样，按上方协议对照选择 /v1 或不带。

05｜Trae

Trae 用 OpenAI 协议：Base URL 填 https://api.yzgz.cn/v1，key 填 sk-...，模型名填 claude-opus-4-5 或 MiniMax-M3.1-Flash。

06｜Codex（已支持）

# ~/.codex/config.toml
model = "claude-opus-4-5"
model_provider = "xiaoguan"

[model_providers.xiaoguan]
name = "小关API"
base_url = "https://api.yzgz.cn/v1"
wire_api = "responses"

~/.codex/auth.json：

{ "OPENAI_API_KEY": "sk-你的密钥" }

注意

Codex 必须开启路由模式，否则每次请求都会重试 5 次。

07｜OpenCode

opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "xiaoguan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "小关API",
      "options": {
        "baseURL": "https://api.yzgz.cn/v1",
        "apiKey": "sk-你的密钥"
      },
      "models": {
        "claude-opus-4-5": {
          "name": "claude-opus-4-5",
          "limit": { "context": 200000, "output": 16384 }
        }
      }
    }
  }
}

08｜Cherry Studio 使用配置

Cherry Studio 用 OpenAI 协议，Base URL 填 https://api.yzgz.cn/v1。 完整图文步骤见 小白教程。

09｜Hermes Agent

Hermes Agent 通过 hermes model 配置，接入 OpenAI 兼容协议：

项	值
Base URL	https://api.yzgz.cn/v1
API Key	sk-你的密钥
Provider	custom (direct API)

hermes model

在 Select provider 中选 custom (direct API)。上下文长度可以不填，或填 200000。

完整安装与排错见 Hermes Agent 配置。

10｜OpenClaw

OpenClaw 用 OpenAI Completions 协议，建议通过 CC-Switch 添加供应商：

项	值
API 协议	OpenAI Completions
API 端点	https://api.yzgz.cn/v1
API Key	sk-你的密钥
发送 User-Agent	开启
模型 ID	分组下当前可用的模型名

完整安装与验证见 OpenClaw 配置。

11｜腾讯云的 Hermes

同上，填入本站 Base URL、key 与模型名即可。

12｜AutoClaw

点击左下角「配置」→「添加」，填入 Base URL、key、模型名。

13｜WorkBuddy

在设置 → 模型 → 添加模型 → 供应商选「自定义 / Custom」，填：

字段	值
接口地址	https://api.yzgz.cn/v1（必须带 /v1）
API KEY	sk-你的密钥
模型名称	分组下当前可用的模型名

完整步骤见 WorkBuddy 配置。

14｜Chatbox

Chatbox 用 OpenAI 协议。完整图文步骤见 小白教程。

15｜酒馆（SillyTavern，电脑端）

在酒馆的「API 连接」里选 OpenAI Chat Completion，填：

字段	值
Chat Completion Source	OpenAI
Custom Endpoint	https://api.yzgz.cn/v1
API Key	sk-你的密钥
Model	claude-opus-4-5

16｜酒馆（手机端）

手机端需要 Termux 环境。

第一步：安装 Termux

不要从 Google Play 商店安装

那个版本已停止维护，会导致失败。请从 F-Droid 或 GitHub releases 下载 APK。

第二步：在 Termux 里装环境

termux-change-repo     # 换到离你最近的镜像，连续回车即可
pkg update && pkg upgrade
pkg install git nodejs-lts

32 位系统可能还要装：

pkg install esbuild

第三步：下载并安装酒馆

git clone https://github.com/SillyTavern/SillyTavern -b release

网络不畅时换镜像：

git clone https://kkgithub.com/SillyTavern/SillyTavern -b release
# 或
git clone https://githubfast.com/SillyTavern/SillyTavern -b release

第四步：启动

cd SillyTavern
npm install
./start.sh

看到 SillyTavern is running on http://127.0.0.1:8000 就成功了。 用手机浏览器打开该地址（页面异常时试试 Edge 浏览器），滚到底部点「连接」。

17｜常见报错

报错 A：提示新版本不支持

在配置环境变量里增加：

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

或把插件降级到 2.0.55 版本。

报错 B：API Error: Failed to parse JSON

关掉代理，或更换网络。

报错 C：仍然在连官方域名

说明配置没被读取。检查配置文件路径和文件名是否正确，确认环境变量已 export 到当前 shell。

报错 D：一直重试 5 次

Codex 用户检查是否开了路由模式。

18｜查调用次数 / 额度

浏览器打开 https://api.yzgz.cn，登录后进入控制台的「日志」/「额度」页查看明细。

---

更多客户端见 客户端接入总览，常见问题见 [常见问题](../reference/faq/overview。