让你的工具，
连接更多可能。

保留熟悉的工具，只需配置接口地址、API 密钥与模型。先选择客户端，按步骤完成首次接入。

这里的地址是统一调用入口。各客户端可用的协议与模型，取决于你的令牌分组和平台已接入的资源。

每个客户端使用一枚独立密钥，权限、用量与问题排查会更清晰。

1. 登录兴一控制台

   已有账号前往登录；首次使用可以注册账号，再查看账户余额与可用分组。

2. 为设备创建独立令牌

   进入API 密钥管理，新建密钥并选择可用分组。按用途命名，例如“工作电脑 Codex”，便于查看用量和停用。

3. 设置额度并保存密钥

   按需要设置有效期和调用额度，复制生成的密钥。文档中的 YOUR_API_KEY 均需替换成这枚密钥。

4. 确认模型，完成一次测试

   从模型广场复制当前分组支持的完整模型 ID，测试后前往使用记录核对调用。

使用 Anthropic 原生协议，在你熟悉的终端中开始编码。

1. 安装并检查版本

以下使用官方原生安装方式。安装结束后重新打开终端，检查版本是否正常显示。

irm https://claude.ai/install.ps1 | iex
claude --version

curl -fsSL https://claude.ai/install.sh | bash
claude --version

2. 指向兴一 API

在当前终端设置临时环境变量，然后启动客户端。地址使用根域名，末尾不添加 /v1。

$env:ANTHROPIC_BASE_URL="https://api.xingyi888.com"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude

export ANTHROPIC_BASE_URL="https://api.xingyi888.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude

3. 保存为用户配置（可选）

需要从桌面图标启动 IDE 时，可把环境配置写入用户配置文件。macOS / Linux 路径为 ~/.claude/settings.json；Windows 为 %USERPROFILE%\.claude\settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xingyi888.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

在编辑器里继续使用相同的网关配置，把终端与工作区连起来。

1. 先完成命令行接入

   按照上一节确认 API 地址与密钥可用。CLI 成功后，再检查 IDE 配置更容易定位问题。

2. 安装官方扩展

   在 VS Code 等兼容编辑器的扩展市场查找 Claude Code，核对发布者为 Anthropic。不同编辑器的市场与支持范围可能不同。

3. 让编辑器读取配置

   使用用户级 settings.json 后完全退出编辑器，再重新启动。只使用临时环境变量时，请从设置变量的同一终端运行 code .。

4. 检查首次调用

   从扩展面板发送简短测试消息，再到使用记录核对是否经过本站。无记录时先检查编辑器进程是否继承了变量。

配置独立服务商与环境变量，让 Codex 通过兴一的 Responses 接口调用可用模型。

1. 安装 Codex CLI

使用 npm 安装时，先安装当前 Node.js LTS，并在终端确认 node -v 和 npm -v 可用。

npm install -g @openai/codex
codex --version

2. 添加自定义服务商

编辑 ~/.codex/config.toml；Windows 对应 %USERPROFILE%\.codex\config.toml。将 YOUR_CODEX_MODEL 换成你分组支持、并兼容 Responses 的模型 ID。

model_provider = "xingyi"
model = "YOUR_CODEX_MODEL"

[model_providers.xingyi]
name = "XINGYI"
base_url = "https://api.xingyi888.com/v1"
wire_api = "responses"
env_key = "XINGYI_API_KEY"
requires_openai_auth = false

3. 设置密钥并启动

$env:XINGYI_API_KEY="YOUR_API_KEY"
codex

export XINGYI_API_KEY="YOUR_API_KEY"
codex

将已验证的命令行配置延伸到编辑器，并检查密钥是否被扩展进程读取。

1. 先验证 CLI 的自定义服务商

   完成Codex 命令行配置，确认 config.toml 中的模型和服务商正确，且 CLI 已能发出调用。

2. 安装 OpenAI 发布的 Codex 扩展

   在 VS Code 或支持的兼容编辑器中查找 Codex，核对发布者为 OpenAI，安装后打开 Codex 面板。

3. 重启并检查环境变量

   扩展使用本地配置时，还需要能读取 XINGYI_API_KEY。可从已设置变量的终端运行 code .；已写入用户环境变量时，请完全重启 IDE。

4. 确认调用路径

   发起简短测试后查看使用记录。若当前扩展版本的自定义服务商行为不同，请查看官方说明，并使用已验证的 CLI 继续工作。

为日常对话添加自定义 API 服务商，统一使用本站令牌。

1. 安装并打开设置

   从 Chatbox 官方网站安装客户端，在模型设置中新增服务商。服务商名称可以填写“XINGYI”。

2. 按接口协议填写

   选择当前客户端支持的兼容类型，填写下表中的地址，并粘贴自己的 API 密钥。

保存后创建会话，并选择刚添加的模型。如果地址预览已经自动拼接 /v1，请按客户端要求改填根地址，避免出现 /v1/v1。

把多个 CLI 的服务商配置集中管理，切换之后记得重启目标客户端。

先确保 Claude Code 或 Codex 已安装。打开 CC Switch 后选择对应客户端，新增一个名为 XINGYI 的自定义供应商。

保存并启用新供应商后，退出已运行的 CLI 或 IDE，再重新启动。先测试一条短消息，并到控制台核对用量。

为模型工作台添加自定义服务，按分组权限选择适合任务的模型。

1. 添加模型服务

   从官方渠道安装 Cherry Studio，打开设置中的模型服务管理，新增自定义供应商“XINGYI”。

2. 填写 OpenAI 兼容参数

   按下表填写密钥和接口地址，然后保存。

手动添加模型后，在会话中选中它并发送测试消息。使用 Anthropic 原生类型时，改填根地址 https://api.xingyi888.com。不同版本对地址后缀的处理可能不同，请以客户端显示的最终请求地址为准。

先用一个小请求确认密钥、模型与协议，再把配置放进自己的应用。

下面先查询当前密钥可见的模型。终端变量是临时设置，关闭窗口后不会保留。

$env:XINGYI_API_KEY="YOUR_API_KEY"
curl.exe https://api.xingyi888.com/v1/models `
  -H "Authorization: Bearer $env:XINGYI_API_KEY"

export XINGYI_API_KEY="YOUR_API_KEY"
curl https://api.xingyi888.com/v1/models \
  -H "Authorization: Bearer $XINGYI_API_KEY"

验证 Responses 接口

把 YOUR_CODEX_MODEL 换成你的可用模型。以下示例适用于支持 Responses 的分组，用于检查 Codex 接入前的基本调用。

$request = @{
  model = "YOUR_CODEX_MODEL"
  input = "Reply with OK."
  stream = $false
} | ConvertTo-Json
Invoke-RestMethod -Uri "https://api.xingyi888.com/v1/responses" `
  -Method Post -ContentType "application/json" `
  -Headers @{Authorization="Bearer $env:XINGYI_API_KEY"} `
  -Body $request

curl https://api.xingyi888.com/v1/responses \
  -H "Authorization: Bearer $XINGYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_CODEX_MODEL","input":"Reply with OK.","stream":false}'

从密钥、地址、模型与客户端启动环境入手，快速定位首次接入中的常见问题。