Skip to content

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 和终端,让新进程读取令牌。

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_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 验证模块。

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。