主题
Codex
这篇用 Windows 截图演示。ZCF 可以帮你安装 Codex，并快速配置模型、API、工作流和 MCP 服务。
开始前准备
请先确认你有：
- Windows 10 或 Windows 11
- PowerShell、Windows Terminal 或网页 IDE 里的终端
- 已安装 Node.js LTS
- 一个可用的爱次元 API Key
ZCF 通过 npx 运行，Codex 也会用到 npm 安装方式，所以必须先安装 Node.js。 如果还没有安装，请先按你的系统完成 Node.js 安装：
安装完成后，重新打开 PowerShell 或终端，执行：
powershell
node --version
npm --version
npx --version能看到版本号，再继续下一步。
1. 启动 ZCF
在终端中执行：
powershell
npx zcf@latest如果第一次运行时提示是否安装 zcf，输入 y 并回车。
先选择 ZCF 显示语言，中文用户选择：
text
简体中文
2. 切换到 Codex
进入 ZCF 主菜单后，输入：
text
s这个选项用于在支持的代码工具之间切换。
然后选择：
text
2. Codex
3. 完整初始化 Codex
切换到 Codex 菜单后，选择：
text
1. 完整初始化这个选项会安装 Codex，并继续配置 API、工作流和 MCP 服务。
选择 Codex 安装方式时，新手建议选择：
text
npm
4. 设置语言和提示词风格
AI 输出语言建议选择：
text
简体中文
Codex 配置语言也选择：
text
简体中文
然后选择系统提示词风格。 截图中选择的是 猫娘工程师，你也可以选择更正式的工程师风格。
5. 选择工作流
ZCF 会让你选择要安装的工作流类型。 用上下键移动，空格勾选，回车确认。
截图中选择了：
text
六步工作流
Git 指令不确定时，按截图选择即可。
6. 配置 API
API 配置模式选择：
text
自定义 API 配置
API 供应商选择：
text
自定义配置
接下来去爱次元后台复制 API Key。 打开 API 密钥 页面，点击密钥右侧的复制按钮，不建议手动输入。
回到终端后，按提示填写：
| 配置项 | 填写内容 |
|---|---|
| 提供商名称 | aicy |
| 基础 URL | 打开 API 地址，按文档说明填写 |
| API Key | 粘贴你的爱次元 API Key |
| 模型名称 | gpt-5.5 |
如果提示是否继续添加其他提供商，新手选择：
text
no
注意
API Key 是你的私密凭证，不要发给别人，也不要把完整密钥截图公开。
7. 选择 MCP 服务
MCP 服务可以给 Codex 增加文档查询、网页搜索、仓库检索等能力。 新手可以按截图选择常用项，也可以先保持默认。
8. 启动 Codex 测试
配置完成后，在项目目录里执行：
powershell
codex
第一次进入某个目录时，Codex 会询问是否信任当前目录。 如果这是你自己的项目，选择：
text
1. Yes, continue然后按回车继续。
进入 Codex 后，可以发送一句测试：
text
你是谁？你是什么模型？请你介绍你自己！如果能正常回复，并且界面里显示你配置的模型，就说明 Codex 已经可以使用。
常见问题
提示 npx 不是内部或外部命令
说明 Node.js 没装好，或者安装后没有重新打开终端。
请先按你的系统重新检查 Node.js 安装：Windows、macOS、Linux。
API 地址应该填什么？
请以 API 地址 文档中的当前推荐地址为准。 不同工具对 /v1 的要求可能不同，不要只照抄截图里的地址。
选错了配置怎么办？
重新运行：
powershell
npx zcf@latest进入 Codex 菜单后重新配置即可。