Skip to Content
工具调用Codex

Codex 接入指南

Codex 是 OpenAI 官方推出的命令行 AI 编程助手。本指南介绍如何将其接入 AMAX Token Router。

准备工作

接入方式

方式一：快速接入（推荐）

编辑 ~/.codex/config.toml（如果文件不存在则创建）：

openai_base_url = "https://ai.amaxsmp.com/v1"
model = "gpt-4o"

然后设置 API Key 环境变量：

export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

启动 Codex：

codex

注意：openai_base_url 必须带 /v1 后缀。此配置仅支持在 ~/.codex/config.toml（用户级）中设置，项目级 .codex/config.toml 会忽略该字段。

方式二：自定义模型提供商

如果需要完整控制，在 ~/.codex/config.toml 中定义自定义提供商：

model = "gpt-4o"
model_provider = "amax"
 
[model_providers.amax]
name = "AMAX Token Router"
base_url = "https://ai.amaxsmp.com/v1"
env_key = "AMAX_API_KEY"

然后设置环境变量：

export AMAX_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

模型切换

  • 配置文件切换：修改 ~/.codex/config.toml 中的 model 值
  • 运行时切换：在 Codex 中输入 /model，从模型列表中选择

如需使用智能模型路由，将 model 设为 amax-router。

代码示例

直接调用

codex -p "解释这段代码的功能" code.py

交互模式

codex

常见问题

提示网络错误

确认 openai_base_url 包含了 /v1 后缀。正确格式：

openai_base_url = "https://ai.amaxsmp.com/v1"

鉴权失败

确认：

  • OPENAI_API_KEY 环境变量已正确设置
  • API Key 前缀正确（sk- 开头）
  • API Key 在控制台中未被禁用

超时

可在 ~/.codex/config.toml 中调整超时参数：

request_max_retries = 6
stream_idle_timeout_ms = 600000

参考

Claude CodeTrae