Aida Labs
v0.1.133

从下载安装到 Codex 回复 OK，才算结束

Aida Labs初次上手指南

这篇按真实新手路径写：先下载 Codex、Chrome、CC Switch，再注册 Aida Labs，完成邮箱验证，创建 codex 分组密钥，配置到 CC Switch，最后打开 Codex 发出测试消息。每一步都看截图里的箭头。

只认三个字段 Base URL、API Key、模型名。少一个，Codex 就不会稳定工作。
先跑最小请求 不要一开始就传文件、开联网、跑长任务。先让 Codex 回复 OK。
密钥不要出镜 教程截图只展示位置。真实 API Key 不能发群、不能贴网页、不能提交到仓库。

0. 开始前准备

你最后要确认这五件事。没有拿到密钥前，不要急着配置 Codex。

1Codex App 已安装。
2Chrome 已安装，用来下载和注册。
3CC Switch 已安装，用来配置 Codex Provider。
4Aida Labs 账号已完成邮箱验证。
5Aida Labs 账号里有 codex 分组 API Key。
成功标准：Codex 能通过 Aida Labs 回复 OK。看到回复之前，都还不算跑通。

1. 下载 Codex App

打开 openai.com/codex，下载桌面版 Codex App。不要从第三方网盘下载。

Codex App 下载页面，箭头指向下载入口
按箭头打开 Codex 官方页面，下载安装桌面 App。安装完成后先放着，后面配置完 CC Switch 再回来打开。

2. 下载 Chrome

打开 Google Chrome 官网，点击 Download Chrome。后面的 GitHub、注册页面、控制台都建议用 Chrome 操作。

Chrome 下载页面，箭头指向 Download Chrome 按钮
如果电脑已经有 Chrome，这一步可以跳过，但不要用第三方下载站的安装包。

3. 下载 CC Switch

用 Chrome 打开 CC Switch Releases。选择最新版本，下载适合你系统的安装包。

CC Switch GitHub Releases 页面，箭头指向最新版本
macOS 下载后拖进 Applications；Windows 下载后按安装向导走。版本号不用背，永远看 Releases 最新版。

4. 打开 Aida Labs 注册入口

访问 api.lsidestudio.com/home。新用户点“立即注册”；已有账号点“已有账户 · 登录”。

Aida Labs 首页，箭头指向立即注册按钮
这一步只是进入网站。不要复制右侧示例里的占位 key；真正的 API Key 要登录后在控制台生成。

5. 注册账号

按页面要求填写邮箱和密码，然后点“继续”。这里不需要任何 Codex 配置。

Aida Labs 注册表单真实截图，箭头指向邮箱、密码和继续按钮
注册用的邮箱要能收信。密码自己保存好，不要发给任何人。

6. 验证邮箱

Aida Labs 会把 6 位验证码发到注册邮箱。回到注册页填写验证码，然后点击“验证并创建账户”。

Aida Labs 邮箱验证页面真实截图，验证码已打码，箭头指向验证按钮
验证码截图里已打码。教程里永远不要展示真实验证码、密码或登录态。

7. 进入控制台，打开 API 密钥

注册成功后会进入 Aida Labs 控制台。左侧找到“API 密钥”。这就是后面配置 Codex 的关键页面。

Aida Labs 控制台真实截图，箭头指向 API 密钥菜单
如果你看不到“API 密钥”，先确认是否已经登录成功，或者账号是否完成邮箱验证。

8. 点击创建密钥

在“API 密钥”页面点击“创建密钥”。页面上方的默认 API 端点就是后面要填到 CC Switch 的 Base URL。

API 密钥页面真实截图，箭头指向创建密钥按钮，敏感信息已打码
这是用户侧 API 密钥页，不是管理员后台。右上角账户信息已打码。

9. 填名称并选择 codex 分组

名称建议写 codex 或 codex-test。分组必须选择 codex；不选分组会提示“请选择分组”。然后点击“创建”。

创建密钥弹窗真实截图，箭头指向分组和创建按钮
只开必要项。第一次上手不要先设置自定义密钥、IP 限制、额度限制、速率限制或有效期。

10. 复制 Base URL 和 API Key

创建成功后，复制默认 API 端点 https://api.lsidestudio.com/v1，再复制刚创建的 API Key。截图里的 key 已打码。

API 密钥创建成功页面真实截图，箭头指向默认 API 端点、密钥复制位置和使用密钥按钮
Base URL 用默认的 /v1。API Key 只粘贴到 CC Switch，别存到公开笔记里。
关键：不要把 sk-... 粘到网页教程、微信群、截图、GitHub、AGENTS.md 或公开文档里。

11. 打开 CC Switch，切到 Codex

启动 CC Switch。顶部选择 Codex，然后点击右上角 + 新建 Provider。

CC Switch 主界面，箭头指向 Codex 标签和右上角加号
不要改 OpenAI Official。新建一个 Aida Labs Provider，出错时更容易回退。

12. 选择自定义配置

进入“添加新供应商”后，保持 Codex 供应商，点击“自定义配置”。

CC Switch 添加供应商页面，箭头指向自定义配置
不要随便选预设供应商。Aida Labs 这里按自定义 OpenAI 兼容接口配置。

13. 填入 Aida Labs 地址和密钥

供应商名称填 Aida Labs。Base URL 填 https://api.lsidestudio.com/v1。API Key 填你刚复制的 sk-...。

CC Switch 自定义配置表单示意截图，箭头指向 Base URL、API Key 和保存按钮
保存前检查两件事：Base URL 末尾有 /v1；API Key 前后没有空格。

14. 启用 Provider，然后重启 Codex

保存后回到列表，确认 Aida Labs Provider 已启用。然后完全退出 Codex App，再重新打开。

CC Switch Provider 启用示意截图，箭头指向启用按钮
Codex 已经开着时，可能还在用旧配置。重启是为了让新 Provider 生效。

15. 打开 Codex，发第一条测试消息

打开 Codex App，新建对话。第一条消息只发：只回复 OK，不要解释。

Codex 新建对话示意截图，箭头指向新对话和输入框
不要第一条就让它改文件、读项目或联网。先证明中转站能完成最小文本请求。

16. 看到 OK，流程结束

如果 Codex 回复 OK，说明 Codex App、CC Switch、Aida Labs Base URL、API Key、模型路由这条链路已经通了。

Codex 回复 OK 的示意截图，箭头指向 OK 回复
看到 OK 才算完成。后面再测试项目文件、图片、联网、长上下文或更复杂任务。

17. 如果没有回复 OK

现象 优先检查 处理动作
401 / Unauthorized API Key 重新复制 key，确认没有空格、换行、旧 key。
403 / Forbidden 账号权限或余额 检查账号状态、额度、分组权限。
404 / model not found 模型名或 Base URL 确认 Base URL 是 https://api.lsidestudio.com/v1，模型名用服务方给你的默认值。
Codex 还是走旧配置 Provider 是否启用 回到 CC Switch，确认 Aida Labs 已启用，然后重启 Codex。

参考入口

只使用官方或项目主页，不使用第三方下载站： Codex、 Chrome、 CC Switch Releases、 Aida Labs。