客户端接入
Codex 下载与安装
Windows / macOS / Linux 上安装 Codex App、CLI 与 IDE 扩展的官方步骤，装完再接 TUTUJING API。
一、先选安装形态
Codex 有三种形态，按工作习惯选一个即可，装完再用 如何填写API 接上本站。
| 形态 | 适合 | 入口 |
|---|---|---|
| Codex App | 新手、日常开发：项目 / 线程 / 终端 / 代码审查在一个桌面空间 | Windows 用 Microsoft Store；macOS 用官方 DMG |
| Codex CLI | 终端工作流、自动化、WSL | npm install -g @openai/codex |
| IDE 扩展 | 不想离开 VS Code / Cursor / Windsurf | 官方帮助中心选编辑器 |
二、Windows 桌面 App
1
从 Microsoft Store 安装
打开 Codex 官方商店页面，点「获取 / 安装」。也可以用 winget：
PowerShell
winget install Codex -s msstore
2
登录
启动后可以先按官方流程登录 ChatGPT 账号；要接本站 API，见 如何填写API 和 Codex++。
3
添加项目
点 Add project 或按 Ctrl + O 选择代码目录。随后在 Settings 里设置 Windows Native / WSL、编辑器与终端。
只从官方渠道下载
不要使用第三方「绿色版」「破解版」或来源不明的离线包。安装包与账号都应来自官方。
三、macOS 桌面 App
| 芯片 | 下载 |
|---|---|
| Apple Silicon（M1/M2/M3/M4） | 官方 Codex.dmg |
| Intel x64 | 官方 x64 DMG |
双击 DMG，把 Codex 拖进「应用程序」，按 macOS 安全提示允许启动，再登录并选择项目目录。
四、Linux
当前优先用 CLI 或 IDE 扩展；桌面 App 可到 官方登记页 订阅可用通知。
五、Codex CLI
需要 Node.js 与 npm（建议 Node 20 以上）。
bash
node -v npm install -g @openai/codex codex
| 操作 | 命令 |
|---|---|
| 安装 | npm install -g @openai/codex |
| 启动 | codex |
| 升级 | npm install -g @openai/codex@latest |
Windows 用户涉及 Linux 工具链或仓库时，优先在 WSL 工作区里运行。
六、IDE 扩展
VS Code、Cursor、Windsurf、VS Code Insiders 都能装。到 Codex 帮助中心 选对应编辑器安装，装完重启编辑器；侧边栏没出现图标多半是没重启。
七、Windows 装不上怎么办
| 顺序 | 做法 |
|---|---|
| 01 | 直接用 官方安装器，它依赖 App Installer / Store 服务 |
| 02 | 重置 winget 源后重装：winget source list → winget source reset --force → winget install Codex -s msstore |
| 03 | Store 服务不可用时，先用 Codex Web、CLI 或 IDE 扩展替代 |
八、装完之后
- 如何填写API：密钥、三个接入地址、Codex 的 config.toml、模型与分组对照。
- Codex++：用 Codex++ 面板把供应商接进来（图文步骤）。
- CCSwitch 配置：用 CC Switch 一键导入 / 多客户端切换。