STEP 01
使用兑换码充值
进入玄枢后台，在左侧菜单选择「兑换」。把购买到的兑换码粘贴到输入框，然后点击「兑换」即可完成充值。
配置路线
先看全局，再动手
完整流程只有三步，完成后即可在 Codex 中使用玄枢服务。
01
GET YOUR API KEY
兑换码充值与创建密钥
先为玄枢账户充值，再创建一个用于 Codex 的 API 密钥。
开始前准备
准备好你的玄枢兑换码。还没有账号时，请先前往 api.xuanmesh.com 注册并登录。
STEP 02
创建 API 密钥
打开左侧「API 密钥」，点击右上角「创建密钥」。填写名称，并在分组中选择你需要的计划，然后点击「创建」。
STEP 03
复制新建的密钥
创建完成后，密钥会出现在列表中。点击密钥右侧的小复制按钮，将它保存好，下一章配置 Codex 时会用到。
请妥善保管 API 密钥
它相当于你的访问凭证。不要发送给他人，也不要粘贴到公开网页、截图或聊天记录中。
02
CONNECT TO CODEX
将密钥接入 Codex
推荐用 CC Switch 一键配置；熟悉配置文件的用户也可以手动完成。
推荐
方式一：使用 CC Switch
图形界面操作，不需要手写配置文件。
STEP 01
下载并打开 CC Switch
从官网或 GitHub 下载 CC Switch。打开软件后，选中顶部的 Codex 图标，再点击右上角「＋」。
STEP 02
添加自定义 Codex 供应商
在「Codex 供应商」页选择「自定义配置」，进入配置表单。
STEP 03
填写密钥和请求地址
供应商名称可自定义；API Key 填写上一章创建的密钥；API 请求地址填写下面的地址，最后点击「添加」。
https://api.xuanmesh.comSTEP 04
启用新配置
回到供应商列表，选中刚添加的玄枢配置，点击「启用」。重新打开 Codex 后即可正常使用。
进阶
方式二：手动配置
适合熟悉 Codex 配置文件的用户。
打开「使用密钥」
在玄枢后台进入「API 密钥」，找到目标密钥，点击操作栏中的「使用密钥」。
按系统选择配置
在弹窗中选择 Codex CLI，再根据 macOS、Linux 或 Windows 标签页中的说明修改配置文件。
03
CHECK YOUR BALANCE
用 CC Switch 查询密钥余额
为玄枢供应商配置用量查询后，可以直接在 CC Switch 中看到剩余金额。
STEP 01
打开用量查询
在 CC Switch 供应商列表中选中玄枢配置，点击右侧的「用量查询」图标。
STEP 02
填写查询信息
打开「启用用量查询」。API Key 填入玄枢密钥；请求地址填写 https://api.xuanmesh.com，也可以留空；然后将下方代码完整粘贴到「提取器代码」。
({
request: {
url: "{{baseUrl}}/v1/usage",
method: "GET",
headers: {
"Authorization": "Bearer {{apiKey}}",
"User-Agent": "cc-switch/1.0"
}
},
extractor: function(response) {
return {
isValid: response.is_active || true,
remaining: response.balance,
unit: "USD"
};
}
})STEP 03
测试、保存并查看余额
先点击「测试脚本」，确认查询成功后点击「保存配置」。回到供应商列表，就能看到该密钥的剩余 USD 额度。
04
TROUBLESHOOTING
Hermes 第三方 Agent 403 错误
如果“龙虾” Hermes 第三方 Agent 出现 403 错误，可参考下面的社区解决方案。
05
RESTORE HISTORY
恢复 Codex 旧聊天记录
使用 API 中转后，部分用户可能看不到原来的聊天记录，可以借助 Codex Provider Sync 尝试恢复。
ALL SET
配置完成，开始使用玄枢
你已经掌握了充值、创建密钥、接入 Codex 和查询余额的完整流程。