← 返回系统教程
系统教程WindowsApp / CLI / IDE入门

在 Windows 上使用 Codex:原生应用、CLI 与 WSL 的选择

按桌面体验、本地工具链和 Linux 兼容需求选择 Windows 运行方式,并排查路径、代理和终端差异。

35 分钟阅读核验于 2026/07/21

按工作目录选环境

Windows 原生项目优先使用原生应用或 CLI;依赖 Linux 工具链的项目优先在 WSL 内保持代码、依赖和 Git 一致。避免同一仓库在两套环境交替生成依赖。

先检查三个差异

核对路径格式、代理与证书、默认 shell。发生安装或认证问题时,记录 codex 版本、Windows 版本和实际终端。

做最小仓库验证

先运行只读任务和项目现有检查,再测试写入。涉及跨文件系统路径时特别检查性能与文件权限。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Codex Quickstart

    官方来源 · https://learn.chatgpt.com/docs/quickstart

  2. OpenAI Codex:Troubleshooting

    官方来源 · https://learn.chatgpt.com/docs/reference/troubleshooting

  3. openai/codex 官方仓库

    官方来源 · https://github.com/openai/codex

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。