必须修改本地config.toml配置第三方api地址并设置环境变量密钥才能让codex调用非openai模型;windows路径为%userprofile%.codex,macos为~/.codex;base_url须以/v1结尾且env_key需与系统环境变量名完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让 Codex App 调用非 OpenAI 的模型(比如 GPT-5.5、Claude 3.5 或国内大模型),必须修改本地配置文件指向第三方 API 地址,否则它默认只连 OpenAI 官方服务,根本收不到响应。
确认配置目录位置
Windows 用户按 Win + R → 输入 %USERPROFILE%\.codex → 回车;macOS 用户打开终端执行 open ~/.codex。这个文件夹必须存在且可写,否则后续所有配置都会失效。
如果目录不存在,Codex 第一次启动后会自动生成。但别等它自动建——先手动创建空文件夹再启动,能避免权限错乱导致的 config.toml 无法保存问题。
编辑 config.toml 文件
在 .codex 目录下找到或新建 config.toml,用记事本(Windows)或 TextEdit(macOS)以纯文本模式打开。
把以下内容完整复制进去,替换掉原有全部内容:
model = "gpt-5.5"<br>model_provider = "myapi"<br>personality = "pragmatic"<br>model_reasoning_effort = "medium"<br><br>[model_providers.myapi]<br>name = "My Third-Party API"<br>base_url = "https://api.example.com/v1"<br>wire_api = "responses"<br>env_key = "MY_API_KEY"
【base_url 必须以 /v1 结尾】,少一个斜杠或写成 /v1/ 都会导致连接失败;【env_key 字段名必须和你后面设的系统环境变量完全一致】,大小写敏感,不能多空格。
把 https://api.example.com/v1 换成你实际拿到的第三方 API 地址(例如 Token侠是 https://token.easyapi.com/v1,HongMacc 是 https://hongmacc.com/v1)。
设置 API Key(安全方式)
方法一:通过系统环境变量(推荐)
Windows:右键“此电脑”→属性→高级系统设置→环境变量→系统变量→新建→变量名填 MY_API_KEY,变量值粘贴你的密钥(sk-开头那一串)→确定保存。
macOS:终端执行 echo 'export MY_API_KEY="sk-xxx"' >> ~/.zshrc && source ~/.zshrc。
方法二:直接写进 .env 文件(仅限测试)
在 .codex 目录下新建文件 .env,内容只有一行:MY_API_KEY=sk-xxx。注意不要有多余空行或空格,否则 Codex 会解析失败。
不推荐把密钥硬编码进 config.toml —— 一旦误传到 GitHub 或共享截图,密钥就彻底暴露了。
重启并验证是否生效
第一步:关闭所有 Codex 进程(任务管理器或活动监视器里杀干净);
第二步:重新双击桌面图标启动;
第三步:随便输入一句“你好”,观察左下角状态栏是否显示“Connecting to myapi”而不是“Connecting to openai”。
如果显示连接超时或报错 401 Unauthorized,立刻检查:① 环境变量名是否拼错;② 密钥是否复制完整(尤其注意前后有没有空格);③ base_url 是否带了多余的 query 参数(如 ?key=xxx)。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











