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 install24.13.0 //安装nodejs24.13.0版本 node-v //查看当前安装的node版本 npm-v //查看当前安装的npm版本 说明：从图中可以看出我已经安装过了，所以这里不再做演示
3.安装Codex
npminstall-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模型沙盒
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 安装使用分享就先告一段落啦。后续还会带来更多实用功能演示和详细讲解，觉得内容不错的话，别忘了给作者点赞、收藏、关注哦！
