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