AI 工具使用指南
整理 Windows、macOS 与 Linux 的 Codex App、CLI 和 IDE 扩展安装方式，并补充 API 填写与 CC Switch 绑定入口说明。
三种方式，一次选对。
想要完整桌面体验，选择 App；习惯终端，选择 CLI；希望留在编辑器里，选择 IDE 扩展。
Codex App
选择你的系统，页面只显示当前需要的步骤。
打开 Codex 官方商店页面，或 打开 OpenAI 官方页面，点击“获取 / 安装”。也可以直接使用 winget。
启动 Codex App，推荐使用 ChatGPT 账号完成登录。
点击 Add project，或按 Ctrl + O 选择本地代码目录。随后可在 Settings 中设置 Windows Native / WSL、编辑器和终端。
适用于 M1、M2、M3、M4 等 Apple 芯片 Mac。下载官方 Codex.dmg
双击 DMG，把 Codex 拖入“应用程序”文件夹。
按 macOS 安全提示允许应用启动，然后登录并选择项目目录。
仅适用于 Intel 处理器 Mac。下载官方 x64 DMG
把 Codex 拖入 Applications，启动后登录并打开项目。
Linux 用户现阶段可使用 Codex CLI，或安装 VS Code、Cursor、Windsurf 对应的 IDE 扩展。
Codex CLI
适合 macOS、Linux 和 Windows WSL。需要 Node.js 与 npm。
Windows 用户涉及 Linux 工具链或仓库时，优先在 WSL 工作区运行。
IDE Extension
VS Code、Cursor、Windsurf 与 VS Code Insiders 均可按官方页面提供的入口安装。
进入 Codex 帮助中心，选择你使用的编辑器。
如果安装后侧边栏没有出现 Codex 图标，重启编辑器一次。
使用 ChatGPT 账号或 OpenAI API Key 登录，然后直接在当前项目中发送第一条任务。
补充入口
API 填写与 CC Switch 绑定各自做成独立页面，保持和 Codex 安装指南相同的阅读风格。
三个接入地址怎么写、密钥和分组怎么选、Codex 的 config.toml 完整示例，以及真实模型名与报错对照。
查看填写方法接入方式、Base URL、上游协议、默认模型与模型列表参数的逐项填法，配实机截图与字段速查表。
查看设置步骤Claude Code、Codex、Gemini CLI 三个客户端的地址与字段、后台一键导入的五步流程、手动配置 JSON/TOML、切换生效与排错表。
查看配置步骤产品入口和分发方式可能变化，遇到异常时优先回到官方页面核对。
打开产品页Windows 排障
在 PowerShell 或 Windows 终端中运行以下命令，再重新安装。