常见问题

按 地址 → 密钥 → 分组与模型 → 客户端实际配置 → 请求日志 的顺序检查，通常比反复重装客户端更快。

401：认证失败

检查 Key 是否完整，是否误复制空格、引号或占位符；令牌是否撤销、过期或禁用。

Codex 手动配置要在启动它的终端设置 NOAH_API_KEY。CC Switch 模式则检查对应供应商保存的 Key。Claude 路由配置里的占位凭据不是真实 Noah Key，真实 Key 在 CC Switch。

检查余额、令牌额度、分组权限、模型白名单、IP 限制和控制台错误详情。状态码的具体含义可能随上游变化，以返回的错误消息为准。

模型广场中能看到某模型，不代表你的令牌和分组一定有权限调用。

留意重复的 /v1/v1 或 /responses/responses。Noah 当前公开目录未开放 Anthropic Messages，直接请求 /v1/messages 不是当前推荐接入方式。

确认模型 ID 拼写、大小写和完整后缀；检查令牌分组、模型限制与渠道状态。

示例模型 gpt-6.1-sol 不是所有账号永久保证可用的承诺。目录变化时，需要换成当前分组实际支持的模型。

Claude Code 转换模式还要检查默认回退模型，以及 Sonnet、Opus、Haiku 的映射，避免请求落到未提供的 claude-... 模型名。

先读返回的错误消息，再检查账户、令牌和模型的限制。若属于短时请求限流，降低并发并使用退避重试；不要在短时间内无限重复请求。

如果提示额度不足，应先解决额度或余额问题，等待重试不会自动恢复余额。

检查 用户级 ~/.codex/config.toml 中根级 model_provider = "noah" 与对应供应商配置。不要只配置项目内的文件。

确认启动进程能读取所用环境变量，退出旧进程后重启。使用 CC Switch 时，还要确认 Noah 已启用并处于预期模式。

当前 CC Switch 的模型映射表会生成本地模型目录，Codex 在启动时加载它。补齐模型映射表后重新启动 Codex，再查看 /model。

模型目录只控制客户端展示，不会给 Noah 令牌增加模型权限。

检查 CC Switch 本地路由是否仍在运行、是否已执行「开始路由」、Noah 卡片是否已「路由到此」，以及监听端口是否改变。

路由模式不能只配置供应商就关闭本地服务。默认端口为 127.0.0.1:15721，以自己的路由设置为准。

用 /status 查看实际 API 地址和凭据来源。检查旧会话、终端环境变量、用户 settings.json 中的 env、项目设置和 CC Switch 当前供应商。

使用 CC Switch 的环境变量冲突检查功能，并在新终端、新会话里再次验证。不要假设终端变量在所有情况下都覆盖设置文件。

本教程使用协议转换与模型映射。Sonnet、Opus、Haiku 是 Claude Code 的客户端档位，实际请求模型由 CC Switch 映射决定；本套初始配置全部映射到 gpt-6.1-sol。

这并不是在提供原生 Claude 模型。以路由日志和 Noah 实际模型字段为准。

编码工具还依赖流式输出、工具调用、上下文和推理参数等能力。查看具体上游错误与 CC Switch 转换日志，确认使用的是正确协议，不要随意添加超大上下文或未经支持的参数。

查看分组与计费。模型广场选定分组后的价格已经包含倍率，重复相乘会低估费用；缓存、推理或工具费用也可能影响结果。

CC Switch 或客户端的估算不一定使用 Noah 的实际价格，最终以 Noah 控制台请求记录为准。

提供客户端及 CC Switch 版本、使用模式、模型、分组、发生时间、HTTP 状态码和脱敏后的错误消息。若控制台提供请求 ID，也一并提供，方便定位。

不要提交完整 API Key、带凭据的配置文件或未经检查的日志截图。