Windows CLI 安装与排错

返回 Codex 教学总目录

目标与适用环境

Windows 原生 CLI 不要求先装 WSL。若开启的是 Ubuntu、路径以 /home 开头，请改看Linux／WSL；本篇在 PowerShell 进行。先完成CLI 共用入门的环境判读，安装后再回去做单行修改练习。图的 1 是安装入口，2 是定位与登入，3 是独立读档验证。

安装前用 Windows 的 winver 画面确认版本。官方目前建议 Windows 11；近期且完整更新的 Windows 10 属尽力支援，并要求现代主控台能力，不能把所有旧版 Windows 都视为同等支援。原生沙盒另有 winget 与管理员核准设定等前提，详细条件见Windows 官方沙盒文件。先区分「CLI 安装完成」和「沙盒设定完成」，出错时记录停在哪一步。

步骤一：开对 PowerShell，选定安装管道

按开始选单搜寻 PowerShell，或在 Windows Terminal 的分页选单选 PowerShell。先用一般使用者视窗，不需要把所有日常工作都以系统管理员执行。在系统终端机输入下面第一行；若能找到 codex，先记录其版本与 Source，通常可直接跳到定位步骤，避免新增第二份安装。

Get-Command codex -All | Select-Object CommandType, Name, Source
codex --version

尚未安装时，第一行可能回报找不到命令，这是合理起点。官方目前提供下列 Windows 独立安装命令；它会下载并执行安装指令码，应从官方页面核对网址后才贴上。ByPass 是这次子程式的引数，不是要求你永久关闭电脑的执行政策；若公司管理政策阻挡，先记录具体讯息并使用管理员核准的安装方式。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

等待安装完成，保留最后显示的安装位置与 PATH 提示。关闭这个终端机，开一个新的 PowerShell，再跑 Get-Command codex -All 与 codex --version。预期至少有一个可执行来源及版本。不要把下载完成、资料夹存在或没有跳出错误视为命令已能使用；新的 shell 必须真的找得到它。

已有 Node.js 时的 npm 替代路线

只有选择 npm 管道时才执行下面三行；第一、二行都应显示版本，否则先解决 Node.js 安装，不要连续重试第三行。本例使用 npm.cmd 直接选 Windows 命令包装档，能避免把 npm.ps1 的执行政策问题误认成 Codex 安装失败。npm 不是独立安装版的必要前置工具。

node --version
npm.cmd --version
npm.cmd install -g @openai/codex

步骤二：建立有空格的路径并确认内容

选一个不在正式专案内、可写入的位置。包含 & { 与最后 } 的整段一起贴上，建立全新的 codex windows lab；这样存在检查失败时会停止整个区块。若已有同名资料夹，保留内容并另取新名称，不要跳过检查继续执行写档行。成功后会切进新资料夹，列档并读取 note.txt；引号保留空格，LiteralPath 避免把路径字元当成万用字元。

& {
  $cliLab = Join-Path (Get-Location) 'codex windows lab'
  if (Test-Path -LiteralPath $cliLab) { throw 'Choose a new practice folder name.' }
  New-Item -ItemType Directory -Path $cliLab -ErrorAction Stop
  Set-Location -LiteralPath $cliLab -ErrorAction Stop
  Set-Content -LiteralPath 'note.txt' -Value 'WINDOWS-CLI-01' -Encoding utf8 -ErrorAction Stop
  Get-Location
  Get-ChildItem
  Get-Content -LiteralPath 'note.txt'
}

成功时目前路径最后一段是 codex windows lab，清单有 note.txt，读取结果为 WINDOWS-CLI-01。另记录杂凑作为唯读前后的比较。杂凑表示档案位元组的指纹；不同电脑因 UTF-8 BOM 或换行差异可能不同，不要拿本文的数字当标准。本机前后应相同。

Get-FileHash -LiteralPath 'note.txt' -Algorithm SHA256

步骤三：登入、沙盒与实际读取

仍在练习资料夹，逐行执行 codex login、codex login status，再启动唯读工作阶段。浏览器登入时核对帐号与工作区；已登入不代表需要登出重来。若另一个 IDE 扩充套件共用认证，登出也可能影响它。看见登入程式码或凭证路径时不要放进公开截图。

codex login
codex login status
codex --sandbox read-only

Windows 沙盒设定可能需要一次管理员核准；这和把日常 PowerShell 视窗长期以管理员执行不同。官方以 elevated 为较强的原生选项，unelevated 是受限制的替代方式，组织可禁止替代。若初始化失败，先记录 Windows 版本、沙盒模式及错误阶段；不要直接把教学改成全存取模式。需要调整时先看权限与沙盒。

Read note.txt in the current practice folder. Report the exact content and current working directory. Do not edit, create files, or use external services. If it is missing or inaccessible, report the actual error.

上段贴进 Codex 对话，不是 PowerShell。回复和读取记录应包含 WINDOWS-CLI-01 及正确目录。先记录这个成功基准，再在同一个 Codex 工作阶段要求读取 missing-note.txt，预期回报不存在而不建立。接著用 /exit 回到 PowerShell，再执行读档、列档和杂凑，确认内容未变、没有新增练习档。若读到其他内容，先处理工作目录错误。

更新与三类排错

更新前先退出 CLI、保留工作摘要和未提交档案。独立版重跑同一个官方安装命令；npm 版再执行 npm.cmd install -g @openai/codex。开新 PowerShell，核对 Get-Command 的来源和版本。若显示旧版，先找重复来源；更新成功的是其中一份，PATH 仍可能先选另一份。不要只重复更新却不查实际执行档。

PATH 是 shell 搜寻程式的目录清单，不是专案清单。先对照安装输出与 Get-Command Source；需要手动修改时，在 Windows 搜寻「编辑帐户的环境变数」，编辑使用者 Path，新增已确认的安装资料夹，保留现有项目，储存后开新终端机。不要把整段 PATH 替换成教学范例，也不要新增来路不明的下载资料夹。

完成条件与下一步

你应能指出正在执行哪一份 CLI、从哪个资料夹启动、登入状态如何、读到的标记为何，以及唯读前后杂凑是否相同。把安装管道、版本、错误和解法记在自己的练习笔记即可，不需储存凭证内容。接著回CLI 共用入门完成小幅修改与接续；若要在编辑器工作，再看IDE 扩充套件。

返回 Codex 教学总目录

阅读完整文字说明

Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.

• AI 工具
• 教程
• Codex