注册领 token 额度，Codex 一步配置。

AI大模型帮助用户在国内网络下快速使用 ChatGPT 模型，并把余额、每次使用的模型、token 消耗、订单和兑换记录放在后台统一查看。

使用 Codex 时，你只需要在本机保存平台生成的使用密钥和平台地址。复杂的模型可用性、额度扣费和记录统计由平台处理，登录后台即可核对。

1. 登录后台，先在仪表盘确认当前余额、使用额度和最近用量。
2. 进入 API Key 页面，创建一个给 Codex 使用的密钥。
3. 给密钥选择合适分组。分组决定这个密钥能使用哪些模型、采用什么倍率和限额。
4. 点击“使用密钥”查看 Codex 设置，把平台地址和 API Key 写入本机配置。
5. 在 Codex 发起一次简单任务，再回到用量记录页核对模型、token、成本和响应时间。

建议一台设备或一个用途使用一个独立密钥，后续统计和限额会清楚很多。

注册后会获得平台提供的 token 使用额度，适合先完成使用密钥创建、Codex 设置、模型连通性和用量记录检查。试用额度的具体数值、有效范围和到账状态，以后台实际显示为准。

试用阶段建议先做一次轻量使用：确认 Codex 能连通、模型能响应、用量记录能出现，再根据自己的使用频率选择永久额度、月卡或账号商品补给。

使用模型会消耗余额、订阅额度或商品兑换得到的权益。商店不是一个独立的附属入口，而是用户补充额度、购买月卡、获取账号类商品的入口。

当前商品大致覆盖三类：永久额度兑换码、按周期刷新的月卡额度、账号交付类商品。商品价格、库存和交付规则会变化，最终以商店实时页面为准。

Codex 能正常使用，需要账户、API Key、分组、额度和本机设置同时正确。第一次配置时建议按下面顺序检查，能减少大部分问题。

1. 账户已注册并处于可用状态，后台能看到 token 使用额度、余额或订阅权益。
2. API Key 已创建、已启用，没有显示已停用、额度耗尽或已过期。
3. API Key 已选择分组，分组中能看到 Codex 要使用的模型，例如 gpt-5.5。
4. API Key 的总额度、5 小时限额、1 天限额、7 天限额没有达到上限。
5. 如果设置了固定网络限制，当前电脑的网络出口需要在允许范围内。
6. Codex 的平台地址是 https://api.mcgfdata.com/，不需要追加 /v1。
7. 保存配置后重启 Codex，再发起一次简单任务，并回到后台查看是否出现用量记录。

后台能看到一次 Codex 用量记录，通常说明 API Key、平台地址和模型配置已经生效。

登录后台后进入 API Key 页面，可以创建、搜索、筛选、复制、启用、禁用、编辑或删除密钥。创建时建议填写清楚名称，例如“个人 Codex”“公司电脑”“日常使用”。

• 名称：用于识别这个密钥的用途，不影响使用。
• 分组：决定可用模型、倍率、订阅规则和限额。
• 额度上限：可设置这个密钥最多可消耗多少美元额度，避免消耗失控。
• 过期时间：适合临时使用或短期共享。
• 固定网络限制：用于限制来源网络，提升安全性。
• 5 小时 / 1 天 / 7 天限额：按时间窗口限制密钥的消耗速度。

分组决定这个 API Key 可以使用哪些模型、采用什么倍率、走余额还是订阅权益，以及是否有每日、每周或每月额度窗口。用于 Codex 时，优先选择后台可见并包含 Codex 模型的分组。

如果 API Key 没有分组、分组被停用、分组被删除，或者分组里没有你填写的模型，Codex 可能会提示不可用、无权限或没有可用模型。遇到这类问题，先回到 API Key 页面检查分组和模型。

• 已启用：正常状态，仍需确认分组、余额、限额和本机配置。
• 已停用：后台已关闭这个 API Key，Codex 无法继续使用。
• 额度耗尽：这个 API Key 设置了总额度，并且已经用完，需要提高额度或换一个可用 API Key。
• 已过期：API Key 到了过期时间，需要延长有效期或新建 API Key。

即使账户还有余额，单个 API Key 被停用、过期或额度耗尽，也会影响 Codex 使用。

余额和订阅是账户层面的可用资源，API Key 额度是某一个密钥自己的上限。平台会先确认 API Key 可用，再确认账户还有余额、订阅权益或兑换得到的额度。

• 余额：按实际使用扣费，适合灵活补给。
• 订阅 / 月卡：按商品规则提供周期额度，可能带有每日、每周或每月窗口。
• API Key 额度：限制某个 API Key 最多能消耗多少，适合给不同设备或用途分开管理。
• 时间窗口限额：控制 5 小时、1 天、7 天内的消耗速度，防止短时间消耗过高。

这三个限额是 API Key 的消耗窗口。比如 5 小时限额设置为 2 美元，表示这个 API Key 在连续 5 小时窗口内最多消耗 2 美元额度；超过后需要等待窗口重置，或在后台调整限额。

API Key 页面会显示窗口内已用金额和重置时间。Codex 突然不可用但账户还有余额时，建议先看这里是否已经达到 5 小时、1 天或 7 天上限。

如果 API Key 设置了固定网络限制，只有允许范围内的网络才能使用。家里、公司、远程机器、代理或移动热点的出口地址不同，都可能影响 Codex。

遇到 ACCESS_DENIED、无权限、无法连接一类提示时，可以先临时关闭固定网络限制验证；确认后再按自己的真实网络环境重新设置。

API Key 只应保存在自己电脑的 Codex 配置文件、受信任设备的安全保存工具或平台生成的本地配置文件中。不要写进公开页面、公开仓库、公开文档、截图或聊天记录。

如果怀疑密钥泄露，立即在后台禁用或删除旧密钥，再创建新密钥，并检查用量记录是否出现异常模型、异常时间段或陌生设备信息。

Codex 推荐把 API Key 写入自己电脑上的 ~/.codex/auth.json。这个文件只保存在本机，用来让 Codex 知道当前账户使用哪一个平台密钥。

{
  "OPENAI_API_KEY": "你的 API Key"
}

不要把密钥放进公开页面、公开仓库、截图或聊天记录里。需要更换时，先在后台停用旧密钥，再创建新的密钥。

在 API Key 页面点击“使用密钥”，平台会生成 Codex 设置。当前平台地址为 https://api.mcgfdata.com/。Codex 常用设置包含两个文件：~/.codex/auth.json 保存 API Key，~/.codex/config.toml 保存模型设置。

macOS / Linux 推荐文件位置：

~/.codex/auth.json
~/.codex/config.toml

Windows 推荐文件位置：

%userprofile%\.codex\auth.json
%userprofile%\.codex\config.toml

auth.json 示例：

{
  "OPENAI_API_KEY": "你的 API Key"
}

config.toml 示例：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.mcgfdata.com/"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

保存后重启 Codex，选择配置中的模型发起一次简单任务。后台用量记录能看到这次使用，就说明配置已经生效。

Codex 的 base_url 直接填写 https://api.mcgfdata.com/ 即可，不需要自己再拼接 /v1。

是的，本质都是让 Codex 在本机保存 API Key。更稳妥的方式是直接按“使用密钥”弹窗生成 auth.json，因为它和平台生成的 config.toml 配套。

如果你习惯命令行，也可以使用：

printf '你的 API Key' | codex login --with-api-key

使用命令后仍然需要检查 config.toml 里的 base_url = "https://api.mcgfdata.com/"、wire_api、model_provider 和 model 是否正确。

普通 Codex 使用通常保持示例里的 Responses 设置即可。如果平台生成的配置明确包含 WebSocket v2，再启用 WebSocket 模式。

WebSocket 模式会在模型服务配置里增加：

[model_providers.OpenAI]
supports_websockets = true

[features]
responses_websockets_v2 = true
goals = true

如果不确定是否需要，先使用普通设置。普通设置成功后，再根据平台生成内容切换 WebSocket 模式，会更容易判断问题。

余额只是其中一个条件。Codex 使用前还会检查 API Key 是否有效、账户是否可用、分组是否可用、模型是否在分组内、API Key 是否过期、是否超过总额度或时间窗口限额，以及固定网络限制是否放行。

建议按顺序看：API Key 状态、分组、模型名称、余额或订阅权益、5 小时 / 1 天 / 7 天限额、固定网络限制、Codex 本机配置和后台用量记录。

没有用量记录通常说明 Codex 没有真正连到平台，或者还在使用旧配置。先检查 base_url 是否为 https://api.mcgfdata.com/，再检查 auth.json 里的 API Key 是否来自当前账户。

• 保存配置后没有重启 Codex，仍在使用旧设置。
• CC Switch 没有启用当前这组配置。
• API Key 复制时带了前后空格或少复制了一段。
• 模型名称不是后台当前可用模型。
• 本机网络、系统代理或固定网络限制导致请求没有到达平台。

• API_KEY_REQUIRED：Codex 没有带上 API Key，检查 auth.json 或 CC Switch 中的 API Key。
• INVALID_API_KEY：API Key 不存在或复制错误，重新从后台复制。
• API_KEY_DISABLED：API Key 已停用，需要在后台启用或新建。
• API_KEY_EXPIRED：API Key 已过期，需要延长有效期或新建。
• API_KEY_QUOTA_EXHAUSTED：API Key 自己的额度已用完，需要提高额度或更换 API Key。
• INSUFFICIENT_BALANCE：账户余额不足，需要充值、兑换或购买月卡。
• GROUP_DISABLED / GROUP_DELETED：API Key 所属分组不可用，需要重新选择可用分组。
• ACCESS_DENIED：可能是固定网络限制未放行当前网络。
• USAGE_LIMIT_EXCEEDED：订阅或时间窗口达到上限，等待重置或补充权益。

CC Switch 是一个可视化配置工具，适合把 Codex 的平台地址、API Key 和模型设置集中管理。对不熟悉本机配置文件的用户来说，它比手动打开 auth.json 和 config.toml 更直观。

你仍然使用 AI大模型后台创建的 API Key 和平台地址 https://api.mcgfdata.com/。CC Switch 只是帮助写入和切换本机配置，不会改变后台余额、用量和兑换规则。

1. 打开 CC Switch 下载页面：https://cc-switch.cc/en/download。
2. 进入下载或 GitHub Releases，按自己的系统选择安装包：Windows 选 .msi，macOS 选 .dmg，Linux 选 .deb、.rpm 或 .AppImage。
3. 安装后打开 CC Switch。如果系统提示需要允许应用运行，按系统设置完成授权。
4. 第一次使用前，建议先备份现有的 ~/.codex/auth.json 和 ~/.codex/config.toml。

如果你已经手动配置过 Codex，先备份再让 CC Switch 写入新配置，回退会更方便。

• Windows：如果出现 SmartScreen 或安全提醒，确认来源是 CC Switch 官方下载页后，点击“更多信息”，再选择继续运行。
• macOS：如果提示无法打开，进入系统设置的隐私与安全，找到被拦截的 CC Switch，选择仍要打开。
• Linux：如果使用 AppImage，先给文件执行权限，再打开应用。

chmod +x cc-switch-*.AppImage

安装完成后再回到 CC Switch 里添加 Codex 配置，不需要把 API Key 写到下载页面或网页表单里。

1. 打开 https://api.mcgfdata.com/ 并登录账户。
2. 进入 API Key 页面，点击创建 API Key。
3. 填写容易识别的名称，例如“CC Switch Codex”。
4. 选择可用分组，确保这个分组包含 Codex 要使用的模型。
5. 按需要设置总额度、有效期、5 小时 / 1 天 / 7 天限额和固定网络限制。
6. 创建后复制 API Key，或点击“使用密钥”查看平台生成的 Codex 配置。

API Key 只会完整显示一次时，建议立即复制并保存到 CC Switch 或 Codex 本机配置中。

1. 打开 CC Switch，进入 Codex 相关页面。
2. 点击 Add Provider、新建配置或添加平台。
3. 如果有预设，选择 OpenAI-compatible、OpenAI 或 Custom；核心是能填写 Base URL、API Key 和模型。
4. 名称填写 AI大模型 Codex，方便以后识别。
5. Base URL 填写 https://api.mcgfdata.com/。
6. API Key 粘贴后台创建的 API Key，注意不要带前后空格。
7. Default Model 填写后台可见模型，例如 gpt-5.5。
8. 如果有协议选项，选择 Responses；如果没有，保持 CC Switch 对 Codex 的默认设置。
9. 保存配置。

平台地址直接填根地址即可。不要把 https://api.mcgfdata.com/ 改成带 /v1 的地址。

1. 在 CC Switch 的 Codex 配置列表中找到 AI大模型 Codex。
2. 点击 Enable、Activate、启用或切换到当前配置。
3. 确认 CC Switch 已写入 Codex 配置。通常会影响 ~/.codex/config.toml 和 ~/.codex/auth.json。
4. 关闭并重新打开 Codex，让新的配置生效。
5. 在 Codex 中发送一个简单任务，例如让它解释当前目录结构。
6. 回到后台用量记录页面，确认能看到模型、token、成本和时间。

如果启用后 Codex 仍然没有变化，先重启 Codex；如果还不生效，再检查 CC Switch 当前启用的是不是这组配置。

• 平台地址 / Base URL：https://api.mcgfdata.com/
• API Key：填写后台 API Key 页面创建的密钥。
• 模型：填写后台当前可用模型，例如 gpt-5.5。
• 协议 / API 类型：如果有 Responses 选项，选择 Responses；如果没有，保持 CC Switch 为 Codex 推荐的默认项。

平台地址直接填根地址即可，不需要自己追加 /v1。

第一次配置建议先使用普通 Responses 设置。普通设置更容易判断平台地址、API Key、模型和用量记录是否正确。

只有当后台“使用密钥”弹窗生成的 Codex 配置明确包含 supports_websockets = true 和 responses_websockets_v2 = true 时，再按生成内容启用 WebSocket 模式。

1. Codex 能正常返回结果。
2. 后台用量记录能看到这次使用。
3. 记录里能看到模型名称、token、实际成本、响应时间和 API Key。
4. 如果 CC Switch 显示用量或余额，也能看到当前 API Key 的余额、限额、今日使用和模型统计。

平台提供给 CC Switch 的用量查询会返回当前 API Key 的今日用量、累计用量、模型统计、每日用量，以及余额、订阅或 API Key 限额信息。

• Base URL 填错，或额外添加了 /v1。
• API Key 复制时带了空格、换行或漏了一部分。
• API Key 没有启用、已过期或额度已经用完。
• API Key 没有选择分组，或分组里没有当前模型。
• CC Switch 保存了配置，但没有启用这组配置。
• Codex 没有重启，仍在使用旧配置。
• 固定网络限制没有放行当前电脑的网络出口。
• 账户余额、订阅权益或时间窗口限额不足。

可以。建议先备份当前 ~/.codex/auth.json 和 ~/.codex/config.toml，再让 CC Switch 写入新的配置。切换完成后，用 Codex 做一次简单任务，并到后台用量记录里确认。

如果切换后不可用，优先检查三件事：平台地址是否为 https://api.mcgfdata.com/，API Key 是否来自当前账户，模型名称是否在后台可见。

登录后台后，仪表盘会展示总使用次数、总 token、实际成本、平均耗时和近期使用概览。用量记录页面可以按 API Key 和时间范围筛选明细，并支持导出 CSV。

• 基础信息：API Key、模型、推理强度、使用类型。
• token 明细：输入、输出、缓存读取、缓存写入，以及缓存 TTL 调整标记。
• 成本明细：标准成本、实际成本、倍率、服务层级和分项费用。
• 速度信息：首 token 延迟、总耗时、使用时间和设备来源。

标准成本可以理解为模型原始计费参考值，实际成本是结合平台倍率、分组倍率、订阅规则或活动规则后，真正从余额或额度中扣除的金额。

用量记录里的成本提示会拆分输入、输出、缓存、图片生成等费用。如果觉得扣费异常，先核对模型、倍率、使用类型、token 数和是否命中缓存。

平台会在每次使用前检查账户状态、密钥状态、分组、IP 限制、过期时间、密钥额度、订阅权益和余额。检查通过后才会继续使用模型。

• 余额：按实际用量扣费，适合灵活使用。
• 订阅 / 月卡：适合持续使用，可能带有每日、每周或每月额度窗口。
• 密钥额度：控制某个密钥最多能花多少，适合不同设备或不同用途分开管理。
• 时间窗口限额：限制 5 小时、1 天、7 天内的消耗速度，避免短时间用量过高。

API Key 列表会显示今日消耗、累计消耗、密钥额度进度，以及 5 小时、1 天、7 天窗口内的已用金额和重置时间。接近上限时建议提前补充额度、降低使用频率或新建独立密钥分开统计。

如果密钥状态显示 quota_exhausted、expired 或 inactive，需要增加额度、延长有效期或重新启用后才能继续使用。

在用量记录页选择时间范围和 API Key 后点击导出 CSV。导出内容会包含时间、密钥名称、模型、推理强度、使用类型、计费模式、token、倍率、实际成本、标准成本、首 token 延迟和总耗时。

长期使用时建议定期导出一次，用密钥名称区分不同设备或用途，可以更快定位成本来源。

后台的可用模型页面会展示当前账户可使用的模型、分组、定价和状态信息。搜索模型名、分组名或平台名，可以快速确认当前密钥应该使用哪个模型。

如果 Codex 里配置了一个后台不可见或分组未开放的模型，平台可能会返回模型不可用、分组不匹配或暂无可用资源的提示。

模型状态页面会展示每个可见资源的当前状态、主要模型、最近 7 天可用率、延迟和附加模型。详情页还可以查看 7 天、15 天、30 天窗口的可用率和平均延迟。

页面支持自动刷新，常用间隔包括 30 秒、60 秒和 120 秒。遇到某个模型偶发失败时，先看模型状态能更快判断是本机设置问题还是模型状态波动。

每次使用模型时，平台会先检查账户状态、分组、额度、内容安全和同时使用情况，再根据可用状态选择合适资源。你只需要维护一个平台地址，后台会自动完成可用性选择。

连续会话适合同一任务，能尽量保持上下文稳定；自动选择可用资源则能减少单点波动对日常使用的影响。

Codex 配置中的平台地址直接使用：

https://api.mcgfdata.com/

用户重点检查 config.toml 里的 base_url 和 wire_api = "responses"。平台地址填写正确后，再确认 auth.json 里的 API Key 是后台当前可用的密钥。

• 平台地址：https://api.mcgfdata.com/
• Codex 协议：wire_api = "responses"
• 默认模型：按后台可用模型填写，例如 gpt-5.5。

如果后台“使用密钥”弹窗给出的配置和这里不同，以后台当前生成内容为准。

当前商店主要有三类商品：永久额度兑换码、按周期刷新的月卡额度、账号交付类商品。永久额度适合按项目消耗补充；月卡适合高频连续使用；账号商品适合需要交付账号或邮箱凭证的场景。

商品会有价格、库存、有效期、交付方式和使用说明差异。购买前以商品详情页为准，首页和 FAQ 只做产品说明。

1. 购买后复制兑换码。
2. 登录平台后台，进入兑换页面。
3. 输入兑换码并确认预览信息。
4. 确认兑换后，额度、订阅权益或账号凭证会写入你的账户。
5. 兑换完成后，回到仪表盘、订阅页或我的购买账号页核对结果。

兑换动作通常不可逆。兑换前请确认当前登录账户就是你要接收额度或账号凭证的账户。

如果兑换码或在线购买交付的是账号类商品，后台会在“我的购买账号”里展示记录。凭证默认不会直接铺开显示，需要点击查看后才展示，请妥善保存。

账号凭证页面支持按商品类型下载：

• credentials.json：完整凭证备份。
• sub2api 导入文件：适合导入兼容平台。
• CPA 文件：适合需要对应格式的工具。
• 邮箱信息或账号密码文本：适合账号交付类商品。

后台购买页包含余额充值和订阅购买。余额充值会展示充值金额、支付金额、到账额度预览；订阅购买会展示平台、价格、有效期、倍率以及每日、每周或每月限额。

订单页可以查看订单状态。待支付订单通常可以取消；符合规则的订单可以按页面提示申请退款。不同支付方式的展示形式可能是二维码、跳转链接或收银台页面。

商店实时页面是最终来源。当前首页会展示商品概览，但商品可能新增、下架、改价或改库存，所以购买前应以商店实时页面为准。

本站维护时会按规则重新检查商店商品，包括商品列表、详情页、价格、库存、分类、交付说明和链接变化，再同步到首页与商店页。

• 密钥无效：检查 API Key 是否填错、是否复制了多余空格、是否已经在后台停用。
• 无权限：检查密钥是否禁用、过期、没有分组、网络来源被限制，或账户状态异常。
• 余额或订阅不足：查看仪表盘余额、订阅页额度窗口、密钥额度上限和商店兑换结果。
• 使用过快：查看密钥的 5 小时、1 天、7 天限额，以及账户同时使用额度。
• 模型不可用：查看可用模型页和模型状态页，确认分组支持该模型。
• 没有用量记录：Codex 可能还没有连到平台，优先检查平台地址和本机 Codex 配置文件。

1. 确认 auth.json 中的 OPENAI_API_KEY 是当前后台创建的 Key。
2. 确认 config.toml 中的 base_url 是 https://api.mcgfdata.com/。
3. 确认 wire_api = "responses"，并且 model 是后台可用模型。
4. 重启 Codex，让新的配置生效。
5. 回到后台 API Key 页面，检查密钥是否启用、已分组、未过期、未超额度。
6. 查看用量记录。如果没有记录，多半是 Codex 没有连接到平台；如果有记录但失败，继续看错误信息和模型状态。

• 每个设备或用途使用独立密钥，方便停用和追踪。
• 给长期使用的密钥设置合理额度上限和时间窗口限额。
• 需要放在远程机器上时，尽量使用受信任的安全保存方式。
• 有固定网络出口时，可以开启来源网络限制。
• 在个人资料页维护密码、第三方登录绑定、低余额提醒和二次验证。
• 定期查看用量记录，发现异常设备来源、异常模型或异常时间段时及时更换密钥。