从 Codex 客户端安装，到使用第三方 API 令牌完成登录配置。本教程用于帮助客户快速完成安装、配置和验证。

<WRAP important> API 密钥属于敏感信息，只应保存在自己的设备中。示例中的 sk- 只是格式说明，必须替换为你自己创建的令牌。 </WRAP>

建议从 Codex 官方页面获取最新客户端。安装包会随版本更新，因此这里保留官方下载入口，不在本站重复托管安装文件。

官方下载页面：

打开 Codex 官方下载页面

下载 .msix 安装包后双击运行，按照系统提示完成安装。

如果首次打开时遇到系统拦截，请确认安装包来自官方页面，再继续安装。

Apple 芯片选择 ARM 版本，老款 Intel Mac 选择 Intel 版本。

如果不确定芯片类型，可以在“关于本机”中查看“芯片”或“处理器”字段。

1. 打开 XC Tokens。
2. 完成注册并进入“钱包”页面。
3. 按实际需求充值。
4. 进入“API 密钥”页面，创建一个新的 API 令牌。
5. 复制令牌并妥善保存。

注意：API 令牌通常只会完整显示一次，请不要发送给他人。

关闭 Codex 后，打开 Codex 配置目录。

如果已有旧的 auth 和 config 文件，可以按教程重新创建。

请注意文件后缀必须分别为：

• auth.json
• config.toml

在 auth.json 中填入 API 令牌：

{
  "OPENAI_API_KEY": "sk-替换为你自己的API令牌"
}

config.toml 的具体内容请使用 API 服务商提供的配置模板，不要猜测或混用不同服务商的地址。

配置完成后保存文件，重新打开 Codex，检查是否可以正常使用。

如果使用 CC-Switch 管理多个配置，可以将创建好的 API Key 导入后，再选择对应配置使用。

根据自己的系统安装管理员提供的 CC-Switch 安装包：

• Windows：安装 CC-Switch Windows 版本
• macOS：安装 CC-Switch macOS 版本

安装完成后打开 CC-Switch。

1. 打开 CC-Switch。
2. 进入令牌或 API Key 管理页面。
3. 添加刚才在 API 平台创建的 API 令牌。
4. 填写名称后保存。
5. 在配置列表中选择刚导入的项目。
6. 将该项目设置为当前使用配置。
7. 打开 Codex，确认已经使用新配置。

如果配置没有立即生效，请关闭 Codex 后重新打开。

不可以。API Key 等同于账号访问凭证，只能自己保存。

可以依次检查：

1. API Key 是否复制完整。
2. auth.json 文件名是否正确。
3. config.toml 文件名是否正确。
4. 配置文件是否放在正确目录。
5. Codex 是否已经完全关闭并重新打开。
6. API 平台余额是否充足。

建议把视频上传到 COS 或对象存储，然后把视频链接放到教程里。

示例：

点击查看视频教程

这样不会占用服务器带宽、硬盘和内存。