Alien API 配置教程

Alien API 配置完整指南

获取专属 API 密钥,并通过 CC Switch 快速完成 ChatGPT 与 Claude 桌面端配置。

  • 3 个主要步骤
  • 约 10 分钟完成
  • 支持 Windows / macOS
开始配置

CONFIGURATION FLOW

配置流程概览

按照顺序完成下面三步,即可开始使用。

BEFORE YOU START

开始前的准备

下面这个地址会在登录平台和配置应用时多次用到。

Alien API 平台地址 https://api.panlai.me

请完整复制,地址末尾不要添加斜杠。

01

STEP ONE

获取 API 密钥

在 Alien API 后台创建一个用于桌面端的专属密钥。

1

访问 Alien API 平台

打开浏览器访问 https://api.panlai.me,使用你的账号登录。如果还没有账号,请先完成注册。

2

新建 API 密钥

  1. 在左侧找到 API 密钥 菜单。
  2. 点击 创建秘钥。
  3. 设置容易识别的名称,例如“我的 ChatGPT”或“Claude 桌面端”,并选择 对应分组。 分组建议:Claude 用户优先选择 轻量分组,重度开发用户请直接选择 Max分组。
  4. 点击 确认创建 或 生成。
3

复制并妥善保存

复制整个密钥,通常以 sk- 开头,并保存到安全的位置。密钥也可以随时在 Alien API 平台中重新查看。

完成这一步后,你需要保留两项信息

API 地址:https://api.panlai.me
API 密钥:你刚刚创建并保存的完整密钥。

02

STEP TWO

安装 CC Switch

通过配置工具自动写入 API 信息,无需手动编辑配置文件。

下载官方版本

根据你的操作系统选择 Windows 或 macOS 版本。

前往 CC Switch 官网
  1. 下载 Windows 版本并双击 .exe 安装文件。
  2. 如果出现安全提示,点击 更多信息 → 仍要运行。
  3. 按照安装向导完成安装,然后启动 CC Switch。
03

GPT / CODEX SETUP

GPT(Codex)接入

以下步骤用于在 ChatGPT 桌面端 中配置 Codex。Claude 用户请查看下一节。

1

从密钥列表发起导入

在 Alien API 后台找到准备给 GPT 使用的 API 密钥,在该密钥所在行点击 导入到 CCS。确认选中的是你刚创建的密钥。

Alien API 密钥列表右侧操作栏,突出显示导入到 CCS 按钮
点击该密钥所在行的 导入到 CCS。
2

允许浏览器打开 CC Switch

浏览器弹出 要打开 CC Switch 吗? 时,确认提示来自 Alien API 页面(https://api.panlai.me),再点击 打开 CC Switch。

浏览器询问是否打开 CC Switch,点击打开 CC Switch
确认正在从 api.panlai.me 打开 CC Switch,然后点击 打开 CC Switch。
3

核对配置后确认导入

在 CC Switch 的 确认导入供应商配置 窗口中,先核对 应用类型:Codex、供应商名称:Alien API,并确认 API 地址、掩码显示的 API 密钥 和模型信息符合预期。确认无误后点击右下角 导入。

密钥安全

确认窗口会隐藏密钥的大部分字符。不要把完整 API 密钥 截图或发送给他人。

确认导入 Codex 的 Alien API 配置并点击导入
核对 应用类型 为 Codex 后,点击 导入。
4

选择 Codex 并启用 Alien API

回到 CC Switch 主界面,点击顶部的 Codex 图标,再找到刚导入的 Alien API 配置。若按钮显示 启用,点击 启用;显示 使用中 则表示配置已经生效。

在 CC Switch 中选择 Codex 并确认 Alien API 配置显示使用中
选中 Codex 图标,并确认 Alien API 配置显示 使用中。
5

重启 ChatGPT 桌面端并测试

完全退出 ChatGPT 桌面端 后重新打开,在 Codex 中发送一条测试消息。能正常收到回复,就表示 GPT 接入完成。

GPT 接入完成

如果没有正常返回结果,请先确认 CC Switch 的 Codex 配置显示 使用中,再检查密钥和 API 地址 是否正确。

04

CLAUDE SETUP

Claude 接入

先按与 GPT(Codex) 相同的方式从密钥列表导入,再根据你使用的是 Claude Code 还是 Claude Desktop 完成对应设置。

1

从密钥列表发起导入

在 Alien API 后台找到你准备给 Claude 使用的 API 密钥,在对应行点击 导入到 CCS。请确认选择的是 Claude 用的密钥;截图仅作按钮位置示意。

在 Alien API 的 Claude 密钥列表中点击导入到 CCS
找到 Claude 使用的密钥,再点击同一行的 导入到 CCS。
2

允许浏览器打开 CC Switch

浏览器弹出 要打开 CC Switch 吗? 时,确认来源是 Alien API 页面(https://api.panlai.me),再点击 打开 CC Switch。

浏览器询问是否打开 CC Switch,点击打开 CC Switch
确认从 api.panlai.me 打开 CC Switch,然后点击 打开 CC Switch。
3

核对并确认导入

在 CC Switch 的 确认导入供应商配置 窗口中,核对 供应商名称:Alien API、API 地址 和掩码显示的 API 密钥。确认 应用类型:Claude 与目标 Claude 客户端相符后,点击右下角 导入。Claude Code 用户选 Claude Code;Claude Desktop 用户则继续完成下面的 Desktop 专属设置。

注意

确认窗口可能包含密钥信息,分享截图前请遮住密钥。不要把完整 API 密钥 发送给他人。

核对 Claude 的 Alien API 供应商配置并点击导入
确认 应用类型:Claude,并检查 供应商名称、API 地址 和 API 密钥 后,点击 导入。密钥在截图中已遮蔽。
4

Claude Code:选择并启用配置

如果使用 Claude Code,在 CC Switch 顶部选择第一个 Claude 图标,找到刚导入的 Alien API 配置并点击 启用。显示 使用中 后,完全退出并重新打开 Claude Code,发送一条测试消息确认配置生效。

在 CC Switch 中选择 Claude Code 并确认 Alien API 配置显示使用中
选择顶部第一个 Claude 图标,确认 Alien API 配置显示 使用中。
5

Claude Desktop 额外设置

仅限 Claude Desktop 用户操作

如果你使用的是 Claude Code,请跳过本步骤。下面的额外设置只适用于 Claude Desktop。

步骤 1:选择第二个 Claude 图标,删除默认的 Claude Desktop Official 配置。
步骤 2:点击蓝色的 将 Claude Code 中已有的供应商导入 按钮。
在 CC Switch 中删除默认的 Claude Desktop Official 配置
第 1 步:选择第二个 Claude 图标,删除默认的 Claude Desktop Official 配置。
在 CC Switch 中从 Claude Code 导入已有供应商
第 2 步:点击 将 Claude Code 中已有的供应商导入。
6

Claude Desktop:启用并验证

完成上一步额外设置后,选中 Alien API 配置并点击 启用。页面显示 使用中 后,完全退出并重新打开 Claude Desktop,发送一条测试消息确认配置生效。

Claude 接入完成

Claude Code 和 Claude Desktop 的配置入口不同,请按你实际使用的客户端完成对应步骤,并分别重启测试。

05

TROUBLESHOOTING

常见问题

常见问题与对应处理方法如下。

应用可以连接,但速度很慢?
  • 检查本地网络状况,或尝试切换网络。
  • 如有美国节点,可优先使用。
  • 高峰时段可能出现短暂延迟;如持续缓慢,请联系客服检查服务状态。
密钥创建后忘记保存怎么办?

登录 Alien API 后台,在“API 密钥”菜单中找到对应密钥,点击查看或复制即可重新获取。

CC Switch 提示“未找到应用”?

可能原因:

  • ChatGPT 或 Claude 桌面端尚未安装。
  • 应用安装在非默认位置。
  • 桌面应用仍在运行,需要先完全关闭。

确认安装路径并完全退出对应应用后,再重新使用 CC Switch。如问题持续,请联系技术支持。

配置后提示“API 密钥无效”?
  • 确认密钥完整复制,没有多余空格或换行。
  • 确认 API 地址为 https://api.panlai.me,末尾没有斜杠。
  • 确认密钥没有过期,并在 Alien API 平台检查密钥状态。
06

GOOD PRACTICES

使用建议

做好密钥管理,可以减少大多数后续问题。

TIP 01

定期检查密钥

登录 Alien API 平台检查密钥状态、使用额度和剩余配额。

TIP 02

按设备创建密钥

同一密钥可以多设备使用,但为不同设备创建独立密钥会更便于管理。

TIP 03

避免泄露密钥

不要分享或公开展示密钥。发现泄露后,应立即删除并创建新密钥。

TIP 04

遇到问题先自查

优先检查地址、密钥和应用状态,再尝试重启或重新导入配置。

TIP 05

保持应用更新

及时更新 ChatGPT、Claude 和 CC Switch,新版本通常具有更好的兼容性与稳定性。

07

TECHNICAL SUPPORT

获取帮助

按照本指南仍无法解决时,请联系技术支持。

联系我们

为便于快速定位问题,请在咨询时一并提供下方列出的环境信息。

QQ 群 276808077
微信 fod1619

咨询时请提供

  1. 使用的应用名称与版本。
  2. 操作系统类型与版本。
  3. 具体错误提示,最好附带截图。
  4. 已经尝试过的解决方法。
  5. Alien API 账户信息,用于查询密钥状态。
已复制到剪贴板