Codex CLI 接入 302API:Responses 配置指南
配置自定义服务商、模型和环境变量,通过 Responses 接口使用本站 API,并排查认证与地址问题。
维护说明:2026-10-16 已核对本站接口文档与客户端官方配置文档;本页没有新增客户端付费调用测试。客户端升级可能改变行为,请先记录版本,再用小任务核对调用记录。
1. 准备环境
运行 codex --version 记录本机版本。安装方式见 Codex CLI 官方文档。创建本站 Key 后,将它保存在本地环境变量 API302_KEY;不需要把 Key 写入本文的 TOML 文件。
默认配置位于 ~/.codex/config.toml;Windows 用户目录中通常是 %USERPROFILE%\.codex\config.toml。若设置了 CODEX_HOME,请使用对应目录。修改前备份,合并字段而非覆盖原配置。
2. 配置 Responses 服务商
model = "gpt-6-luna"
model_provider = "302api"
[model_providers.302api]
name = "302API"
base_url = "https://api.302api.com/v1"
env_key = "API302_KEY"
wire_api = "responses"
supports_websockets = false使用自定义服务商名称 302api,不要占用内置的 openai 标识。Base URL 带 /v1,不填写完整 /responses 路径。本站按 SSE 接入,配置中关闭 WebSocket 传输。
env_key 是环境变量的名称,不是密钥本身。环境变量要在启动 Codex 的终端或父进程中可见;已有进程不会自动读取刚改的终端环境。
可用模型包含 gpt-6-luna、gpt-6-sol 与 gpt-6-astra。示例选用 Luna;价格与长上下文条件见 Luna 详情。
3. 启动并核对请求
codex确认当前配置选用自定义服务商和准确模型后,发送一个短任务。调用会消耗本站余额;先确认预算。检查完整结束状态,并在控制台对应到请求时间、模型、用量和结算金额。
Responses 的 HTTP 200 仍可能带 error 或 incomplete 状态;只看界面出现文本或预占余额变化,不能认定调用完整成功。接口格式对照见 Responses 文档。
常见配置问题
仍然使用其他登录账号或服务商
检查 model_provider 是否为 302api、是否存在 profile 或命令行覆盖,确认修改的是实际使用的配置目录。保留原账号配置,先定位生效来源。
提示缺少 API302_KEY
在启动 Codex 的同一个环境设置变量;env_key 里只填写 API302_KEY 这个名字,不能粘贴实际密钥。Windows PowerShell 环境变量语法与 bash 不同。
404 / 协议或地址错误
应为 https://api.302api.com/v1 和 wire_api = "responses",不是 Chat Completions 配置,也不要写成 /v1/v1。
出现不完整输出或重试
先查看结束原因、输出预算和调用记录。推理也消耗输出用量,网络中断时结果可能已产生;不要用反复自动重试掩盖问题。
参考与下一步
官方自定义服务商配置 · 官方配置字段参考 · Luna API 价格 · 本站快速开始