Oh my Codex

Appearance

QA 常见问题 ​

这里整理使用 Oh my Codex 时最常见的问题。如果是第一次使用，建议先阅读新手教学。

快速定位

  • 第一次使用：查看新手教学
  • 图片生成或 Web Search：查看下方客户端配置问答
  • 401 或请求失败：先检查 API Key、Base URL 和客户端配置

一、开始使用 ​

Q1：第一次使用应该从哪里开始？ ​

先完成 API Key 申请，再安装 CC Switch，并按照新手教学中的步骤导入配置。导入完成后，打开 Codex 即可开始使用。

Q2：如何申请 API Key？ ​

登录控制台，进入左侧菜单的 API 密钥，点击 创建密钥，填写名称并选择分组。创建完成后，请立即把 Key 保存到安全的位置。

Q3：API Key 可以分享给别人吗？ ​

不建议分享。API Key 相当于账户访问凭证，任何拿到 Key 的人都可能消耗你的余额或额度。多人或多个客户端使用时，建议分别创建独立的 Key，便于管理和撤销。

Q4：可以在 Codex、Claude Code 和 CC Switch 中使用吗？ ​

可以。Codex 可按照新手教学导入配置；Claude Code 可在 CC Switch 中添加自定义供应商并开启本地路由。

二、客户端配置 ​

Q5：Base URL 应该怎么填写？ ​

请核对导入的供应商配置，不要自行修改域名、路径或协议。Codex 配置使用 https://www.ohmycodex.cn，并使用 responses 接口类型。

如果你修改过配置，保存后请完全退出并重新打开 Codex 或 CC Switch，避免客户端继续使用旧配置。

Q6：为什么会返回 401 Unauthorized？ ​

通常按以下顺序检查：

  1. API Key 是否完整复制，前后是否包含空格或换行。
  2. Key 是否仍然有效，是否已经被撤销或更换。
  3. Base URL 是否与导入的供应商配置一致。
  4. wire_api 是否填写为 responses，其他配置项是否有拼写错误。
  5. 修改配置后是否已经完全重启客户端。

排查时不要把完整 API Key 粘贴到截图、Issue 或聊天记录中。

Q7：订阅套餐后出现 authentication_failed 怎么办？ ​

先登录控制台，检查当前 API Key 所属的分组，并将其切换到与订阅套餐对应的分组。分组切换后，请重新导入或更新客户端中的配置，再完全退出并重新打开 Codex 或 CC Switch。

如果 API Key 没有切换到订阅对应的分组，请求可能无法使用订阅额度，或继续按照账户余额计费。如果切换后仍然报错，再按照上面的 401 Unauthorized 排查步骤检查 API Key、Base URL 和 wire_api 配置。

Q8：为什么图片生成功能不可用？ ​

Codex 图片生成需要使用正确的模型提供商配置，并保留对应的 http_headers 设置。如果是 Grok CLI 的 /imagine 无法生成图片，需要设置 GROK_XAI_API_BASE_URL 后完全退出并重新启动 Grok。请根据使用的客户端逐项检查配置。

Q9：为什么 5.6 系列模型的 Web Search 不可用？ ​

请在对应的模型提供商配置中启用 supports_standalone_web_search = true，并确认客户端实际加载的是这份配置。

Q10：为什么客户端里看不到某个模型或功能？ ​

模型和功能是否可用，取决于当前账号、服务端配置以及客户端版本。请先确认：

  • 客户端已经加载了正确的模型提供商配置；
  • 模型名称没有拼写错误；
  • 客户端和配置文件已经重启或重新加载；
  • 该模型或功能目前确实在服务端开放。

如果配置正确但仍然不可用，请记录模型名称、客户端版本和错误信息，再提交问题。

Q11：Claude Code 的 API 格式、模型映射和路由应该怎么配置？ ​

需要在供应商高级选项中将 API 格式改为 OpenAI Chat Completions（需开启路由），并根据需要填写模型映射。随后进入 设置 → 路由，打开路由总开关并启用 Claude 路由。

三、请求与服务问题 ​

Q12：请求很慢、超时或偶尔失败怎么办？ ​

先用一个简单的文本请求测试。如果简单请求也持续失败，优先检查网络、Base URL 和 API Key；如果只有长上下文、图片生成或 Web Search 请求失败，可能与请求类型、客户端配置或服务端能力有关。

建议记录发生时间、使用的模型、完整错误文本和是否重试成功。不要在反馈内容中包含 API Key、Cookie 或其他敏感信息。

Q13：如何判断是本地配置问题还是服务端问题？ ​

可以用下面的方法初步区分：

  • 401、认证失败：优先检查 API Key 和客户端配置；
  • 配置解析错误：优先检查 TOML/JSON 格式和字段拼写；
  • 连接超时、网关错误：检查网络后再重试，并关注服务公告；
  • 只有某个模型或能力失败：检查该模型的配置和当前可用状态。

这只是排查方向，最终仍应以完整错误信息和实际复现结果为准。

四、额度与价格 ​

Q14：倍率、余额和实际扣费如何理解？ ​

站内余额和模型调用会按照当前页面展示的计费倍率计算。倍率、套餐和可用资源可能随账号成本、线路和运营策略调整，最新数值请以控制台和站内公告为准。

Q15：为什么额度不是每个月固定不变？ ​

额度会受到官方账号策略、账号状态、模型调用方式和实际资源情况影响，因此文档中的产能数据只能作为参考，不能理解为对每个账号每个月的固定承诺。

Q16：计费右侧的 x2 小金标是什么意思？ ​

看到计费金额右侧的 x2 小金标，并不代表当前请求已经按两倍计费。这个标识表示你开启了长上下文能力；只有请求实际达到官方规定的长上下文计费条件时，才会触发对应的计费倍率。

以 OpenAI 为例，当上下文超过 256K tokens 时，请求会按两倍计费；未超过 256K tokens 时，仍按正常的一倍计费。不同模型、服务商和时期的长上下文阈值及计费规则可能不同，所有规则均以对应模型官方发布的最新说明为准。

计费明细右侧显示 x2 小金标的示意图
计费右侧的 x2 小金标表示已开启长上下文能力。

五、安全与问题反馈 ​

Q17：如果 API Key 不小心泄露了怎么办？ ​

立即在控制台撤销或删除旧 Key，重新创建一个新的 Key，并在所有客户端中替换。不要只修改本地配置后继续使用已经泄露的旧 Key。

Q18：提交问题时应该提供哪些信息？ ​

建议提供以下信息：

  • 使用的客户端和版本；
  • 使用的模型名称；
  • 问题发生的大致时间；
  • 完整错误文本或脱敏后的截图；
  • 是否更换过 Key、Base URL 或配置文件；
  • 是否可以稳定复现。

请务必先遮挡 API Key、Cookie、账号邮箱、支付信息和其他敏感数据。

Q19：如何加入群聊、订阅频道或联系客服？ ​

我们的群聊、频道和客服均设在 Telegram，可通过以下链接前往：

也可以打开本站的联系方式页面，选择对应入口。

群聊属于公开交流空间。请勿在群内发送 API Key、Cookie、账号邮箱、支付信息、日志原文或其他敏感内容；分享截图前请先完成脱敏。

本站仅面向海外用户提供服务。请不要向我们提供你的姓名、手机号、证件信息、住址、工作单位等个人信息，也不要提交任何能够识别你真实身份的内容。如果你主动披露的信息表明账号不符合本站的服务范围，出于运营与合规管理要求，我们将冻结相关账号。

Q20：为什么需要妥善处理个人隐私问题？ ​

为了网站能够长期、稳定地运营，请每位用户妥善保护自己的隐私。使用服务或反馈问题时，请主动对截图、日志和文字描述进行脱敏，不要向本站或其他用户披露任何能够识别你真实身份的信息。

Q22：这里没有找到我的问题怎么办？ ​

先按照新手教学重新核对流程，再根据上面的信息整理问题。描述越完整，越容易判断问题来自本地配置、网络环境还是服务端状态。

六、模型与服务说明 ​

Q23：你们这个中转站有没有模型掺水？ ​

没有。本站基于开源项目 Sub2API 搭建。Sub2API 原生没有提供模型掺水、随机替换模型或偷偷降级模型的选项，项目作者也没有把这类行为作为项目方向。因此，本站不会在服务端私自将你选择的模型替换成其他模型。

如果遇到模型表现、响应速度或输出效果异常，可以提供模型名称、发生时间和脱敏后的错误信息，我们会协助核查。

Q24：为什么开启了 Ultra 思考深度，后台显示的却是 Max？ ​

这是正常现象。Ultra 并不是服务端提供的独立思考深度，而是由本地提示词实现的一种 Highness 设计。启用 Ultra 后，Codex 会通过本地注入的提示词派发多个 Subagent，并由这些 Subagent 协同完成任务。

每个 Subagent 实际使用的仍然是 Max 思考深度，因此后台记录会显示为 Max。换句话说，Ultra 的本质是多个 Max 思考深度的 Subagent 协同工作，而不是一个高于 Max 的单模型思考等级。

七、客服聊天中常见的排查问题 ​

阅读说明

以下内容根据历史客服聊天中的共性问题整理，提供排查方向，不保证某一步一定能解决故障。聊天中的旧价格、福利和容量说明，不作为当前规则；实际配置、可用模型与活动条件请以当前控制台、对应教程和站内公告为准。

Q25：通过 CC Switch 切换后，Codex 为什么仍使用旧配置？ ​

先检查切换是否已经应用到当前使用的客户端，以及实际请求的 Base URL、模型提供商和模型名称是否与导入配置一致。只重启 CC Switch，不一定代表已经运行的 Codex 重新加载了配置。

保存配置后，完全退出并重新打开 Codex，再新建一个对话，用简单文本测试。如果新对话正常、旧对话仍异常，请在反馈时说明这个差异，不要直接认定 API Key 失效，也不要连续重建密钥。遇到 401 时，再按 Q6 检查认证和配置。

Q26：出现 429 Too Many Requests 应该怎么办？ ​

429 表示请求受到限制，但仅凭状态码无法确认限制来自当前分组、账号、服务端还是上游。请先停止持续重试，降低同时发送的请求数，检查当前分组的并发、RPM 或其他限制，并留意错误文本和服务公告。

如果错误提供了重试等待时间，按提示等待后再做少量测试。仍有问题时，提供分组名称、发生时间、当时的并发量和脱敏错误信息。不要通过固定频率无限轮询、增加重试数量或切换账号来规避限制。

Q27：出现 503 No available accounts 或 No available compatible accounts 是什么原因？ ​

错误说明该次请求没有匹配到可用账号，但不一定意味着你的 API Key 无效，也不能直接认定全部账号失效。可能需要核对请求模型、API Key 所属分组、接口格式及服务当时的可用状态。

先查看公告，再按当前教程检查配置；如果只有某个模型或功能失败，请记录它与正常请求的差异。不要把聊天中某次白名单调整或账号恢复的处理，理解为所有 503 都能用同一种办法解决。持续失败时，请提供模型、分组、客户端版本、时间和完整脱敏错误文本。

Q28：一直停在“思考中”或持续重连，怎么排查？ ​

先区分是等待首次输出、输出途中中断，还是工具执行停住：

  1. 在新对话中发送简单文本，检查最基本的请求是否正常。
  2. 对比是否只有旧对话、长上下文或特定功能卡住。
  3. 记录使用的模型、思考强度、等待时长、是否已经有输出，以及最终有没有错误提示。
  4. 检查网络和配置；如果使用公司内网，不要擅自改变网络策略或启用未经许可的代理。

新对话正常只能缩小排查范围，不能证明一定是上下文太长，也不代表原对话已经修复。请避免反复发送“继续”或无限重试，把对比结果交给客服核查。

Q29：首字慢或任务耗时长，能直接认定服务故障吗？ ​

不能。首次输出等待时间、持续输出速度和整个任务完成时间是不同指标；使用较高思考强度、长上下文或工具调用时，也可能出现较长等待。

排查时可以用相同模型、相近输入和简单任务做对比，并记录思考强度。必要时降低思考强度做一次对照测试，但这只是排查，不保证提速或保持相同输出效果。

ping 可以帮助了解网络延迟和丢包，不能直接证明模型的首 Token 延迟，更不能仅凭它判断慢响应来自本地、本站还是上游。

Q30：模型名称或日期后缀应该怎么填写？ ​

请使用当前控制台或模型列表中提供的完整模型 ID，不要自行省略后缀、修改大小写，或把相近名称当成同一个模型。展示名称、请求 ID 和底层路由不一定完全相同。

如果旧模型 ID 不可用，先重新获取当前列表并核对对应教程。不能根据历史聊天中的“默认都是最新版本”等说法，推断带日期和不带日期的名称当前仍指向同一版本；不确定时请提供实际请求 ID 让客服核查。

八、分组、计费与福利的易混淆问题 ​

Q31：推荐、特惠和企业分组有什么区别？ ​

请在当前控制台查看各分组的计价、可用模型、并发和其他限制。不要用历史聊天中的账号数量、并发数或“同一号池”等说法推断当前配置，也不要把“不限制并发”理解为无限承载能力或速度保证。

选择分组后，还要确认实际使用的 API Key 已选择对应分组。涉及订阅的使用方式请同时阅读 Q7；切换分组不代表必然能解决认证错误或慢响应。

Q32：界面显示 1X，就表示一次请求收费 1 吗？ ​

不能这样理解。倍率标识不是一次请求的金额；理解计费时需要同时核对模型价格、计费单位、实际用量、适用倍率和该条账单明细。

看到价格或倍率调整时，不要仅凭 1X 或聊天中的历史数值计算降价比例。如果页面说明与账单不一致，请提供发生时间、模型和已遮挡个人信息的账单截图，请客服核查。长上下文的 x2 标识另见 Q16。

Q33：注册、邀请、签到或充值赠送的福利，现在还能领取吗？ ​

请查看当前活动页面和公告中的参与条件、有效期、赠送对象、额度使用期限及领取入口。历史聊天中的优惠码、奖励数额、活动周期或清理时间，不表示同样规则现在仍有效。

不同充值入口或活动可能有不同权益，不要根据某次人工补发、补偿或个别到账结果推断所有用户都会获得相同奖励。对到账或额度变化有疑问时，请通过私密客服渠道提供必要的脱敏记录，不要在群内公开账户或支付信息。

九、客服能力与会话迁移 ​

Q34：自动客服能代替人工确认账号、余额或补偿吗？ ​

自动客服给出配置建议，不代表它已经读取或核实了你的后台数据。涉及账号状态、余额变化、实际扣费、退款或补偿时，需要人工根据实际记录确认，不能仅凭自动回复认定已经处理完成。

可以在客服窗口提出转人工的请求，并按 Q18 提供必要的脱敏信息。不要向自动客服发送完整 API Key、Cookie、服务器密码或其他秘密凭据。

Q35：把旧对话复制到新对话，是不是一定能解决卡顿？ ​

不一定。“复制到新对话”只是迁移已有对话内容，不等于修复网络、配置或服务端问题，也不保证客户端会完整保留原来的文件、工具状态和全部上下文。

如果要用新对话做对比，请先保留原记录，只复制继续处理任务所需的内容，并移除密钥和个人信息。若新对话恢复正常，请把这个结果作为排查线索反馈，不要把它当作确定根因或通用解法。