通过 config.toml 与 models.json 注册 EcoToken 自定义模型，并使用 OpenAI Responses API。

01 准备接入信息

先在 EcoToken 控制台创建 API Key，并确认该 API Key 可以访问 deepseek-v4.1-flash。

本文中的 YOUR_API_KEY 是占位符。只把真实 API Key 保存在本机配置中，不要提交到 Git、聊天记录或公开渠道。

02 安装 Codex CLI

如果已安装，可以跳过安装命令。推荐使用 v0.147.0 或更高版本。

npm install -g @openai/codex

03 方式一：EcoToken 工具配置

配置工具会更新 ~/.codex/config.toml 和 ~/.codex/models.json。仅当目标文件已有非空内容且本次配置会修改该内容时，工具才会在同一目录生成 <原文件名>.ecotoken.bak，保存修改前的内容。若文件原本不存在或为空，工具会直接写入目标文件，不生成备份。例如，models.json 原本不存在时，工具会创建 models.json，不会创建 models.json.ecotoken.bak。重复配置可能覆盖已有的同名备份文件。配置路径遵循 CODEX_HOME；工具会显示实际修改和生成备份的完整路径。

npm install -g @ecophase-ai/ecotoken

使用完整参数时，API Key 可能保存在 shell 历史中。更重视 API Key 安全时使用交互菜单。

恢复旧配置时，将实际存在的 .ecotoken.bak 文件复制回对应的原文件名即可。如果文件在首次配置前不存在，则需要删除工具创建的该文件，才能完全恢复到配置前状态。

04 方式二：手动配置

Codex CLI、ChatGPT 桌面端和 VS Code Codex 插件共用用户级 ~/.codex/config.toml 与 ~/.codex/models.json。先启动一次 Codex 完成初始化并退出，再打开这两个文件。

Set-Location "$env:USERPROFILE\.codex"
notepad config.toml
notepad models.json

将以下内容写入 config.toml：

model = "deepseek-v4.1-flash"
model_provider = "ecotoken"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

[model_providers.ecotoken]
name = "ecotoken"
base_url = "https://ecotoken.ecophase-ai.com/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

models.json 需要包含 Codex 识别模型名称、上下文长度和推理能力所需的完整元数据。可直接下载旧 EcoToken Portal 使用的 完整 models.json。

experimental_bearer_token 会把 API Key 保存到本机 config.toml。请确保该文件仅当前用户可读写，并且不进入版本库。

修改后必须完全退出并重新打开 Codex CLI、ChatGPT 桌面端或 VS Code。

05 启动并验证

cd /path/to/your-project
codex

启动信息显示 deepseek-v4.1-flash 或“自定义”，Agent 能返回模型内容，并且 EcoToken 控制台“用量与费用 → 请求记录”出现记录，即表示配置已加载。

06 常见错误

• 401：检查 experimental_bearer_token 中的 API Key 是否完整、是否已停用，并在修改后完全重启 Codex。
• 403：检查 API Key 分组、模型权限、账户状态和入口策略。
• model not found：模型名称必须与 models.json 和 EcoToken 控制台中的模型 ID 完全一致。
• Base URL：Codex 使用 https://ecotoken.ecophase-ai.com/v1。