快速开始

0 前置环境1 登录 / 注册2 创建 API Key3 配置客户端4 完成验证

常见问题

0 前置环境1 登录 / 注册2 创建 API Key3 配置客户端4 完成验证

SULIAN API / QUICK START

从安装到可用，一次走完

这是一份首次使用指南。按顺序完成环境检测、创建 Key 和 CC Switch 配置，即可在 Claude Code 或 Codex 中开始使用。

只选择一个客户端配置，不需要同时安装 Claude Code 和 Codex。

0

前置环境检测

先安装 Node.js

Node.js 是 Claude Code 和 Codex 的运行环境。进入 Node.js 下载页，让网站自动识别系统后直接下载即可。

• Windows 下载 .msi 安装包。
• macOS 下载 .pkg 安装包。
• 安装过程保持默认选项，一直点击下一步即可。

Node.js 下载页面会自动匹配当前操作系统。

只安装你要使用的 CLI。 Claude Code 与 Codex 的安装命令会在第 3 步根据你的选择显示。

1

站点账号

登录或注册 Sulian API

打开 api.sulianapi.cc，使用已有账号登录；首次使用则先完成注册。

从控制台入口登录或注册账号。

2

访问凭证

创建并复制 API Key

1. 在控制台左侧进入 API 密钥。
2. 点击右上角 创建 API 密钥。
3. 填写一个容易识别的名称，并选择可用分组。
4. 创建后复制完整 Key，下一步需要填入 CC Switch。

01先进入 API 密钥页面，再点击创建按钮。

02根据要配置的客户端选择对应可用分组。

保护你的 API Key点击 Key 右侧的复制图标。不要把 Key 发到群聊、截图或公开仓库。

3

客户端配置

选择一个客户端，在当前页面完成配置

下面只提供 Claude Code 与 Codex 的 CC Switch 手动配置。切换选项不会离开当前页面。

安装 Codex

打开终端，运行以下命令安装。安装完成后先启动一次 CLI，让本机生成所需配置目录。

npm install -g @openai/codex@latest
codex

看到版本更新提示时： 保持选择 1. Update now，直接按 Enter，让当前安装更新到最新版本。

选择 1 更新 Codex；更新完成后重新运行 codex。

出现交互界面或首次选择提示，表示 Codex 已安装成功。

安装并打开 CC Switch

从 CC Switch Releases 下载对应系统的安装包。Windows 选择 .msi，macOS 选择 .zip。

macOS 提示“安装包已损坏”时： 进入“系统设置 → 隐私与安全性”，在底部选择“仍然允许打开”。

在 CC Switch 新增供应商

1. 打开 CC Switch，选择 Codex 分组。
2. 点击右侧 加号，新增供应商。
3. 选择 自定义配置。
4. 粘贴刚刚复制的 API Key，并填写下方请求地址。

Codex：选择对应分组后，点击加号新增供应商。

在预设供应商列表中选择“自定义配置”。

请求地址https://api.sulianapi.cc/v1

Codex 必须使用带 /v1 的地址，末尾不要再加斜杠。

创建 Key 时选择你账户可用的 GPT 分组。

粘贴 Key，填写请求地址；供应商名称可自定义，例如“Sulian Codex”。

启用配置

保存后启用刚创建的供应商配置，然后完全退出并重新打开 codex。

确认配置处于启用状态后，再重新启动 CLI。

4

完成验证

发起第一条请求

完全退出当前 CLI 后，重新打开终端并运行：

codex

1. 等待 CLI 进入交互界面。
2. 在底部的 > 后输入 hi，或输入“只回复：连接成功”。
3. 按 Enter 发送，看到模型回复就代表配置成功。

Codex 已收到模型回复，说明 API Key、请求地址和客户端配置均正常。

配置完成。 后续只需要在 CC Switch 中切换已启用的配置，不要手动混用多个本地配置文件。

连接失败、Key 无效、额度不足或模型不可用时，查看 常见问题。