桌面版的安装路线
安装桌面客户端 → 安装 CC Switch → 填写 EasyCode → 启用 → 打开桌面版测试。
桌面版使用应用窗口,不需要先安装 Node.js、npm 或 Codex CLI。CLI 命令行版有单独的 安装教程。
1. 下载并安装桌面客户端
Codex 桌面版官方下载
官方下载 ↗打开官方页面,选择适合自己系统的桌面版安装包。
- 打开官方下载页,按电脑系统选择支持的版本。
- Windows:打开安装程序,按提示完成。Mac:打开 .dmg,把应用拖进 Applications(应用程序)。其他系统按官方页面步骤安装。
- 安装完成后先完全退出客户端,接下来用 CC Switch 写入配置。
2. 下载并安装 CC Switch
CC Switch 官方下载
官方下载 ↗Windows 下载 .msi;Mac 下载 .dmg;Linux 按发行版选择。
安装后打开 CC Switch。它用于管理连接设置;聊天时打开的是桌面客户端。
3. 在 CC Switch 配置 EasyCode
先准备好 本站 API 密钥。在 CC Switch 左侧选择 Codex,顶部选择 直连(Direct),点击 + / 添加供应商,选择自定义配置:
| 字段 | 填写内容 |
|---|---|
| 名称 | EasyCode |
| Base URL / 请求地址 | https://easycodesi.com/v1 |
| API Key / 密钥 | 本站创建的完整密钥。 |
| 模型 | gpt-6.1-sol |
| 协议 / 上游格式 | 有选项时选择 Responses。 |
点击保存,回到列表后点击 EasyCode 卡片上的 启用。完整界面操作也可对照 CC Switch 配置教程。
做到这里应该看到
CC Switch 中的 EasyCode 已保存,并显示为当前启用的配置。
4. 重新打开桌面版,测试连接
- 完全退出正在运行的桌面客户端,再通过应用图标重新打开;Mac 使用 Command+Q 退出后重开。
- 进入 Codex,选择你准备使用的项目或文件夹,新建对话。
- 输入“请只回复:连接成功”,发送并等待回复。
- 打开 EasyCode 使用记录,按时间查找刚才的模型请求。
做到这里应该看到
桌面窗口收到回复,本站使用记录出现对应记录,接入完成。测试会产生模型用量。
以后怎么使用
直接点击客户端图标打开桌面版。更换密钥或模型时,在 CC Switch 编辑 EasyCode、保存并启用,然后完全退出桌面客户端并重新打开。
没有读取到 EasyCode 配置
检查 CC Switch 操作的是 Codex、EasyCode 卡片已启用,并且客户端已完全退出重开。确认两个应用运行在同一台电脑、同一个系统用户下。不要把本站密码填到官方账户登录框中。