外观
Codex 配置
Codex 使用 Responses。default、正价纯pro号池、plus池 的文本接入均可按本页配置;正价纯pro号池 不使用 Chat Completions。
使用 CC Switch 管理供应商时,打开CC Switch v4.0.25 图文教程;通过页面上方“配置方式”可在同一任务的两种教程之间切换。
先确认分组
日常文本配置可用 default、正价纯pro号池 或 plus池 的 Responses。技能生图默认推荐正价纯pro号池,plus池 也支持;兼容模式与 API Key Mode 选择 plus池。分组区别见快速开始。
1. 设置令牌
推荐先把 FQHX_API_KEY 保存为 Windows 用户环境变量,然后重开终端和客户端。步骤见用户环境变量配置。
修改用户变量后,完全退出并重新打开 Codex 和终端,让新进程读取令牌。
bash
export FQHX_API_KEY="sk-替换为你的令牌"Windows 用户变量会在后续新进程中继续生效;macOS/Linux 的 export 示例作用于当前终端及其子进程。令牌不写入项目仓库。
2. 找到用户级配置文件
如显式设置了 CODEX_HOME,配置文件位于该目录的 config.toml。提供商配置放在用户级文件中,不放在项目内 .codex/config.toml。
默认文件:%USERPROFILE%\.codex\config.toml。
在文件资源管理器地址栏粘贴 %USERPROFILE%\.codex 并打开。目录不存在时在用户文件夹中手动新建 .codex;用记事本打开 config.toml,没有则新建。保存类型选“所有文件”,确保文件名不是 config.toml.txt。
默认文件:~/.codex/config.toml。
macOS 在 Finder 中选择“前往 → 前往文件夹”,粘贴 ~/.codex;Linux 在文件管理器中打开用户主目录的 .codex 文件夹,必要时启用“显示隐藏文件”。目录不存在时手动创建,再用纯文本编辑器打开或新建 config.toml。
设置了 CODEX_HOME 时,在它指定的实际目录中编辑文件。
3. 写入配置
两类系统使用相同 TOML 内容。先通过自己的令牌确认 gpt-6.1-sol 可见,也可换成模型目录中可用的 GPT 文本 ID。
toml
model = "gpt-6.1-sol"
model_provider = "fq_hx"
[model_providers.fq_hx]
name = "FQHX"
base_url = "https://newapi.fq-hx.com/v1"
env_key = "FQHX_API_KEY"
wire_api = "responses"4. 启动与检查
保存配置后,重开终端并运行:
text
codex在 Codex 中发送一条简单消息即可开始使用。需要排查接口时,统一查看首页 HTTP 验证模块的 Responses 标签。
配置遇到问题时展开
| 现象 | 检查项 |
|---|---|
| 找不到 provider | 用户级配置文件位置和 CODEX_HOME 覆盖设置 |
返回 401 | 启动进程能否读取 FQHX_API_KEY |
| 协议错误 | wire_api 是否为 responses,地址是否以 /v1 结尾 |
| 工具调用失败 | 所选模型与当前渠道是否支持对应的工具及事件 |
图片生成:选择一条教程
三种方式均保留 GPT 文本主模型,示例使用 gpt-6.1-sol,按所选方式准备图片权限。本站推荐使用技能生图,教程默认选正价纯pro号池,plus池 也支持。
需要排查接口时,使用首页 HTTP 验证模块。