Windows Setup Guide

CodeX 完整安裝與設定教學

適用 Windows 環境：從 Node.js、CodeX CLI、Codex API，到常見問題排查，一頁完成。

開始安裝 查看常見問題

1. 安裝 Node.js

先安裝 Node.js（建議 LTS 版本）。安裝後重新開啟 PowerShell 或命令提示字元，確認可用。

node --version
npm --version

2. 安裝 CodeX CLI

以管理員身分開啟 PowerShell 後執行：

# 全域安裝 CodeX
npm install -g @openai/codex@latest

# 驗證安裝
codex --version

解決權限問題

  1. 右鍵「開始」按鈕，選擇 PowerShell（管理員）或命令提示字元（管理員）。
  2. 重新執行安裝命令。
  3. 如果仍失敗，於 PowerShell 設定執行策略：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 配置 Codex API

先到 Codex 控制台建立分組令牌（API Key），再依序建立設定檔。

3.1 建立設定目錄

mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex

3.2 建立 config.toml

model_provider = "codex"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
base_url = "https://api.zwenooo.link/v1"
name = "Codex"
requires_openai_auth = false
wire_api = "responses"

[tools]
web_search = true

3.3 建立 auth.json

{
  "OPENAI_API_KEY": "貼上你的 Codex 專用分組令牌 key"
}

4. 初始化專案並開始使用

mkdir my-codex-project
cd my-codex-project
codex

若要於 VS Code / Cursor / Trae 等編輯器使用，於擴充商店搜尋 OpenAI 相關插件即可。

常見問題

環境變數問題

  • 重啟 PowerShell / 命令提示字元。
  • 確認 PATH 包含 C:\Program Files\nodejs\。

防火牆與安全軟體

  • 暫時關閉防火牆/防毒測試。
  • 將 Node.js 與 npm 加入信任清單。
  • 企業網絡請配合代理設定。

代理配置

npm config set proxy http://proxy-server:port
npm config set https-proxy http://proxy-server:port
npm config list

字符編碼問題

chcp 65001

長路徑支持

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force