MaiToken
登录/注册

Codex

适用场景：

适合希望在终端或 Codex 本地客户端中使用 MaiToken 模型完成代码理解、代码修改和 Agent 任务的用户。
Codex 自定义模型提供商使用 Responses 协议。MaiToken 已提供 Responses API，因此 Base URL 填写 https://api.maitoken.com/v1 ，Codex 会自动请求 /v1/responses。

1. 确认 Responses API 可用

请根据操作系统选择对应的测试命令，并将 MaiToken Key 和模型 ID 替换为真实内容。

macOS / Linux
export MAITOKEN_API_KEY="<你的 MaiToken Key>"export MAITOKEN_MODEL="<模型ID>" curl -sS https://api.maitoken.com/v1/responses \  -H "Authorization: Bearer $MAITOKEN_API_KEY" \  -H "Content-Type: application/json" \  -d '{"model":"'"$MAITOKEN_MODEL"'","input":"只回复 OK","stream":false}'
Windows PowerShell
$env:MAITOKEN_API_KEY="<你的 MaiToken Key>"$env:MAITOKEN_MODEL="<模型ID>" $headers = @{  Authorization = "Bearer $env:MAITOKEN_API_KEY"} $body = @{  model  = $env:MAITOKEN_MODEL  input  = "只回复 OK"  stream = $false} | ConvertTo-Json Invoke-RestMethod `  -Method Post `  -Uri "https://api.maitoken.com/v1/responses" `  -Headers $headers `  -ContentType "application/json" `  -Body $body
如果接口返回正常的 response 对象或输出文字，即可继续配置。如果返回 404，请先确认 MaiToken Responses API 的准确路径。仅支持 Chat Completions 的接口无法用于此配置。

2. macOS / Linux 配置

  1. 检查 Codex： 打开终端并运行 codex --version。如果提示找不到命令，请先按照 Codex 的安装说明完成安装。

  2. 设置当前会话的 API Key： 运行以下命令：

export MAITOKEN_API_KEY="<你的 MaiToken Key>"

关闭当前终端窗口后，该环境变量会失效。在测试阶段使用临时环境变量更加安全。

  1. 创建配置目录： 运行以下命令：
mkdir -p ~/.codex
  1. 打开全局配置： 运行以下命令：
nano ~/.codex/config.toml

必须编辑用户目录下的全局配置文件，不要写入项目中的 .codex/config.toml。

  1. 粘贴配置： 将下面的内容粘贴到 config.toml，并将 <模型ID> 替换为模型限制列表中显示的准确 ID。
model = "<模型ID>"model_provider = "maitoken" [model_providers.maitoken]name = "MaiToken"base_url = "https://api.maitoken.com/v1"env_key = "MAITOKEN_API_KEY"wire_api = "responses"

  1. 保存文件： 在 nano 中按下 Control + O，按回车确认，然后按下 Control + X 退出。

  2. 启动 Codex： 进入一个测试项目目录并运行 codex。启动后，确认当前模型显示为您填写的模型 ID。

10.3 Windows PowerShell 配置

  1. 设置 API Key： 打开 PowerShell，运行以下命令：
$env:MAITOKEN_API_KEY="<你的 MaiToken Key>"
  1. 创建配置目录： 运行以下命令：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
  1. 打开配置文件： 运行以下命令：
notepad "$env:USERPROFILE\.codex\config.toml"

将下面的内容粘贴到配置文件中：

model = "<模型ID>"model_provider = "maitoken" [model_providers.maitoken]name = "MaiToken"base_url = "https://api.maitoken.com/v1"env_key = "MAITOKEN_API_KEY"wire_api = "responses"
  1. 启动 Codex： 保存配置文件，回到设置 API Key 的同一个 PowerShell 窗口，进入测试项目并运行 codex。
字段 填写内容
配置文件 macOS/Linux：~/.codex/config.toml；Windows：%USERPROFILE%\.codex\config.toml
model <模型ID>
base_url https://api.maitoken.com/v1
env_key MAITOKEN_API_KEY
wire_api responses

配置完成后这样测试

  1. 测试普通对话： 输入“只回复 OK”。如果收到正常回复，说明 API Key、Base URL 和模型 ID 基本正确。

  2. 测试项目读取： 打开一个测试项目，输入“请先列出当前目录中的一级文件，不要修改任何文件。”

  3. 测试 Agent： 获得目录读取结果后，让 Agent 新建一个名为 test-maitoken.txt 的文件并写入 hello。请勿使用真实生产项目进行测试。

常见问题

问题 处理建议
401 / Unauthorized 确认已经在启动 codex 的同一个终端窗口中设置 MAITOKEN_API_KEY，并检查 Key 前后是否包含多余空格。
404 /responses 确认 base_url 只填写到 /v1。如果平台 Responses API 的路径不是 /v1/responses，请按照实际接口文档调整。
model_not_found 从模型限制列表中复制准确的模型 ID，并确认该模型支持 Responses 格式。
普通回复成功但工具调用失败 模型或网关可能没有完整支持 Responses 工具调用，请换用支持代码 Agent 和工具调用的模型。