一、Codex 适合怎么用

第一次使用 Codex，不建议一上来就让它大范围改项目。

更稳的方式是先让它读项目：

如果这一步能正常返回，说明至少完成了三个验证：

• Codex 能正常启动；
• 模型请求能正常返回；
• 当前项目目录能被读取和分析。

之后再让它做具体任务会更稳。

我个人更习惯这个节奏：

比如要改订单筛选，不要直接说“帮我改订单模块”，可以先这样说：

确认计划没问题后，再让它动手。

二、安装 Node.js

Codex 依赖 Node.js 环境。

安装完成后，打开 PowerShell，执行：

能看到版本号就说明环境可用。

如果提示 node 不是内部或外部命令，通常是下面几种原因：

• Node.js 没装成功；
• 安装后没有重新打开终端；
• 环境变量还没生效。

可以先关闭当前 PowerShell，重新打开一个终端再试。

三、安装 Codex

在 PowerShell 中执行：

安装完成后检查版本：

只要能正常输出版本号，就说明安装成功。

如果安装过程很慢，可以先检查自己的 npm 源配置：

网络环境不同，安装速度也会有差异。这里先以能完成安装为目标。

四、准备 Codex 配置文件

Codex 的配置文件一般在：

Windows 下可以直接用 PowerShell 打开：

如果文件不存在，直接新建即可。

写入下面这段配置：

这里重点看三行：

如果实际可用模型不是 gpt-5.5，就把 model 改成当前接口支持的模型名。

base_url 需要填写 OpenAI 兼容接口地址，通常以 /v1 结尾。不要把它写成普通页面地址，也不要漏掉 /v1。

五、写入 API Key

前面配置里的地址在文章中统一写成不带协议头的形式，避免被平台自动识别成外链；你自己填到本地配置文件时，按客户端要求补成完整 URL 即可。

如果你还没有可用的 API Key，可以去我常用的平台 kkflow.org 注册一个账号，然后在里面创建自己的 Key。这里不展开平台后台操作，本文重点还是放在 Codex 本地配置和项目跑通上。

第一次测试可以先在当前 PowerShell 会话里写入环境变量：

然后检查登录状态：

如果显示已登录，说明认证流程已经通过。

这里的 sk-你的密钥 是占位写法，实际使用时替换成自己的密钥。不要把真实密钥写进文章、截图、聊天记录或代码仓库。

六、重新打开终端

改完配置后，建议重新打开终端。

操作顺序是：

很多配置问题不是内容写错，而是当前终端还在使用旧状态。

七、进入项目启动 Codex

进入项目目录：

第一次启动后，先发只读指令：

如果能正常返回项目分析，说明基本流程已经跑通。

接下来可以继续让它找文件：

也可以让它先给计划：

这个习惯很重要。先看计划，再让它动手，能减少很多不必要的改动。

常见问题

1.codex命令找不到

优先检查：

• Node.js 是否安装成功；
• npm 是否可用；
• 是否执行过全局安装；
• 安装完成后是否重新打开终端。

可以重新执行：

2. 登录失败

常见原因：

• API Key 复制不完整；
• API Key 前后多了空格；
• 当前终端没有重新登录；
• 配置文件保存后没有重开终端。

可以重新执行：

3.model not found

这通常是模型名写错。

检查配置文件里的这一行：

如果当前接口支持的是其他模型名，就改成实际模型名。

4. 请求失败

重点检查 base_url：

常见错误包括：

• 少写 /v1；
• 多写了路径；
• 写成了普通页面地址；
• 配置保存后没有重开终端。

5. 改了配置还是不生效

按这个顺序重新来一遍：

建议的新手使用方式

1. 先读项目，不急着改

2. 修改前先要计划

3. 每次只做一个小任务

4. 改完看 diff

如果项目使用 Git，改完后执行：

不要只看工具的总结。

最短配置版

配置文件路径：

配置内容：

登录命令：

启动命令：

第一次测试：

总结

Codex 配置失败时，不要一上来就改一堆东西。

优先检查这几项：

• Node.js 和 npm 是否正常；
• codex --version 是否能输出版本号；
• config.toml 是否保存；
• base_url 是否以 /v1 结尾；
• model 是否是实际可用模型；
• API Key 是否登录成功；
• 修改配置后是否重新打开终端。

把这些跑通以后，再进入项目让 Codex 做只读分析。

先让它读懂项目，再让它给计划，最后再让它小范围修改。这个流程比直接让它大改项目稳定得多。