跳到主要内容

CodexCLI 安装教程（Windows）

Windows 上你有两种常见用法：

  • 方案 一（推荐）：在 WSL2 里安装和运行
  • 方案 二：直接在 PowerShell 里安装和运行

下面两套我都写了，你按自己的环境选一个。

前置：安装 Node.js​

先装 Node.js（建议 22+）：Nodejs Windows

验证：

node -vnpm -v

方案 A：PowerShell 原生安装​

安装 Codex​

第一步：全局安装 Codex

npm install -g @openai/codex

第二步：验证安装

codex --version

配置 Codex（接入Constreet）​

2.1 配置文件在哪里？​

配置目录：%USERPROFILE%\.codex

什么意思？

  • 完整路径是：C:\Users\你的用户名\.codex\

2.2 创建配置目录​

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

2.3 写入主配置文件 config.toml​

@'model_provider = "Constreet"model = "gpt-5.2-codex"approval_policy = "on-request"[model_providers.Constreet]name = "Constreet"base_url = "https://api.constreet.cc/v1"wire_api = "responses"requires_openai_auth = true'@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8

配置说明：

  • model_provider - 使用的服务提供商（这里是 Constreet）
  • model - 默认使用的模型
  • approval_policy - 执行代码前是否需要确认（on-request 表示需要）
  • base_url - Constreet的服务地址
  • wire_api - 使用 OpenAI 兼容格式

2.4 写入认证文件 auth.json（注意替换 API Key）​

@'{  "OPENAI_API_KEY": "你的Constreet Key"}'@ | Set-Content -Path "$env:USERPROFILE\.codex\auth.json" -Encoding UTF8

必须替换：把 你的Constreet Key 替换成你从Constreet官网复制的真实 Key

启动并验证​

cd C:\path\to\your\projectcodex

方案 二：WSL2​

  1. 先安装 WSL2 并进入 Linux 子系统
  2. 在 WSL2 里按 Linux 教程做：

Codex Linux