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。点进最新 Release 后翻到页面最下面的 Assets 区。Windows 下载 .msi 后缀，macOS 下载 .dmg 后缀；不要点 Source code，也不要下载 .sig 校验文件。

CC Switch GitHub Release Assets 区，红框标出 macOS 的 dmg 文件和 Windows 的 msi 文件
红框里的两个文件才是新手优先下载项：Mac 点 CC-Switch-v3.16.0-macOS.dmg，Windows 点 CC-Switch-v3.16.0-Windows.msi。版本号会变，后缀规则不变。

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. 优先一键导入 CC Switch

创建成功后，先点击这一行右侧的 导入到 CCS。这是最短路径：它会把 Base URL 和 API Key 自动带到 CC Switch，少一次手动复制。

API 密钥创建成功页面真实截图，箭头指向默认 API 端点、密钥复制位置和导入到 CCS 按钮
默认 API 端点是 https://api.lsidestudio.com/v1。一键导入能成功，就不要再手动复制 key。
关键：不要把 sk-... 粘到网页教程、微信群、截图、GitHub、AGENTS.md 或公开文档里。

11. 打开 CC Switch 确认导入结果

如果一键导入成功，打开 CC Switch，顶部切到 Codex，列表里应该能看到 Aida Labs Provider。确认它已启用，然后直接重启 Codex。

CC Switch 浅色主界面，箭头指向 Aida Labs 的启用按钮
真实 CC Switch Provider 列表：看到 Aida Labs 后点“启用”。如果列表里已经有 Aida Labs，就不要点加号重复创建。

12. 备用：手动新建 Provider

只有“导入到 CCS”没有成功时，才手动操作：在 CC Switch 顶部选择 Codex，点击右上角 +，进入“添加新供应商”，再点击“自定义配置”。

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

13. 备用：手动填 URL 和密钥

供应商名称填 Aida Labs。API Key 填你在 Aida Labs 创建的 sk-...。API 请求地址填 https://api.lsidestudio.com/v1，最后点击右下角“添加”。

CC Switch 自定义配置真实表单，箭头指向 API Key、API 请求地址和添加按钮
真实 CC Switch 表单：只填 API Key 和 API 请求地址即可。保存前检查两件事：Base URL 末尾有 /v1；API Key 前后没有空格。

14. 启用 Provider，然后重启 Codex

保存后回到列表，确认 Aida Labs Provider 已启用。然后完全退出 Codex App，再重新打开。Windows 里只点窗口右上角关闭不够，Codex 可能还在后台托盘运行。

CC Switch Provider 列表真实截图，箭头指向启用按钮
真实 CC Switch Provider 列表：看到 Aida Labs 后点击“启用”。Codex 已经开着时，可能还在用旧配置，重启是为了让新 Provider 生效。
Windows 状态栏托盘展开后，红框标出 Codex 图标
Windows 用户要先展开右下角状态栏托盘，右键 Codex 图标，点击 Exit。这样才是完全退出，再重新打开 Codex。

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。