Codex 配置 OpenAI 兼容 Base URL：Windows 下从安装到跑通项目分析

Codex 配置 OpenAI 兼容 Base URLWindows 下从安装到跑通项目分析最近在 Windows 上重新整理了一遍Codex的配置流程发现新手最容易卡住的不是提示词而是本地环境、配置文件和base_url。这篇文章按实操顺序记录一遍安装 Node.js 安装 Codex 配置 OpenAI 兼容 Base URL 写入 API Key 进入项目做只读测试本文使用的示例配置如下配置项示例base_url见下方配置示例modelgpt-5.5配置文件%USERPROFILE%\.codex\config.toml登录方式API Key注意表格里的模型名只是示例实际使用时以当前接口支持的模型名为准。一、Codex 适合怎么用第一次使用Codex不建议一上来就让它大范围改项目。更稳的方式是先让它读项目先不要修改任何文件。请阅读当前项目结构告诉我这是一个什么项目主要目录分别负责什么。如果这一步能正常返回说明至少完成了三个验证Codex能正常启动模型请求能正常返回当前项目目录能被读取和分析。之后再让它做具体任务会更稳。我个人更习惯这个节奏先分析 - 再计划 - 小范围修改 - 最后验证比如要改订单筛选不要直接说“帮我改订单模块”可以先这样说我要给订单列表增加一个状态筛选。你先不要修改文件先帮我找相关文件并给出修改计划。确认计划没问题后再让它动手。二、安装 Node.jsCodex依赖 Node.js 环境。安装完成后打开 PowerShell执行node-v npm-v能看到版本号就说明环境可用。如果提示node不是内部或外部命令通常是下面几种原因Node.js 没装成功安装后没有重新打开终端环境变量还没生效。可以先关闭当前 PowerShell重新打开一个终端再试。三、安装 Codex在 PowerShell 中执行npm install-g openai/codex安装完成后检查版本codex--version只要能正常输出版本号就说明安装成功。如果安装过程很慢可以先检查自己的 npm 源配置npm config get registry网络环境不同安装速度也会有差异。这里先以能完成安装为目标。四、准备 Codex 配置文件Codex 的配置文件一般在%USERPROFILE%\.codex\config.tomlWindows 下可以直接用 PowerShell 打开notepad$env:USERPROFILE\.codex\config.toml如果文件不存在直接新建即可。写入下面这段配置model_provider OpenAI model gpt-5.5 [model_providers.OpenAI] name OpenAI base_url kkflow.org/v1 wire_api responses requires_openai_auth true这里重点看三行model gpt-5.5 base_url 上面配置里的 /v1 地址 wire_api responses如果实际可用模型不是gpt-5.5就把model改成当前接口支持的模型名。base_url需要填写 OpenAI 兼容接口地址通常以/v1结尾。不要把它写成普通页面地址也不要漏掉/v1。五、写入 API Key前面配置里的地址在文章中统一写成不带协议头的形式避免被平台自动识别成外链你自己填到本地配置文件时按客户端要求补成完整 URL 即可。如果你还没有可用的 API Key可以去我常用的平台kkflow.org注册一个账号然后在里面创建自己的 Key。这里不展开平台后台操作本文重点还是放在 Codex 本地配置和项目跑通上。第一次测试可以先在当前 PowerShell 会话里写入环境变量$env:OPENAI_API_KEYsk-你的密钥$env:OPENAI_API_KEY|codex login--with-api-key然后检查登录状态codex login status如果显示已登录说明认证流程已经通过。这里的sk-你的密钥是占位写法实际使用时替换成自己的密钥。不要把真实密钥写进文章、截图、聊天记录或代码仓库。六、重新打开终端改完配置后建议重新打开终端。操作顺序是保存 config.toml 完成 codex login 关闭当前 PowerShell 重新打开 PowerShell 进入项目目录 启动 codex很多配置问题不是内容写错而是当前终端还在使用旧状态。七、进入项目启动 Codex进入项目目录cd D:\your-project codex第一次启动后先发只读指令先不要修改任何文件。请阅读当前项目结构告诉我这是一个什么项目主要目录分别负责什么。如果能正常返回项目分析说明基本流程已经跑通。接下来可以继续让它找文件我要修改登录后的用户信息展示。先帮我找相关文件说明每个文件大概负责什么不要改代码。也可以让它先给计划我要给订单列表增加状态筛选。请先给修改计划列出可能要改的文件等我确认后再修改。这个习惯很重要。先看计划再让它动手能减少很多不必要的改动。八、常见问题1.codex命令找不到优先检查Node.js 是否安装成功npm 是否可用是否执行过全局安装安装完成后是否重新打开终端。可以重新执行npm install-g openai/codex codex--version2. 登录失败常见原因API Key 复制不完整API Key 前后多了空格当前终端没有重新登录配置文件保存后没有重开终端。可以重新执行$env:OPENAI_API_KEYsk-你的密钥$env:OPENAI_API_KEY|codex login--with-api-key codex login status3.model not found这通常是模型名写错。检查配置文件里的这一行model gpt-5.5如果当前接口支持的是其他模型名就改成实际模型名。4. 请求失败重点检查base_urlbase_url 你的 OpenAI 兼容接口地址常见错误包括少写/v1多写了路径写成了普通页面地址配置保存后没有重开终端。5. 改了配置还是不生效按这个顺序重新来一遍保存 config.toml 重新登录 关闭终端 打开新终端 进入项目目录 启动 codex九、建议的新手使用方式1. 先读项目不急着改先不要修改文件帮我分析这个项目的目录结构。2. 修改前先要计划先给我修改计划列出可能要改的文件等我确认后再动手。3. 每次只做一个小任务只改订单列表筛选部分不要改其他功能。4. 改完看 diff如果项目使用 Git改完后执行git status gitdiff不要只看工具的总结。十、最短配置版配置文件路径%USERPROFILE%\.codex\config.toml配置内容model_provider OpenAI model gpt-5.5 [model_providers.OpenAI] name OpenAI base_url 同上填写前文配置里的 /v1 地址 wire_api responses requires_openai_auth true登录命令$env:OPENAI_API_KEYsk-你的密钥$env:OPENAI_API_KEY|codex login--with-api-key codex login status启动命令cd D:\your-project codex第一次测试先不要修改任何文件。请阅读当前项目结构告诉我这是一个什么项目主要目录分别负责什么。十一、总结Codex配置失败时不要一上来就改一堆东西。优先检查这几项Node.js 和 npm 是否正常codex --version是否能输出版本号config.toml是否保存base_url是否以/v1结尾model是否是实际可用模型API Key 是否登录成功修改配置后是否重新打开终端。把这些跑通以后再进入项目让Codex做只读分析。先让它读懂项目再让它给计划最后再让它小范围修改。这个流程比直接让它大改项目稳定得多。