快速开始

第一步：注册账号

打开 玄枢注册页，按照页面提示完成注册。注册成功后，你会获得一个可以登录控制台的玄枢账号。

如果你是代理客户，可以使用代理给你的邀请链接注册，这样充值和后续订单会自动归因到对应代理。

第二步：登录控制台

注册完成后，前往 玄枢登录页，输入刚才注册的信息登录。

登录成功后进入控制台首页。后面的令牌管理、余额充值、日志查询和个人设置都在控制台里完成。

第三步：创建 API 令牌

进入 控制台令牌页面，点击创建令牌。创建时建议注意这几项：

• 名称：写一个自己看得懂的名字，比如 codex-个人电脑。
• 分组：按工具用途选择，Codex、Claude Code、Cursor 可以分别管理。
• 备注：可选，用来记录这个 Key 给谁使用、装在哪台设备上。

如果你准备这样使用，可以先按下面选择：

• Claude Code：优先选择 Claude 相关分组。
• Codex：选择 Codex 或 GPT 系列分组。
• Cursor：根据你想用的模型分组来选。

创建成功后，复制生成的 API Key。它通常以 sk- 开头，完整密钥只建议保存到你自己的安全位置。

第四步：充值余额

进入 控制台充值页面，选择金额后完成支付。

如果你还不确定该充多少，可以先小额充值，确认工具配置成功后再继续追加。这样更适合新手，也更容易控制成本。

价格怎么理解

玄枢采用模型分组倍率计费，方便你按模型类型管理成本。你可以把它理解为：

官方美元价格 × 模型分组倍率 ÷ 计价汇率 = 实际人民币消耗

常见分组示例：

倍率越低，同样人民币余额通常可以覆盖更多官方原价额度。新手如果主要使用 Codex，一般先从 Codex 对应分组开始最直接。

完成后你就可以做什么

完成以上 4 步后，你已经具备了：

• 一个可登录的玄枢账号
• 可用的账户余额
• 至少一个 API 令牌
• 后续配置 Claude Code、Codex、Cursor 所需的基础信息

接下来可以继续阅读：

• 玄枢入门指南
• Claude Code 文档
• Codex 配置

我是新手

如果你从来没配置过 API，不需要先理解所有参数。先记住三件事：Base URL 是接口地址，API Key 是你的通行证，模型名称决定调用哪个能力。

Claude Code 配置

export ANTHROPIC_BASE_URL="https://gateway.xuanshuai.top"
export ANTHROPIC_API_KEY="sk-your-api-key"
claude

Codex 配置

[model_providers.xuanshu]
name = "xuanshu"
base_url = "https://gateway.xuanshuai.top/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Cursor 配置

在 Cursor 的模型或 OpenAI Compatible 配置中填写 https://gateway.xuanshuai.top/v1，并把 API Key 填入对应密钥栏。绑定新域名后以控制台显示为准。