使用文档 / 手动配置
手动配置
手动接入 玄枢 所需的地址、分组与鉴权信息。
1. 先拿到 Key
- 打开 api.ai-trailblazer.com 注册或登录（注册需 QQ 邮箱验证码）。
- 进入控制台创建一个新的 API Key。
- 记下你准备使用的模型名称。
2. 记住这两个地址
- OpenAI 兼容 Base URL：
https://api.ai-trailblazer.com/v1 - Claude / Anthropic 兼容 Base URL：
https://api.ai-trailblazer.com
3. 先确认模型分组
当前可用分组（详见 模型分组）：
- GPT / Codex 类分组
gpt-pro、gpt-pro20、GPT-fast：gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-5.6-terra、gpt-5.6-sol、gpt-5.5、codex-auto-review - Claude 类分组
CCPro、CCMAX、CCMAX-sale、claudeextern：claude-opus-5-5、claude-opus-5、claude-opus-4-8、claude-opus-4-7、claude-opus-4-6、claude-sonnet-5-5、claude-sonnet-5、claude-sonnet-4-6、claude-sonnet-4-5-20250929、claude-haiku-5-5、claude-haiku-4-5-20251001、claude-fable-5-1、claude-fable-5
按设备和工具查看
| 工具 | Windows | Mac | Linux | VSCode | JetBrains | KiloCode / RooCode |
|---|---|---|---|---|---|---|
| Claude Desktop | Windows 一键配置 | 本页配置包适用于 Windows | ||||
| Cherry Studio | 桌面端接入 | - | ||||
| Claude Code | 教程 | 教程 | 教程 | 教程 | 教程 | 教程 |
| Codex | 教程 · 一键配置 | 教程 | 教程 | 教程 | 教程 | - |
常见问题
- 401 / invalid_api_key：Key 填错、复制时多了空格，或该 Key 已被禁用。
- model_not_found：模型名写错，或该模型不在你账户可用范围内。
- Claude 请求失败但 GPT 正常：检查令牌是否可用 Claude 类分组。
- GPT 请求失败但 Claude 正常：检查令牌是否可用 GPT 类分组。
- 客户端连不上：确认填的是正确的 Base URL，不同客户端不一定一样。