玄枢API玄枢API

玄枢API

TRAE SOLO 接入教程

在 TRAE SOLO 图形客户端中添加自定义模型，接入玄枢API 的 Claude 或 Codex 通道。无需命令行，全部配置在界面里完成。

1. 准备 API Key

  1. 还没有账户的先到 /register 注册。
  2. 在 /keys 创建一个供 TRAE SOLO 单独使用的 Key，并安全保存完整值。

2. 进入自定义模型配置

  1. 打开 TRAE SOLO 的「设置」。
  2. 进入「模型」页。
  3. 点击「添加模型」。
  4. 选择「自定义配置」。

3. 按通道填写配置

两个通道的地址规则不同：Claude 通道用根地址，Codex 通道必须带 /v1。填错会直接报连接失败。模型会更新，当前可用列表以 /available-channels 为准。

字段Claude 通道Codex 通道
兼容协议Anthropic / ClaudeOpenAI / Codex
Base URLhttps://www.xuanshuapi.comhttps://www.xuanshuapi.com/v1
API Key在 /keys 复制的完整 Key在 /keys 复制的完整 Key
模型名claude-opus-4-7gpt-5.6-sol

4. 成功标准

保存后在 TRAE SOLO 里选中刚添加的模型，发一句话能拿到回复；同时在 /usage 能看到对应模型的成功调用记录。两点都满足即接入成功。

5. 常见问题排查

现象检查处理
连接失败 / 404Claude 通道的地址不能带 /v1，Codex 通道必须带 /v1。按通道改正 Base URL 后重新保存。
401 / 403确认粘贴的是完整未截断的 Key，且未过期。在 /keys 重新复制或新建 Key。
模型不可用模型名要与 /available-channels 显示的精确 ID 一致。改成控制台里当前可用的同协议模型。
429在 /usage 检查余额、Key 限额与并发。降低并发并等待限流窗口恢复。