本篇教程面向新手用户，手把手教您如何使用界面优雅、功能全面的开源 AI 桌面客户端 —— Cherry Studio 连接本站服务。

#第一步：创建 API 密钥

1. 登录本站控制台 api.20020723.xyz，点击左侧菜单的 「令牌」。
2. 点击右上角 「添加令牌」，填写令牌名称（例如 cherry-studio）。
3. 重要步骤：在「分组」下拉菜单中，选择您打算调用的模型所在的分组（如 OpenAI、Gemini、Claude 或全能分组等）。额度选 0 或不填表示不设独立限额。
4. 点击「提交」创建成功后，复制生成的密钥（格式通常为 sk-xxxxxxxx）。

#第二步：下载并安装 Cherry Studio

前往 Cherry Studio 官方网站下载适用于您操作系统的最新安装包（支持 Windows、macOS 与 Linux）：

• 官方下载地址：https://www.cherry-ai.com/download

#第三步：添加自定义服务商

1. 打开 Cherry Studio，点击左下角的 「设置」 图标（齿轮）。
2. 在左侧菜单点击 「模型服务」，向下拉动或点击 「添加」，选择 「自定义 (OpenAI 兼容)」。

1. 填写服务商配置信息：

• 服务商名称：自定义填写（例如 SuperFast）
• API 密钥：粘贴刚才在第一步复制的 sk-xxxxxxxx 密钥
• API 地址 (Base URL)：填写 https://api.20020723.xyz（如果客户端提示需要完整端点，可填 https://api.20020723.xyz/v1）
• 提供商类型 / 端点类型：选择 /v1/chat/completions（GPT 与 Codex 模型也可选用 OpenAI 兼容格式）

#第四步：拉取并勾选可用模型

1. 在服务商设置界面，点击 「获取模型列表」（或「测试连接」）。
2. 正常情况下，系统会自动拉取该密钥分组下所有授权模型。
3. 勾选您常用的模型（例如 gpt-6-astra、claude-opus-5、gemini-2.5-flash、deepseek-v4.1 等），点击保存。

#第五步：开始畅享多模型对话

返回 Cherry Studio 对话主界面，在顶部模型选择器中切换为您刚添加的 SuperFast 服务商和目标模型，即可开始极速流畅的 AI 对话与代码编写！

#常见排查

• 提示 401 错误：密钥复制有误，或两端带有空格，请重新复制粘贴。
• 提示 503 错误：模型与分组不匹配！例如密钥选了 OpenAI 分组，却尝试调用 Claude Opus 5。请在后台创建对应模型分组的密钥。
• 提示余额不足：请检查控制台账户余额是否充足。

CC-Switch（又名 CCS）是一个强大好用的 AI 配置文件一站式管理工具，完全开源免费，拥有庞大的用户基数，推荐配合本站模型使用（站长日常也在使用）。

#一、下载并安装 CC-Switch

请前往 CC-Switch 官方 Release 页面下载：

• 官方 GitHub Releases（务必选择安装包 .msi 或 .dmg，勿选便携压缩包，否则无法支持一键唤醒导入）：

https://github.com/farion1231/cc-switch/releases

• CC-Switch 官方网站：

https://ccswitch.io/zh/

• Windows 版下载直链备用：

CC-Switch-v3.15.0-Windows.msi

#二、从本站后台一键导入配置

1. 打开本站控制台 api.20020723.xyz，进入「令牌」页面。
2. 创建新密钥，选择与您想要使用的模型对应的分组（非常关键，如 Coding Plan 分组、OpenAI 分组或 Claude 分组）。
3. 在密钥列表中，点击「导入到 CCS」，浏览器会自动唤醒本地安装好的 CC-Switch 软件完成导入。

#三、调整与选择模型

在 CC-Switch 中配置模型时，认证字段请保持默认（不要改成单独的自定义 API 模式）：

#1. Claude Code 调整模型

示例：如果要在 Claude Code 里面调用对应模型，请确认在官网已创建该模型对应分组的密钥：

#2. Codex 调整模型

在模型输入框中填写您所需要的目标模型名（如 gpt-5.3-codex、gpt-6-astra 等）：

#四、启动与使用

1. 在 CC-Switch 界面右上角点击 「启动」 按钮。
2. 打开对应的开发环境：

• Codex 桌面版
• Codex CLI（在终端输入 codex 并回车）
• Claude Code（在终端输入 claude 并回车）
• VS Code / Cursor 内的 Codex 或 Claude Code 插件也会被自动配置生效。

#五、排查与最佳实践

1. 遇到 503 报错：99% 与密钥和分组有关！请核实：

• 当前使用的 API Key 是否属于该模型对应的分组。
• 密钥本身是否有效、账户是否有余额。

1. 推理强度建议：

• 推理强度建议选择 medium 或 high。不要随意选用 xhigh，部分客户端对超长思考链支持不稳定容易引发超时报错。

1. Codex 关闭远程压缩建议：

• 使用 Codex 时建议在设置中取消勾选「远程压缩」选项，可有效避免官方近期关于压缩流解析的已知 Bug。

本教程汇总了当前前沿代码智能体（Agent）客户端的安装方法。无论您是习惯终端命令行的极客，还是喜欢图形化交互的开发者，都能在此找到最佳方案：

• 习惯终端命令行：推荐 Codex CLI 或 Claude Code。
• 习惯桌面窗口：推荐 Codex 桌面版（Windows / macOS）。

#一、Claude Code 终端版安装

Claude Code 是 Anthropic 官方推出的强大终端自主编程智能体。

#1. 安装 Node.js 环境

Claude Code 依赖 Node.js 运行环境：

• 前往官网下载 Node.js（建议 LTS 长期支持版）：https://nodejs.org/zh-cn/download
• 安装过程建议保持默认路径，一步步点击下一步直至完成。

#2. 全局安装 Claude Code

按快捷键 Win + R 输入 cmd 打开终端（macOS 用户打开 Terminal），输入以下命令并回车：

npm install -g @anthropic-ai/claude-code

#3. 配置与启动

安装完成后，您可以使用 CC-Switch 教程 一键配置本站 Claude 模型与密钥。配置完成后，在任意项目目录下输入：

claude

即可立即唤醒 Claude Code 自主编程助手！

#二、Codex 桌面版安装

#方案 A：微软应用商店直装（简单快捷）

• 在 Windows「Microsoft Store」中搜索 Codex 并点击安装。
• 或者访问官网（需网络通畅）：https://openai.com/codex/

#方案 B：离线安装包（99% 成功率，绕过微软商店网络卡顿）

如果微软商店提示下载失败或网络超时，可采用离线安装：

1. 打开应用链接解析网站：https://store.rg-adguard.net/
2. 在左侧下拉菜单选择 ProductId。
3. 在搜索框输入 Codex 产品 ID：9PLM9XGG6VKS
4. 右侧下拉菜单保持默认（RP），点击右侧的 ✓ 按钮。
5. 在刷新出的列表中找到带 OpenAI.Codex、后缀为 .Msix 且架构为 x64 的最新文件（例如 OpenAI.Codex_26.623.8305.0_x64__2p2nqsd0c76g0.Msix），点击下载。
6. 或者通过夸克网盘备用直链下载：

• 链接：https://pan.quark.cn/s/35af5df1aad6（提取口令：~99603ZIKdE~:/）

1. 一键执行安装：在下载好的 .Msix 安装包所在目录，按住 Shift 右键点击空白处打开 PowerShell，运行以下命令（将引号内替换为您实际下载的文件名）：

Add-AppxPackage -Path ".\OpenAI.Codex_26.623.8305.0_x64__2p2nqsd0c76g0.Msix"

#三、Codex CLI（终端版）安装

Codex CLI 具备轻量、快速、无冗余界面的优势，极适合深度编程开发。

1. 确保电脑已安装 Node.js（见上文第一步）。
2. 在终端（cmd / PowerShell / Terminal）中输入命令：

npm install -g @openai/codex

1. 安装完成后，在终端项目路径下输入：

codex

即可直接调起交互式 Codex 编程界面。

#四、实操体验与效率

搭配本站 SuperFast API 高并发网关与专属 200 元包月 3000 刀 Coding Plan，实测大型功能模块快速生成，速度迅捷丝滑，35 分钟即可高质量交付一个中型完整工程模块：

OpenClaw（小龙虾）是新一代开源自主智能体（Autonomous Agent）系统，能够自动进行任务拆解、文件读写、指令执行与多 Agent 协同。本教程提供接入本站 API 的标准手动配置方案。

#一、系统与环境要求

• Node.js：版本必须大于等于 22（推荐安装最新的 Node.js 22+ LTS）
• 支持系统：macOS、Linux，以及 Windows（需通过 WSL2 环境运行）
• 包管理器：推荐使用 Node.js 自带的 npm，或使用 pnpm。

#二、安装 OpenClaw

参考 OpenClaw 官方指南完成基础脚手架安装：

• 官方文档：https://docs.openclaw.ai/zh-CN/install

npm install -g openclaw

安装过程中如果提示配置模型，可以直接跳过或回车，安装完成后直接编辑配置文件即可。

#三、配置本站模型

打开用户主目录下的配置文件 ~/.openclaw/openclaw.json（Windows WSL2 下位于 ~/.openclaw/openclaw.json）：

在 models 与 agents 节点下按以下模板配置。将 你的密钥sk-xxxx 替换为您在本站后台创建的密钥（需绑定对应模型分组）：

{
  "models": {
    "providers": {
      "superfast": {
        "baseUrl": "https://api.20020723.xyz/v1",
        "apiKey": "你的密钥sk-xxxx",
        "auth": "api-key",
        "api": "openai-responses",
        "authHeader": true,
        "models": [
          {
            "id": "gpt-5.3-codex",
            "name": "GPT-5.3 Codex",
            "reasoning": true,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 1.75,
              "output": 14,
              "cacheRead": 0.175,
              "cacheWrite": 0.175
            },
            "contextWindow": 400000,
            "maxTokens": 128000
          }
        ],
        "headers": {
          "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) OpenClaw/2026.2.14",
          "Accept": "application/json"
        }
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "superfast/gpt-5.3-codex"
      },
      "models": {
        "superfast/gpt-5.3-codex": {
          "alias": "GPT 5.3 Codex"
        }
      },
      "workspace": "/root/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

#四、调整推理思考强度（Thinking Level）

若需要调节智能体的思考深度，可在 agents.defaults 中加入 thinkingDefault 选项（建议设置为 "high"）：

"agents": {
  "defaults": {
    "workspace": "/root/.openclaw/workspace",
    "compaction": { "mode": "safeguard" },
    "maxConcurrent": 4,
    "subagents": { "maxConcurrent": 8 },
    "thinkingDefault": "high",
    "model": { "primary": "superfast/gpt-5.3-codex" }
  }
}

修改完成后，在终端重启 OpenClaw 主进程或网关即可完全生效：

openclaw gateway restart

Hermes 是轻量级命令行 AI 交互工具。按照以下三步即可极速配置本站 API 端点与模型：

#第一步：设置 API 端点（Base URL）

在终端中输入以下命令：

hermes config set providers.superfast.base_url https://api.20020723.xyz/v1

#第二步：设置 API Key

登录主站控制台 api.20020723.xyz，在「令牌」页面创建对应分组的密钥，并将下述命令中的 your-api-key-here 替换为您复制的实际密钥：

hermes config set providers.superfast.api_key your-api-key-here

#第三步：选择并启用模型

在终端输入：

hermes model

在交互式列表中选择您需要调用的模型（例如 gpt-6-astra、claude-opus-5、deepseek-v4.1-flash 等），即可畅享高速对话与开发辅助！

SuperFast 官方提供开箱即用的专业 Web 绘图工作台，出图快速、画质清晰，支持自由调节图片画幅比例，同时支持文生图与图生图（参考改图）：

• 官方在线生图站点：https://image.20020723.xyz/

#一、核心功能特性

#1. 历史画廊与快速复用

生图站点支持完整的生成历史记录查看、全屏高清预览、提示词一键复制与本地下载：

#2. 灵感提示词广场

内置丰富的优秀绘画风格与中英文提示词预设，助您快速激发创作灵感，一键填入应用：

#二、使用步骤

1. 凭据与登录准备：

• 方式 A（推荐）：点击右上角直接登录您的 Sub2API 账号，系统将自动识别并绑定已授权的图像生成分组，无需手动复制 Key。
• 方式 B（密钥模式）：进入官网控制台 api.20020723.xyz，创建图像生成分组的 API 密钥，并在绘图站右上角「接入密钥」粘贴该 Key。

1. 选择参数与模型：

• 选择您喜爱的模型引擎（如 gpt-image-2.5-flare、z-image-turbo、grok-imagine 等）。
• 设定画幅比例：1:1（方形头图）、16:9（壁纸宽屏）、9:16（手机壁纸/短视频）、4:3、3:4 等。

1. 输入提示词或上传底图：

• 文生图：输入画面主体、光影质感、色彩风格的描述词。
• 图生图：上传本地参考图片，输入修改指令（如“将背景改为雪山”、“增加赛博朋克霓虹灯光”）。

1. 一键出图：点击「生成」按钮，稍候片刻即可获得超高清 4K 原图。

#三、生成效果示例

示例 1：最终幻想爱丽丝

示例 2：宇航员 1:1 图片参考改图，生成 4:3 画幅宽屏视觉

#四、常见问题与出图技巧

1. 确认密钥与分组归属：

• 请务必确认使用的密钥属于图像生成或包含绘图权限的分组，且账户余额充足。

1. 生成耗时与网络状态：

• 4K 超高清大模型绘图需要云端 GPU 神经渲染，耗时通常在 20~60 秒之间属于正常现象，请保持网络连接通畅不丢包。

1. 图生图底图体积控制：

• 参考底图建议控制在 1~3 MB 之间，图片过大（如超过 10MB）会增加上传耗时与显存开销，适度压缩后出图更快更稳。

1. 利用大模型优化提示词（独家秘籍）：

• 复杂的画面如果词汇过于繁杂生硬，容易引发上游过滤报错（40x/50x）。
• 强烈建议：在绘图前先在主站与 Gemini 2.5 Flash 或 GPT-6 聊一聊，让 AI 帮您润色成专业的中英文艺术提示词（包含镜头视角、色调配比、光影细节），然后再粘贴到生图站，出图质量提升立竿见影！

🎨 更多风格词请查阅配套教程：常见艺术风格参考以及对应提示词

在 AI 绘图创作中，精准的风格提示词是决定成片质感的灵魂。本表整理了 50 种广受欢迎的经典艺术风格与对应英文关键词，可直接复制搭配到 SuperFast AI 绘图工坊 中使用。

#一、画风视觉参考

#二、50 种经典风格与提示词对照表

本教程面向在手机移动端（安卓 / iOS） 有日常对话、问答、创作与咨询需求的用户。

#一、手机端推荐客户端与方案

#1. 方案一：安卓用户专属 SuperFast AI 官方原生 App

• 特点：官方出品，免去复杂的 Base URL 配置。
• 功能：直接集成单文件 Web 对话工作台、绘图工坊快捷入口与在线热更新能力。
• 获取方式：可直接在官网下载官方 Android APK（如 SuperFast-v1.1.5-release.apk）进行安装体验。

#2. 方案二：安卓端推荐 RikkaHub（功能强大）

• 优势：被誉为手机端的 Cherry Studio，界面精致、功能全面，支持自定义 OpenAI 兼容接口。
• 下载地址：https://rikka-ai.com/download
• 配置方法：

1. 在软件设置中添加自定义提供商。
2. API 地址填写：https://api.20020723.xyz/v1
3. 密钥填写您在本站后台创建的 sk-xxxx 密钥即可。

#3. 方案三：iOS 苹果端推荐 Kelivo（多端互通）

• 优势：支持跨平台同步（iOS、macOS、Android、Windows、Linux），上架 App Store，安装极为方便。
• 下载地址：https://apps.apple.com/cn/app/kelivo/id6752122930
• 配置方法：

1. 打开 Kelivo 设置 $\to$ 模型服务提供商 $\to$ 自定义提供商。
2. API Base URL 填写 https://api.20020723.xyz/v1。
3. 粘贴您的本站 API 密钥保存即可。

#4. 方案四：电脑端极力推荐 Cherry Studio

• 电脑端无论 Windows、macOS 还是 Linux，体验最佳的轻量通用对话客户端非 Cherry Studio 莫属。
• 下载地址：https://www.cherry-ai.com/download
• 详细图文步骤：请参考配套教程 如何在 Cherry Studio 中配置文本与代码模型。

在使用 API 中转或各大 AI 客户端调用模型时，绝大部分常见报错都与密钥分组、API 地址格式或额度状态相关。请参考本手册快速自查：

#一、排查核心三要素：银行卡与币种比喻

#二、高频报错与精准解决

#1. 503 报错（最常见，99% 与分组和 Key 有关）

• 原因：
• 分组选错：例如要在客户端使用 claude-opus-5，密钥却是在 OpenAI 默认分组创建的；或者使用了仅支持文本的分组去调用绘图模型。
• 购买了订阅分组，但调用的 Key 未绑定该订阅分组：充值 Coding Plan 或月付套餐后，必须新建一个属于该套餐分组的密钥！
• 解决方法：
• 登录控制台 api.20020723.xyz，进入「令牌」页面。
• 重新创建一个密钥，分组选择与目标模型匹配的分组。
• 如果不清楚目标模型属于哪个分组，请在官网左侧「模型广场 / 可用渠道」中查看模型对应的分组名。

#2. API 地址（Base URL）报错或网络连不上

• 标准地址：

```text

https://api.20020723.xyz

```

如果某些客户端（如 Cherry Studio、NextChat）要求带有版本端点，请填写：

```text

https://api.20020723.xyz/v1

```

• 注意细节：
• 结尾不要带多余的斜杠 /。
• 手动配置时若遇到 404，建议在上述两种形式间切换尝试。

#3. 401 Unauthorized（未授权 / 密钥无效）

• 原因：
• 复制 Key 时前后多复制了空格或换行符。
• 账户额度已透支为负数。
• 解决方法：
• 重新完整复制 sk-xxxx 密钥，粘贴时确认无首尾空格。
• 登录控制台核对账户余额，及时充值。

#4. 模型 ID 填写错误

• 解决：请不要凭空手打模型名字。前往官网首页或「模型广场」，直接一键复制标准模型 ID（例如 gpt-6-astra、claude-opus-5、deepseek-v4.1-flash）。

#5. 推理思考强度导致客户端超时或报错

• 建议：推理强度建议选择 medium、low 或 high，尽量不要选择 xhigh。部分第三方客户端处理超长思考链时极易触发客户端主动超时断连。

#6. 辅助工具与插件推荐

• Codex 插件增强：可参考社区开源增强插件：https://github.com/b-nnett/codex-plusplus
• CC-Switch 切换 Key 后同步历史记录：可使用同步工具：https://github.com/Dailin521/codex-provider-sync

#三、联系官方人工客服

如果您按照上述步骤排查后仍未解决，欢迎随时联系平台技术客服：

• 客服 QQ：2796802957
• 服务时间：工作日 9:10 - 18:00（其余时间留言看到会尽快响应）
• 求助提示：联系客服时，请务必附带：1. 您的请求报错码（如 503/401/404）截图；2. 您调用的模型名称；3. 客户端名称，以便技术团队秒级为您定位修复！