Windows 安装指南

本指南面向 Windows 用户，使用放心API 作为 API 服务商，完成 Codex CLI 的完整安装与配置。

系统要求

Windows 10（版本 1809 / build 17763）及以上，或 Windows 11

需要已安装 Node.js（npm），参考《Claude Code Windows 安装指南中的步骤 1-2

网络可正常访问（无需科学上网，放心API已做国内加速）

安装步骤

步骤 1：安装 Codex

打开 PowerShell，运行：

npm install -g @openai/codex

安装完成后验证：

codex -V

输出版本号说明安装成功。

建议使用 PowerShell（蓝色图标）而不是 CMD，功能更强大。如果遇到权限问题，右键 PowerShell → 以管理员身份运行，再重新执行安装命令。

步骤 2：注册放心API并获取 API Key

打开浏览器，访问 https://fangxinapi.com 注册账号并登录

进入「API 密钥」或「令牌管理」页面，点击「新建密钥」，选择 Codex 分组

复制生成的 API Key，妥善保存，页面关闭后无法再次查看

步骤 3：初始化配置目录

在 PowerShell 中执行以下命令，清空并重建 Codex 配置目录：

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Path "$env:USERPROFILE\.codex"

步骤 4：创建 auth.json

在配置目录下新建 auth.json，填入步骤 2 中复制的 API Key。

在 PowerShell 中执行（将 你的API_KEY 替换为实际密钥）：

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

或者用记事本手动创建：

打开记事本，写入以下内容：

{
  "OPENAI_API_KEY": "你的API_KEY"
}

另存为 C:\Users\你的用户名\.codex\auth.json，编码选择 UTF-8

步骤 5：创建 config.toml

在 PowerShell 中执行，原封不动粘贴，不要修改：

@'
model_provider = "fangxin"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.fangxin]
name = "fangxin"
base_url = "https://fangxinapi.com/v1"
wire_api = "responses"
'@ | Set-Content "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8

或者用记事本手动创建，另存为 C:\Users\你的用户名\.codex\config.toml，编码选择 UTF-8。

步骤 6：验证安装

重新打开 PowerShell，运行：

codex -V

然后进入任意项目目录，启动 Codex：

cd C:\Users\你的用户名\Desktop
codex

开始使用

# 进入你的项目目录
cd C:\path\to\your-project

# 启动 Codex
codex

常用命令：

codex            # 启动交互模式
codex -V         # 查看版本
codex --help     # 查看帮助

Codex 完全支持 VSCode 官方插件，安装后可在 VSCode 中直接使用。

常见问题

❌ command not found: codex / 无法识别 codex

原因：npm 全局安装路径不在 PATH 中，或安装后未刷新环境变量。

解决方法：关闭所有 PowerShell 窗口，重新打开后再试。若仍不行，重启电脑。

❌ 401 Unauthorized / Invalid API Key

排查步骤：

打开 C:\Users\你的用户名\.codex\auth.json，确认 OPENAI_API_KEY 已替换为实际密钥

登录放心API控制台，确认该 Key 属于 Codex 分组，且处于启用状态并有余额

重新打开 PowerShell 后再试

❌ 连接失败 / 无法访问模型

排查步骤：

打开 C:\Users\你的用户名\.codex\config.toml，确认 base_url 为 https://fangxinapi.com/v1

确认 wire_api = "responses" 未被修改

确认两个文件保存时编码均为 UTF-8，不是 UTF-8 BOM 或 ANSI

❌ PowerShell 提示「无法加载文件，因为在此系统上禁止运行脚本」

解决方法：以管理员身份打开 PowerShell，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认，然后重新运行安装命令。

系统要求#

安装步骤#

步骤 1：安装 Codex#

步骤 2：注册放心API并获取 API Key#

步骤 3：初始化配置目录#

步骤 4：创建 auth.json#

步骤 5：创建 config.toml#

步骤 6：验证安装#

开始使用#

常见问题#

❌ command not found: codex / 无法识别 codex#

❌ 401 Unauthorized / Invalid API Key#

❌ 连接失败 / 无法访问模型#

❌ PowerShell 提示「无法加载文件，因为在此系统上禁止运行脚本」#