视频演示
Windows Codex 安装教程
通过视频和图文步骤，说明 Windows 用户如何下载、安装并完成 Codex App 的基础配置。
这篇教程适合第一次在 Windows 上安装 Codex App 的用户。建议先看视频，再按下面的步骤操作。
视频教程
安装地址
Windows 安装包下载地址：
https://codexapp.agentsmirror.com/#why
打开页面后，选择适合 Windows 的安装包下载。当前页面提供 Windows x64 .exe 安装包，适合大多数 64 位 Windows 电脑。
安装前检查
- 使用 Windows 10 或 Windows 11。
- 确认当前系统是 64 位版本。
- 浏览器能正常访问下载页面。
- 已准备好 GetToken API Key，后续配置 Codex 时会用到。
如果还没有 API Key，先打开控制台创建或复制：
text
https://gettoken.dev/console/api-keys
安装步骤
- 打开上面的 Codex App 安装地址。
- 下载 Windows x64
.exe安装包。 - 双击安装包，按安装向导完成安装。
- 如果 Windows 提示安全确认，确认文件来源后继续运行。
- 安装完成后，从开始菜单或桌面快捷方式打开 Codex App。
配置 GetToken
Codex App 会读取本机的 .codex 配置。Windows 配置目录是：
text
%USERPROFILE%\.codex
推荐使用 PowerShell 自动写入配置：
powershell
$env:GETTOKEN_API_KEY='<你的 GetToken API Key>'; $env:GETTOKEN_BASE_URL='https://api.clawto.link'; irm 'https://cdn.gettoken.dev/scripts/codex-install-config.ps1' | iex
脚本会自动创建配置目录，并写入 config.toml 和 auth.json。如果你已经有旧配置，脚本会先备份再覆盖。
验证是否可用
打开 Codex App 后，新建或打开一个项目，输入一句简单测试：
text
请用一句话介绍你自己
如果 Codex 能正常回复，说明安装和 API 配置已经生效。
常见问题
打不开安装包
优先确认下载是否完整。如果浏览器或系统拦截了文件，可以重新下载一次，并确认文件来源是上面的安装地址。
Codex App 没有读取到配置
检查下面两个文件是否存在：
text
%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json
如果文件不存在，重新执行上面的 PowerShell 自动配置命令。
请求失败或模型不可用
优先检查 API Key 是否复制完整，以及 base_url 是否配置为：
text
https://api.clawto.link
如果仍然失败，再查看「Codex App 配置」和「常见问题排查」两篇文档。