EasyCode开始前：准备好账户和密钥
第一次接入推荐直接使用 CC Switch。它帮你管理配置，Codex 用来和 AI 对话。按下面顺序安装、填写并启用，无需手动创建配置文件。
还没有账户或密钥，先完成 注册与充值 和 创建 API 密钥，复制好自己的完整密钥，再回到本页。
1. 下载并安装 CC Switch
CC Switch 官方下载
官方下载 ↗打开发布页，找到 Assets（资源），选择自己的电脑系统。
| 你的电脑 | 下载哪个、怎么安装 |
|---|---|
| Windows | 普通 Intel / AMD 电脑选择 Windows 的 .msi 安装包；ARM 电脑选 arm64。双击安装，按提示完成。 |
| macOS | 选择 macOS 的 .dmg，打开后把 CC Switch 拖进 Applications（应用程序），再从应用程序打开。当前官方安装包兼容 Apple Silicon 和 Intel。 |
| Linux 桌面 | Ubuntu / Debian 选 .deb，Fedora 选 .rpm，双击并使用系统安装器安装；电脑系统需要满足下载页的要求。 |
不要选择 Source code。安装包名称看不懂时，对照 安装包选择表。
做到这里应该看到
电脑上已经能打开 CC Switch 主窗口。
2. 选择桌面版或 CLI，并完成安装
桌面版：按桌面教程下载安装客户端，安装完成后回到本页第 3 步。CLI：按 CLI 教程通过 npm 安装，确认可以运行后再回来配置。两条路线分别安装。
3. 新建 EasyCode 配置
- 在 CC Switch 左侧选择 Codex。
- 选择页面顶部的 直连（Direct）。
- 点击右上角 ＋ / 添加供应商（Add Provider）。
- 选择 自定义配置，按下面的表格填写。
| 界面里的字段 | 填写内容 |
|---|---|
| 名称 / Name | EasyCode |
| 请求地址 / Base URL | https://easycodesi.com/v1 |
| API Key / 密钥 | 粘贴你在本站“API 密钥”页面复制的完整密钥。 |
| 模型 / Model | gpt-6.1-sol |
| 协议 / 上游格式 | 有该选项时选择 OpenAI Responses 或 Responses。 |
模型字段在“高级选项”里时，展开后填写。其他项目先保留默认值。地址末尾只保留一个 /v1；密钥填自己的密钥，不填账户密码。
4. 保存，再点击“启用”
- 检查名称、请求地址、密钥和模型，点击“保存 / 添加”。
- 回到 Codex 的配置列表，找到 EasyCode 卡片。
- 点击卡片上的 启用（Enable）。
- 确认 EasyCode 显示为当前使用的配置。
做到这里应该看到
CC Switch 的 Codex 页面里，EasyCode 已保存并启用。只保存还不够，需要点击“启用”。
5. 按使用版本打开 Codex
桌面版
完全退出桌面客户端后重新打开，进入 Codex 并新建对话。通过应用图标启动即可，详细操作见 桌面版教程。
CLI 命令行版
重新打开终端；Windows 使用命令提示符（CMD），Mac / Linux 使用系统终端。输入：
codex在自己选择的版本中输入“请只回复：连接成功”。收到回复后，打开 EasyCode 使用记录，确认刚才的请求。测试会按本站规则计费。
做到这里应该看到
桌面版或 CLI 收到回复，本站日志出现对应记录。
6. 以后怎么使用
配置已经保存在电脑里。平时打开 Codex 即可；想改地址、密钥或模型时，到 CC Switch 编辑 EasyCode 卡片，保存并启用，再重新启动 Codex。
卡住了怎么检查
- CLI 提示找不到 codex：按 CLI 教程 检查 npm 安装。桌面版直接打开客户端图标。
- 保存后仍没有切换：确认 EasyCode 卡片已点击“启用”，然后重启 Codex。
- 提示密钥无效：重新复制本站完整密钥，修改 EasyCode 卡片的 API Key，保存并启用。
- 切换后仍使用旧配置：按 CC Switch 页面提示刷新或重启 Codex；重启前先结束正在执行的任务。
图形界面的操作依据：CC Switch 官方使用说明 ↗。