Skip to content

Codex 使用教程 (Windows)

1. 安装 Codex

打开 PowerShell,运行以下命令全局安装 Codex CLI:

powershell
npm install -g @openai/codex@latest

安装完成后可验证版本:

powershell
codex --version

2. 设置环境变量

为了让 Codex 连接到镜像服务,需要设置环境变量。

方式一:临时设置(当前会话有效)

powershell
$env:OPENAI_API_KEY = "您的 KiCode API Key"

方式二:永久设置(用户环境变量)

powershell
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "您的 KiCode API Key", "User")

3. 配置 Codex

运行以下命令创建配置文件,跳过登录流程:

powershell
mkdir -p ~/.codex; @"
model_provider = "kicode"

[model_providers.kicode]
name = "kicode"
base_url = "https://kicode.chat/api/codex/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
"@ | Out-File -FilePath ~/.codex/config.toml -Encoding UTF8

如果之前执行过 codex login,请先清理本地登录态,避免继续携带 OpenAI JWT:

powershell
Remove-Item -Path "$env:USERPROFILE\.codex\auth.json" -Force -ErrorAction SilentlyContinue

4. 开始使用 Codex

进入你的项目目录,然后启动 Codex CLI:

powershell
cd your-project-folder
codex