客户端配置

以下配置中的 YOUR_API_KEY 请替换为控制台创建的 Key。注意不同工具对应不同的分组平台。

最省事的方式

在 API 密钥页面 点击 Key 的「使用密钥」，选择对应客户端，即可复制控制台生成的配置：Key、接口地址和分组可用的模型都已填好。下文是同样配置的手写版本，便于理解每一项的作用。

Claude Code

适用于 Claude 平台分组的 Key。推荐写入 ~/.claude/settings.json（Windows 为 %userprofile%\.claude\settings.json），一次配置长期生效：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://xmlumen.org",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

或者只在当前终端会话临时生效：

macOS / Linux

export ANTHROPIC_BASE_URL="https://xmlumen.org"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://xmlumen.org"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

Windows CMD

set ANTHROPIC_BASE_URL=https://xmlumen.org
set ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

TIP

ANTHROPIC_BASE_URL 填站点根地址即可，不要带 /v1 后缀。用环境变量方式配置时，需要在新开的终端里重新启动 Claude Code；改完 settings.json 也建议重启一次。启动后可用 /status 确认 Anthropic base URL 已生效。

指定模型

Claude Code 默认使用最新的 Opus 模型（目前为 claude-opus-5-5）。如果分组没有开放该模型，或者想固定使用某个模型，可以在 env 中追加 ANTHROPIC_MODEL：

"ANTHROPIC_MODEL": "claude-sonnet-5-5"

也可以用 ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL 把 opus / sonnet / haiku 别名分别指向分组开放的模型。会话中随时可以用 /model 切换。

Codex CLI

适用于 OpenAI 平台分组的 Key。需要修改两个文件（Windows 目录为 %userprofile%\.codex）。

~/.codex/config.toml：

model_provider = "OpenAI"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://xmlumen.org/v1"
model_catalog_url = "https://xmlumen.org/v1/models"
wire_api = "responses"
requires_openai_auth = true

[features]
api_key_model_discovery = true

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

配置说明

• model_catalog_url 与 [features] 里的 api_key_model_discovery 让 Codex 从网关拉取当前分组的模型目录，/model 里就能看到分组开放的模型（需要 Codex 0.156.0 及以上；旧版本删掉这两处即可）。
• model 按分组可用的模型填写；model_reasoning_effort 可选 low / medium / high / xhigh 等，实际可用档位取决于模型。
• 旧配置里的 disable_response_storage 新版 Codex 已不再识别，可以删除。
• 保存配置后需要完全退出并重启 Codex（桌面 app 还要新建 task），新配置才会生效。

Gemini CLI

适用于 Gemini 平台分组的 Key，通过环境变量配置：

macOS / Linux

export GOOGLE_GEMINI_BASE_URL="https://xmlumen.org"
export GEMINI_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="https://xmlumen.org"
$env:GEMINI_API_KEY="YOUR_API_KEY"

TIP

• GOOGLE_GEMINI_BASE_URL 填站点根地址（不带 /v1beta），且必须是 https:// 开头的地址。
• 交互模式首次启动时，在 /auth 中选择「Gemini API Key」认证方式，Gemini CLI 才会使用上面配置的 Key。

通用 OpenAI 兼容客户端

Cherry Studio / NextChat / Open WebUI 等，只要客户端支持自定义 OpenAI 兼容服务商（OpenAI Compatible Provider），按下表填写即可：

配置项	值
Provider 类型	OpenAI Compatible
Base URL / 接口地址	https://xmlumen.org/v1
API Key	控制台创建的 Key
模型名	按 Key 分组的可用模型填写

OpenAI / Anthropic SDK

Python

# OpenAI SDK（OpenAI 平台分组）
from openai import OpenAI
client = OpenAI(base_url="https://xmlumen.org/v1", api_key="YOUR_API_KEY")

# Anthropic SDK（Claude 平台分组）
from anthropic import Anthropic
client = Anthropic(base_url="https://xmlumen.org", api_key="YOUR_API_KEY")

Node.js

// OpenAI SDK（OpenAI 平台分组）
import OpenAI from 'openai'
const openai = new OpenAI({ baseURL: 'https://xmlumen.org/v1', apiKey: process.env.API_KEY })

// Anthropic SDK（Claude 平台分组）
import Anthropic from '@anthropic-ai/sdk'
const anthropic = new Anthropic({ baseURL: 'https://xmlumen.org', apiKey: process.env.API_KEY })

TIP

Key 建议保存在环境变量或密钥管理服务中，不要写死在代码里，更不要暴露到浏览器端。为每个项目 / 成员单独创建 Key，方便限额与排查。