codex Windows版配置第三方api教程-人工智能-PHP中文网

codex桌面版需通过修改auth.json和config.toml配置文件调用第三方api，关键在于确保auth.json为utf-8无bom编码、config.toml中model_provider与方括号名称一致且wire_api设为"responses"。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex windows版配置第三方api教程

要在Windows系统上让Codex桌面版调用第三方API（比如Token侠、YIHE、147AI等渠道提供的GPT-5-Codex或DeepSeek模型），必须绕过官方登录限制，直接接管配置文件路径并确保协议兼容。官方客户端默认只认OPENAI_API_KEY和OpenAI官方地址，强行填入第三方参数会被忽略，导致“missing api key”或“model not found”报错。

确认Codex是否为桌面版而非CLI

打开任务管理器 → 查看“进程”页签 → 找到名为 Codex.exe 的进程。若存在，说明你安装的是桌面客户端（.exe安装包），不是npm安装的CLI命令行工具。这一步很关键：【CLI版不读config.toml，桌面版才读】。如果看到的是codex.cmd或node进程，立刻卸载CLI，重新从官网下载Windows安装包。

桌面版默认安装路径为：C:\Users\{用户名}\AppData\Local\Programs\Codex\。启动后会在用户目录生成隐藏文件夹 C:\Users\{用户名}\.codex，所有配置都存在这里。

准备第三方API三要素

向服务商控制台获取以下三项内容，缺一不可：

Base URL（必须以 /v1 结尾，且支持 /v1/responses 接口）
API Key（sk-开头，注意不是Bearer Token或Session ID）
完整模型名（如 gpt-5-codex、deepseek/deepseek-v4-flash，不能简写为deepseek-v4）

⚠️ 特别注意：很多网关只提供 /v1/chat/completions，但Codex桌面版强制走 /v1/responses。若服务商文档未明确标注支持responses接口，配置后必定失败——此时需换服务商或改用codex-relay代理。

手动创建并编辑两个核心配置文件

第一步：打开文件资源管理器 → 在地址栏粘贴 C:\Users\{用户名}\.codex → 回车。若提示“找不到该文件”，点击上方“查看”→勾选“隐藏的项目”，再刷新。

第二步：在该文件夹内新建两个空白文本文件，分别命名为：auth.json 和 config.toml。

第三步：用记事本（不要用Word）打开 auth.json，粘贴以下内容（把 sk-xxx 替换为你的真实API Key）：

{"OPENAI_API_KEY": "sk-xxx"}

第四步：用记事本打开 config.toml，按顺序填入以下配置（以YIHE为例，其他服务商仅需替换base_url、model、model_provider三处）：

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "medium"
disable_response_storage = false
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://z.apiyihe.org/v1"
wire_api = "responses"

DeepSeek

DeepSeek是一款由深度求索公司开发的免费AI助手，支持Web端和移动端使用。它拥有强大的自然语言处理能力，可进行文本对话、内容创作、代码编写、文件处理（支持图像、PDF、Word、Excel、PPT等格式）以及联网搜索。DeepSeek上下文长度达1M tokens，能一次性处理海量信息（如《三体》三部曲）。其核心优势在于完全免费、响应迅速、支持语音输入，并提供API服务，适合学习、办公和开发等多种场景。

下载

✅ 关键点：model_provider值（如api111）必须与下方[ ]中括号内的名称完全一致；wire_api必须为"responses"；base_url末尾不能漏掉/v1。