首页 / Codex / Windows / CLI
Codex Windows 安装教程:先装好,再接团队 AI 网关
这篇给团队成员直接照做:从一台新 Windows 电脑开始,安装 Codex App 或 CLI,验证命令可用,然后接到统一 API 网关。
先判断你需要 App 还是 CLI
Codex App 适合图形化使用和本地项目选择;Codex CLI 适合开发团队统一发教程、统一配置 ~/.codex/config.toml,也更方便在终端里和项目一起工作。
Codex App
适合第一次上手。安装后打开应用,登录 ChatGPT 账号或 API key,再选择本地项目。
Codex CLI
适合团队批量接入。所有成员用同一份安装命令和配置模板,后续排查也更清楚。
Windows 安装 Codex CLI
在 PowerShell 里运行官方 Windows 安装命令:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"如果是无人值守安装,可以先设置 CODEX_NON_INTERACTIVE:
$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex安装后做两个验证
- 重新打开 PowerShell,避免 PATH 还没刷新。
- 运行
codex --version,能输出版本号就说明 CLI 已可用。
codex --version如果提示 codex 不是内部或外部命令,优先重开终端;还不行再检查安装脚本是否执行完整。
下一步接入团队网关
安装完成后,把成员引导到 config.toml 页面。团队统一网关通常只需要一份配置模板加个人令牌:
model = "your-codex-model"
model_provider = "izkl-gateway"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
model_reasoning_effort = "high"
[model_providers.izkl-gateway]
name = "izkl AI Gateway"
base_url = "https://izkl.top/v1"
requires_openai_auth = true
wire_api = "responses"配置文件路径是 C:\Users\你的用户名\.codex\config.toml,不是项目目录里的临时配置。
常见问题
Windows 可以安装 Codex CLI 吗?
可以。Codex CLI 支持 Windows,Windows 用户可以使用 PowerShell 安装脚本。
安装完找不到 codex 命令怎么办?
先关闭并重新打开 PowerShell,再运行 codex --version。仍失败时检查 PATH 和安装日志。