Windows 安装原生 Codex CLI 配置 AI 代码助手
前言
Codex CLI 是 OpenAI 发布的开源编程智能体,定位为终端运行的轻量级开发辅助工具,兼容 o3、o4-mini 等大模型。可使用自然语言指令完成代码生成、重构测试及文件操作等任务。其技术特性包括沙盒执行环境、192k 令牌上下文长度及多模态编程支持,最低内存要求 4GB,支持 macOS、Linux 及 Windows 11 WSL2 系统。
一、基础环境
1. 操作系统
Windows 11
2. 工具版本
- PowerShell-7.6.0
- nvm-1.2.2
- Node-v24.13.0
- Npm-11.6.2
- Codex-0.116.0
- CC-Switch-v3.12.0
二、部署
1. 安装 PowerShell 7
说明:这里安装 powershell7 是为了解决中文乱码问题
1.1 以管理员身份运行 cmd
1.2 安装 powershell7
winget install --id Microsoft.PowerShell --source winget
2. 安装 Node.js
2.1 安装 nvm
下载并安装 nvm-setup.exe
2.2 安装 Node&npm
win + r 输入 pwsh 回车
nvm ls //查看当前已安装的 nodejs 版本
nvm list available //查看可安装的 nodejs LTS 版本
nvm install 24.13.0 //安装 nodejs 24.13.0 版本
node -v //查看当前安装的 node 版本
npm -v //查看当前安装的 npm 版本
3. 安装 Codex
npm install -g @openai/codex
说明:如果已安装则自动更新。
同理 claude-code 也可以通过同样方式安装:
npm install -g @anthropic-ai/claude-code
4. 安装 CC-Switch
说明:这是一个配置 api 切换工具
下载 CC-Switch-v3.12.0-Windows.msi 安装包
5. 配置 CC-Switch
5.1 获取公益 api key
访问相关 API 服务站点注册获取
5.2 选择 Codex 点击'添加供应商'
注意:上方选项栏选择 codex
将之前获取的配置复制到对应的'api key'、'auth.json (JSON) *'和'config.toml (TOML)'内即可
5.3 配置测试
在 CC-Switch 界面进行连接测试
三、Codex 简单使用
1. Powershell7 中输入 codex 回车
cd 到你想用的工作目录输入 codex 回车就回在这个目录形成对应的 sandbox 模型沙盒


