开始使用 Codex

第一次使用只需要完成账户准备、创建 ApiKey，再选择一种 Codex 使用方式。不需要提前安装所有 CLI，也不需要先理解全部模型和接口参数。

1. 准备账户和 ApiKey

1. 完成充值，确保账户有可用余额或套餐。
2. 创建 ApiKey，并为密钥选择可用分组。

首次使用可以先沿用后台推荐的模型配置。成功运行 Codex 后，再到渠道与模型了解模型名称、价格和 BaseUrl。

2. 选择使用方式

Codex 桌面版和 Codex CLI 都是主要支持的使用方式，它们共用同一套本地配置。

使用方式	适合人群	本地要求
Codex 桌面版（新手推荐）	希望用图形界面打开项目、查看任务和代码改动	Windows 或 macOS，无需 Node.js
Codex CLI（终端推荐）	熟悉命令行，希望直接在终端中使用 Codex	需要 Node.js 和 npm

提示

不确定怎么选时，先使用 Codex 桌面版。以后切换到 CLI 或 IDE 扩展时，不需要重新维护一套配置。

3. 导入配置

两种使用方式都推荐通过 CC-Switch 导入配置：

1. 安装并打开一次 CC-Switch。
2. 回到后台的 API 密钥 页面，点击目标密钥旁的 导入到 CCS。
3. 确认应用类型为 Codex，并启用刚导入的配置。
4. 完全退出并重新打开 Codex 桌面版，或重新启动 Codex CLI。

CC-Switch 只是配置工具，不是另一种 Codex 客户端。如果无法使用 CC-Switch，可以改用 Codex 手动配置。

4. 完成首次验证

• 桌面版：选择 Codex，打开一个本地项目并发送第一条任务。
• CLI：在项目目录中运行 codex，进入会话后发送第一条消息。

只要能够正常收到回复，基础配置就已经完成。后续遇到模型、余额或客户端问题，可以查看使用常见问题。