隐私设置

隐私和GDPR声明

Nfero 使用必要存储来保存语言偏好和演示访问控制。经您同意，Google Analytics 和轻量使用事件将用于改进模型演示和外部订阅路径。实时演示提示词可能会发送到已配置的阿里巴巴托管模型端点。

隐私政策服务条款数据处理

工具 + 模型配对

Codex 与阿里巴巴编码计划和令牌计划 (Token Plan)

来自 OpenAI 的命令行编程工具，可以与 Alibaba 兼容的编码工具在同一买家对话中运行。

Codex 可通过 `~/.codex/config.toml` 中的自定义提供程序连接 Alibaba Model Studio。兼容性取决于所选模型的 API 和 Codex 版本：阿里云官方文档当前仅针对部分 Qwen Token Plan 模型，通过 Responses API 明确列出支持的 Codex 版本。

选择我的接入方式 对比套餐

选择合适的访问方式

选择合适的访问方式

请搭配当前版本的 Codex 及支持 Responses 协议的 Qwen 模型使用 Token Plan。Alibaba 目前建议 Coding Plan 用户，以及选择其他仅支持 Chat/Completions 功能模型的用户，安装较旧版本的 Codex（例如 0.80.0）——在仅为使用 Codex 而订阅前，请务必评估该兼容性权衡。

推荐Token Plan 是当前 Codex 下更简洁、推荐的接入路径

Token Plan（团队版）

最适合搭配当前版本的 Codex 使用，且模型需为 qwen3.7-max、qwen3.7-plus、qwen3.6-plus 或 qwen3.6-flash，并通过 Responses API 调用。

Coding Plan

阿里云当前指南指出，Coding Plan 在此场景下仅支持 Chat/Completions 接口，并建议 Codex 用户安装较旧版本（例如 0.80.0）。

Pay-as-you-go Model Studio API

适用于生产环境/API 工作负载，或当受支持的 pay-as-you-go 模型与地域更契合您的应用需求时。

安全配置模式

配置支持 Responses 的 Token Plan 提供商

示例已做脱敏处理。请仅在本机替换占位符，切勿将真实的 API 密钥粘贴到 Nfero 中。

开始之前

  1. 安装 Node.js 18 或更高版本，并运行 `codex --version` 验证安装。
  2. 选择一个其 API 与您计划运行的 Codex 版本兼容的模型。
  3. 获取专用的 Token Plan 或 Coding Plan 密钥；请将其设为环境变量，而非直接写入 TOML 文件。
  4. 在替换现有 OpenAI 或自定义提供程序前，请先备份 `~/.codex/config.toml`。

安全配置模式

协议
OpenAI Responses API
配置路径
~/.codex/config.toml
  1. 在您的设备上将真实且专用的 API 密钥设为 `OPENAI_API_KEY` 环境变量；请勿将其硬编码写入下方配置文件。
  2. 为当前 Codex 版本，从 Alibaba 官方文档中选择一个明确标注支持 Responses 接口的 Qwen 模型。
  3. 添加自定义提供商，并使用该 Token Plan 对应的 base URL。
  4. 打开新终端，运行 `codex` 命令以验证配置是否生效。
toml
model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-plus"

[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

# Set locally; never paste the real value into this file or Nfero:
# OPENAI_API_KEY=YOUR_TOKEN_PLAN_API_KEY

验证连接

  • 打开一个新终端，确保 `OPENAI_API_KEY` 对 Codex 可用。
  • 运行 `codex --version`，并确认其版本与您所配置的 API 路由一致。
  • 启动 `codex`，并首先使用一个小型只读代码仓库的问题进行测试。
  • 如果某提供商切换器报告健康检查失败，请直接测试 Codex 本身；Alibaba 指出，某些探测格式即使在真实请求可正常工作的情况下也可能失败。

模型配对

推荐入门模型

使用本工具通过每个模型运行交互式编码、推理、审查和文档任务。在生产使用前，请在阿里云确认最终模型的可用性和确切计划支持。 (Alibaba Cloud)

Qwenqwen3.7-plus
文本生成推理视觉理解
最佳配对角度

在 Token Plan 下兼容 Responses，兼顾当前编码与推理能力的均衡之选。

Qwenqwen3.7-max
文本生成推理
最佳配对角度

面向复杂推理与代码仓库任务的 Token Plan 旗舰级 Responses 兼容模型。

Qwenqwen3.6-flash
文本生成推理视觉理解
最佳配对角度

面向长上下文任务的 Token Plan 替代方案，兼容 Responses。

常见问题

常见问题

现象描述

返回 400 错误请求，或提供商切换器提示国内模型不受支持

可能原因

第三方切换器的健康检查请求与 Codex 实际发送的请求不同。

解决方法

在拒绝该提供商前，请先从 Codex 直接测试；失败的探测未必代表实际兼容性问题。

现象描述

Responses API 错误或底层协议（wire-protocol）错误

可能原因

所选模型仅支持 Chat/Completions 接口，或当前 Codex 版本期望使用 Responses 接口。

解决方法

为当前 Codex 使用 Alibaba 文档中明确标注支持 Responses 的 Qwen 模型，或参考 Alibaba 针对旧版本提供的仅支持 Chat/Completions 路由的配置指南。

现象描述

返回 401 错误或缺失 API 密钥

可能原因

`OPENAI_API_KEY` 在新 Shell 环境中不可用，或该密钥属于另一条 Alibaba 计费路径。

解决方法

在环境变量中设置专用计划对应的 API 密钥，打开新终端，并将其与该计划的 base URL 配对使用。

现象描述

产生意外的 pay-as-you-go 扣费

可能原因

自定义提供商使用了通用 Model Studio 的 endpoint/密钥，而非对应计费计划专属的 endpoint/密钥组合。

解决方法

运行任务前，请检查 `model_provider`、`base_url` 及环境变量来源。

重要限制

  • 必须使用同一阿里云计费计划（如 Coding Plan、Alibaba Cloud Token Plan 或 Pay-as-you-go）中生成的专用 API 密钥与基础 URL。Coding Plan、Token Plan 及通用 Model Studio 凭据不可混用。
  • 计费计划密钥仅限分配给该用户的交互式编程或智能体工具使用。请勿共享、提交至代码仓库，或在截图中暴露。
  • 禁止将 Coding Plan 或 Token Plan 密钥用于自动化脚本、批量作业、应用后端、公共服务或其他非交互式 API 工作负载；此类场景请使用 pay-as-you-go Model Studio API 接入方式。
  • 模型可用性采用精确字符串白名单机制，且可能动态调整。编辑已生效配置前，请务必查阅当前阿里云计费计划文档确认模型 ID。

更多兼容工具

Claude Code OpenCode Open Code Review Cline