Codex Windows 入门

Windows 安装 Codex CLI 后,怎样完成首次项目运行

首次使用可以按安装、登录、选目录和样例任务依次进行。下面以 Windows PowerShell 与 Codex CLI 为例;桌面应用和编辑器扩展的入口不同,需要按各自界面操作。

更新:2026-10-18

通过官方入口选择适合的安装方式

打开文末的 Codex CLI 官方安装页,切换到 Windows 选项,按当前显示的步骤安装。采用 npm 渠道时还需先满足该渠道的 Node.js 条件;已有安装的电脑先确认来源和版本,再按对应渠道更新,避免多个安装相互混淆。

Windows 原生运行已经是官方支持的使用方式,无需把 WSL 当作统一前提。项目依赖 Linux 工具、现有工作流位于 WSL2,或原生环境不适合时,再评估 WSL。企业设备同时遵守组织的软件与网络管理要求。

在新终端检查程序与登录

安装完成后打开新的 PowerShell 窗口,检查命令位置和版本。若所选安装提供 codex.cmd,可用下面的命令核对;不同安装渠道的入口以安装页与 Get-Command 的实际结果为准。

启动后按提示选择可用的登录方式。ChatGPT 登录与 API 按量使用有不同的账户和费用来源,自定义服务则另按配置文档处理。登录完成后,在本机核对状态,不把登录成功当作完整任务已验收。

Get-Command codex*
codex.cmd --version
codex.cmd --help

从一个已存在的小项目开始

先准备样例目录,放入 README 和少量允许使用的文件。路径中的 sample-project 是示例,请替换为实际目录;确认目录存在后再启动。现有代码项目可先检查版本状态,保留可恢复的检查点。

阅读当前沙箱与权限提示,按工作需要设置范围。原生 Windows 沙箱的可用方式会受设备版本和组织策略影响,以本机界面及官方 Windows 说明为准。首次任务可以要求解释样例文件与项目结构,并列出需要进一步确认的内容。

Test-Path "D:\Projects\sample-project"
codex.cmd -C "D:\Projects\sample-project"

检查成果后再开展正式任务

需要写文件或运行脚本时,先说明允许的操作、输出位置与验收标准。完成后打开输出,核对执行结果和修改差异;使用按量服务还应查看本次用量。发现问题时保留脱敏日志,按失败环节排查。

把已确认的启动方式、项目说明和检查命令写进交接记录。需要处理工艺研发资料、复杂脚本或多软件任务时,可按具体需求选择 Codex 工作流或小蓝助手服务,并以实际工具条件和成果要求确定实施范围。