Windows安装原生Codex CLI 让你拥有更强力的AI代码助手！【支持GPT5.4、GPT5.3-codex】

前言

  Codex CLI是OpenAI于2025年4月17日发布的开源编程智能体，定位为终端运行的轻量级开发辅助工具，兼容同期发布的o3、o4-mini大模型，可使用自然语言指令完成代码生成、重构测试及文件操作等任务 。其技术特性包括沙盒执行环境、192k令牌上下文长度及多模态编程支持，最低内存要求4GB，支持macOS、Linux及Windows 11 WSL2系统 。

一、基础环境

1.操作系统

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【提取码：3sxh】

2.2 安装Node&npm

win + r 输入pwsh回车

nvm ls								//查看当前已安装的nodejs版本
nvm list available			//查看可安装的nodejs LTS版本
nvm install 24.13.0		//安装nodejs24.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【提取码：hufv】

5.配置CC-Switch

5.1获取公益api key

• 哈基米公益站

说明：注册就不再赘述了，直接描述登录进去后如何用

5.2选择Codex 点击“添加供应商”

注意：上方选项栏选择codex

说明：将之前获取的配置复制到对应的“api key” 、“auth.json (JSON) *”和 “config.toml (TOML)”内即可，官网链接：https://ai.td.ee/ ，名称图标随意

5.3配置测试

三、Codex简单使用

1.Powershell7中输入codex回车

说明：cd 到你想用的工作目录输入codex回车就回在这个目录行程对应的sandbox模型沙盒

codex -a never -s danger-full-access  //权限全开，无需审批
claude --dangerously-skip-permissions //权限全开，无需审批

2.Codex CLI 常用命令说明

指令	中文释义	详细说明
/model	选择使用的模型及推理算力	用来切换 Codex 背后的 AI 模型（比如不同版本的代码模型），还能调整推理的「算力 / 精细度」—— 算力越高，代码生成越精准，但速度稍慢。
/init	初始化创建一个AGENTS.md文件，包含Codex的使用说明	「重置 / 初始化当前的会话环境」，具体行为包括：清空当前会话的上下文、重置 Codex 的沙箱环境、恢复所有指令的默认配置、保留模型选择
/fast	开启 / 关闭快速模式（开启后推理最快，但消耗 2 倍套餐额度）	快捷切换「极速模式」：开启后代码生成速度翻倍，但会消耗双倍的 API 额度 / 套餐时长；适合赶时间写简单代码时用。
/permissions	配置 Codex 允许执行的操作权限	管理 Codex 的权限边界，比如是否允许它读取本地文件、执行终端命令、修改代码文件等；新手建议先限制权限，避免误操作。
/sandbox-add-read-dir <absolute_path>	允许沙箱读取指定目录（用法：/sandbox-add-read-dir <绝对路径>）	给 Codex 的「沙箱环境」授权，让它能读取你指定的文件夹（必须填绝对路径，比如 /Users/xxx/project）；比如想让 Codex 分析你项目里的代码，就用这个指令授权。
/experimental	开启 / 关闭实验性功能	切换是否使用 Codex 的测试版功能（可能不稳定，但会有新特性，比如多文件联动、代码实时调试）；新手建议默认关闭，避免出问题。
/skills	使用技能插件，优化 Codex 处理特定任务的表现	调用 Codex 的「技能库」，比如让它用「Python 性能优化」「前端样式调试」「Shell 脚本纠错」等专属技能处理对应任务，提升针对性。
/review	检查我当前的代码修改，找出问题	让 Codex 审核你刚改的代码，自动识别 Bug、语法错误、逻辑漏洞、不规范的写法（比如未定义的变量、缩进问题）。
/rename	重命名当前对话线程	给当前的 Codex 聊天 / 操作会话起个名字（比如「用户中心接口开发」），方便后续查找历史会话，尤其适合多任务并行时用。
/resume	查看历史会话	直接运行 codex resume，它会打开历史会话选择器。 最近一次会话可以用 codex resume –last

3.Codex使用测试

/model								//切换模型

为gpt-5.3-codex选择推理级别
1.低						快速响应，推理较浅
2.中等(默认)					在日常任务中平衡速度和推理深度
3.高						为复杂问题提供更深层次的推理
4.超高						为复杂问题提供额外高的推理深度

提问：
当前支持最大上下文是多少

/init				// 模型读取当前工作目录下的代码工程总结成一个md文档（相当于告诉模型当前的项目工程信息便于指导后续操作）

提示：这里97%为上下文长度

 /resume						 查看问题历史记录

codex resume --last				 恢复最近一次会话

四、Codex进阶使用（接入VS Code）

1.进入扩展页面搜索codex 并安装对应插件

说明：安装第一个名为Codex – OpenAI’s coding agent

2.重启vscode点击gpt图标

提示：无需登录 等待加载完毕即可使用（因为前面已经配置过CC，它会自动读取配置文件）

3.查看监控

说明：可以看到User-Agent一列显示为codex_vscode

提示：个人感觉用法跟终端命令行没啥区别，但是速度明显不如轻量级的cli终端快。还是建议大家直接使用CLI终端即可！

结束语

  感谢大家耐心看完本篇博客，本次 Codex CLI 安装使用分享就先告一段落啦。后续还会带来更多实用功能演示和详细讲解，觉得内容不错的话，别忘了给作者点赞、收藏、关注哦！

---