智叶 API

快速配置

为常用客户端设置智叶 API 地址与独立的访问令牌。

准备 API Key

在控制台创建 API Key，选择分组并设置额度及有效期。不同应用建议使用不同 Key；模型名称从模型广场复制。

Linux / macOS

export ANTHROPIC_BASE_URL='https://api.ziyelian.site'
export ANTHROPIC_API_KEY='YOUR_API_KEY'
export OPENAI_BASE_URL='https://api.ziyelian.site/v1'
export OPENAI_API_KEY='YOUR_API_KEY'
export GOOGLE_GEMINI_BASE_URL='https://api.ziyelian.site'
export GEMINI_API_KEY='YOUR_API_KEY'

只需设置所用客户端对应的变量。当前终端设置立即生效；需要长期保存时，将相应配置加入自己的 Shell 配置文件。

Windows PowerShell

$env:ANTHROPIC_BASE_URL = 'https://api.ziyelian.site'
$env:ANTHROPIC_API_KEY = 'YOUR_API_KEY'
$env:OPENAI_BASE_URL = 'https://api.ziyelian.site/v1'
$env:OPENAI_API_KEY = 'YOUR_API_KEY'
$env:GOOGLE_GEMINI_BASE_URL = 'https://api.ziyelian.site'
$env:GEMINI_API_KEY = 'YOUR_API_KEY'

以上变量作用于当前 PowerShell 及其启动的程序。需要持久保存时，在系统的当前用户环境变量中设置同名项目，随后重新打开客户端。

Codex 配置文件

在 ~/.codex/config.toml 配置服务地址；Windows 对应 %USERPROFILE%\.codex\config.toml。保留原有配置，只合并相关字段。

model_provider = "zhiye"
model = "YOUR_MODEL_ID"

[model_providers.zhiye]
name = "智叶 API"
base_url = "https://api.ziyelian.site/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Claude Code 配置文件

可在 ~/.claude/settings.json 的 env 中配置地址与 Key。Windows 使用 %USERPROFILE%\.claude\settings.json。合并配置时保留现有权限和其他设置。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ziyelian.site",
    "ANTHROPIC_API_KEY": "YOUR_API_KEY"
  }
}

切换模型或 Key

在客户端选择模型广场中的完整模型 ID。更换 Key 时同步确认其分组和模型权限；更新环境变量或配置文件后重新启动客户端。不要同时保留互相冲突的地址配置。

请勿把 Key 写入 Git 仓库、网页前端或截图。只需确认变量是否设置，不要打印完整令牌。

详细说明

继续查看 API 端点说明、Gemini CLI 或 OpenClaw 配置。