Codex
这页只讲一件事：怎么把 Codex 配好，并让它通过 WorkFree AI 使用。
Codex 是 OpenAI 的命令行编程工具。你可以把它理解成一个会在终端里帮你读代码、改代码、跑命令的助手。
先选择配置方式
配置 Codex 只需要选择一种方式。新手默认推荐使用配置文件方式：页面会根据你的 API Key 生成可直接复制的命令，复制到终端运行后，关闭并重新打开 Codex 即可生效。如果你更习惯图形界面，再使用 CC Switch 备用方案。不要两种方式都配置，避免互相覆盖。
推荐：使用配置文件
适合新手，填写 API Key 后复制页面生成的命令到终端执行。
备用：使用 CC Switch
适合喜欢图形界面的用户，在桌面应用里填写 WorkFreeAI 地址和 API Key。
先确认这些
先确认电脑里有 Node.js。Codex CLI 需要 Node.js 运行，如果版本太旧，安装时很容易报错。
- 建议安装 Node.js LTS 版本。
- 安装后在终端输入 node -v，能看到版本号就说明安装好了。
- 如果版本低于 18，先升级 Node.js，再继续下面的步骤。
1. 把 Codex CLI 装好
打开终端或 PowerShell，按官方方式安装 Codex CLI。这里不要急着改配置，先确认 codex 命令能正常运行。
2. 拿到 API KEY
API KEY 就像一把钥匙。Codex 需要用它连接到 WorkFree AI 的服务，所以请先在平台里创建一个可用的 API KEY。
3. 填好配置
把 API KEY 和接口地址写到 Codex 的配置文件里。你只需要替换自己的 API KEY，其他字段先按示例保持不动。
- 不要把 API KEY 发到公开仓库。
- 如果配置后还是连不上，优先检查 API KEY 是否复制完整。
- 如果网络不稳定，再去看网络线路怎么选。
4. 跑一下确认
运行一次简单的 Codex 命令。如果它能正常返回，就说明配置已经生效。接下来就可以在项目目录里让 Codex 帮你读代码、改代码了。
容易卡住的地方
- 提示命令不存在：通常是 Codex CLI 没装好，或者终端没有重新打开。
- 提示认证失败：通常是 API KEY 写错、复制漏了，或者 Key 已被删除。
- 请求超时：先换线路，或者检查代理和网络环境。