章节目录

注册·充值·建密钥
路线总览
认准接入地址
现在就能用的客户端
装 CC Switch
配 Claude Code
配 Codex
选模型
切回原配置
跑通并对账
报错自查

电脑端 · 编程工具接入

让终端里的 claude 和 codex
用云灵的额度干活

在云灵建一把 API Key：人民币充值、按量计费，用多少扣多少，随时切回你原有的配置。 Cherry Studio、Chatbox 等 OpenAI 兼容客户端现已可用； Claude Code 与 Codex 的原生端点现已开放，按下面的步骤配好，就能直接在终端里用云灵的额度。

Cherry Studio Chatbox Claude Code Codex Cline / Roo

现已可用理论兼容，尚未逐一验证

注册、充值、建一把限额密钥

已有账号、钱包有钱、手上有 yl_live_ 密钥的，直接跳到下一章。这三步在手机 App 里也能做，但后面的配置都在电脑上，建议直接用电脑网页版一次做完。

	要做什么	成功标志
A	注册云灵账号电脑浏览器打开 `app.yunshihub.com` 注册（App 里注册过的账号通用）	能登录进网页版
B	充一笔小额左侧「钱包」→「在线充值」。第一次先充小额（比如 ¥10–¥20）把流程试通，之后随用随充	钱包余额 > 0
C	建一把限额密钥左侧「API Key」页 → 「创建 API Key」。建议把「总限额（元）」填 20 起步（留空 = 不限额，密钥一旦泄漏可以花光钱包，别留空）；「高级设置」里的「每分钟请求数上限」默认 60，编程工具并发高，不够用随时回来调高	拿到一串 `yl_live_` 开头的密钥

密钥就是钱，别外泄密钥 = 你钱包的支付权限。不要贴进群聊、截图、公开仓库。怀疑泄露了就去「API Key」页轮换，旧的立刻作废——轮换后记得把各处配置里的旧密钥一起换掉。「API Key」页还能设日限额和 IP 白名单；注意 IP 白名单和境内加速线有个坑，见接入地址一章。

路线总览：照这个顺序走

每一步都写了「怎么算成功」。全页只有这一份路线，各步指到对应章节。

	要做什么	成功标志
①	准备账号与密钥（第 00 章）	拿到 `yl_live_` 密钥
②	认准接入地址（第 02 章）把你要用的那行地址复制到记事本，确认结尾带不带 `/v1`	记事本里有一行确认过结尾的地址
③	选接入方式并配置今天就要用 → 第 03 章的 OpenAI 兼容客户端；主用 Claude Code / Codex → 先装 CC Switch（第 04 章），配置方法见 05 / 06 章	对应章节的配置做完
④	跑一句最小测试（各章末尾都有）让它只回一句固定的话，别急着让它干活	看到模型按要求回复
⑤	回云灵对账（第 09 章）	用量明细里能看到本次调用的记录

能少手抄就少手抄：电脑网页版「API Key」页的表格里有「一键导入 CC Switch」一列现已可用，点行内的「导入」按钮，地址、密钥、模型一次带齐（这一列只在电脑浏览器里显示，手机 App 和手机浏览器没有）。不想用一键导入，也可以走 05 / 06 章的手写配置路径。

接入地址：不同协议填的不一样

这是最容易配错、也最难自己查出来的一处。地址错了的典型表现是 404 或「连不上」，而不是提示你地址写错了。

!照抄这两行，注意结尾

Anthropic 协议 · Claude Code 现已可用

https://yunling.yunshihub.com

结尾不带 /v1。Claude Code 自己会补上，你再写一遍就变成 /v1/v1，必然 404。

OpenAI 协议 · Cherry Studio / Chatbox 现已可用

https://yunling.yunshihub.com/v1

结尾要带 /v1，但不要再写 /chat/completions 或 /responses——那是客户端自己拼的。 Codex 也填这一行。

境内网络慢？把接入地址「整段」换成 https://cn.yunshihub.com:8443 （:8443 端口不能漏；带不带 /v1 照上表，例如 https://cn.yunshihub.com:8443/v1）。多数境内网络下这条更快，两个都可以试。两个注意：①部分公司网、校园网会拦 8443 这类非常规端口，连不上就换回主域名； ②境内线经过中转，服务端看到的来源 IP 是中转机的 IP—— 要用「IP 白名单」功能请走 yunling.yunshihub.com 直连地址，详见报错自查的 403 条。

现在就能用：Cherry Studio、Chatbox 等

现已可用

任何支持「自定义 OpenAI 兼容地址」的聊天或编程客户端都能接入。 Cherry Studio 和 Chatbox 走的这条通路，已用真实密钥实测跑通（2026-08-24：最小测试对话原样回复、流式正常、模型清单与计费接口正常）；其余客户端配法相同，尚未逐一验证。通用配法就三项，在客户端的「模型服务 / 自定义供应商」设置里填：

字段	填什么
API 地址 / 接口地址	https://yunling.yunshihub.com/v1境内可换 https://cn.yunshihub.com:8443/v1，规则见上一章
API Key / 密钥	yl_live_·········「API Key」页复制来的那串
模型	claude-sonnet-5照抄「API Key」页「可用模型」清单里的名字；选哪个见第 07 章

30 秒自证通路（后面排查也用它）终端里跑下面这条（选你的系统），能返回模型清单 JSON，就说明地址和密钥都对：

终端 · curl

curl https://yunling.yunshihub.com/v1/models \
  -H "Authorization: Bearer yl_live_你的密钥"

模型清单在哪看：「API Key」页会列出这把密钥能用的「可用模型」清单。个别型号可能临时维护中，遇到就换同档的另一个（见第 07 章）。

最小测试

在客户端里新建一个对话，发这句：

客户端对话框

如果你已经接到云灵，请只回复：云灵已连接

看到它原样回出「云灵已连接」就通了。不通就先跑上面那条 curl 自证做二分定位： 命令能通 = 客户端里字段填错了，逐项对照上表重填； 命令也不通 = 地址或密钥的问题，回第 02 章、第 00 章检查。

装 CC Switch

CC Switch 是开源的配置切换器，统一管理 Claude Code 和 Codex 的接入配置，在多个供应商之间一键来回切，不用每次手改配置文件。云灵密钥页支持一键导入，推荐先装好。

只从官方渠道下载 CC Switch 是第三方开源项目，请只从官网 ccswitch.io 或其 GitHub 仓库 github.com/farion1231/cc-switch 的 Releases 下载。

终端 · Homebrew

brew install --cask cc-switch

不用 Homebrew 的话，到 GitHub Releases 直接下 .dmg 安装包。

以上装法已按 CC Switch 官方文档核对（2026-08-24）。

装好的标志能打开 CC Switch、看到（空的）供应商列表，就装好了。 Windows 首次运行弹出 SmartScreen 拦截提示属常见情况——确认安装包是从上面的官方渠道下载的，点「更多信息 → 仍要运行」即可。

还没装 claude / codex 本体？ CC Switch 只管配置，不负责安装这两个命令行工具。装法在各自章节开头：05 章装 Claude Code、06 章装 Codex，各两分钟。

配 Claude Code

端点已开放

还没装 Claude Code？两分钟装好

终端 · 官方安装脚本（推荐，自动更新）

curl -fsSL https://claude.ai/install.sh | bash

也可以用 Homebrew（社区维护的装法）：brew install --cask claude-code；或已装 Node.js 22+ 的用 npm：npm install -g @anthropic-ai/claude-code。

确认装好了终端里跑 claude --version，打印出「版本号 (Claude Code)」就装好了。提示 command not found 先重开一个终端窗口再试——多数是新命令还没被当前窗口认识，不是装失败。
国内网络 npm 下载慢的话，可以换国内镜像源：npm config set registry https://registry.npmmirror.com （该镜像与官方源保持同步，分钟级延迟）。

两条配置路，二选一——别两条都做

两条路最终写的都是同一个文件 ~/.claude/settings.json，谁后写谁生效。两条都做过就说不清现在生效的是哪份——想确认，直接打开这个文件看 env 段的现状。手写过又想改走 CC Switch 的，先把手写的那几行删掉。

现已可用在电脑浏览器打开云灵「API Key」页，点行内「导入」即可；更想手动配置就用「手写 settings.json」标签页。

1	电脑浏览器打开云灵「API Key」页：`app.yunshihub.com/#/keys` 「一键导入 CC Switch」这一列只在电脑网页端显示，手机 App 和手机浏览器都没有	看到密钥表格里的「导入」按钮
2	找到要用的密钥，点行内「导入」。弹出的抽屉里「配到哪个工具」选 Claude Code，「默认模型」选一个（建议明确指定，选哪个见第 07 章），点「打开 CC Switch 并导入」	浏览器弹出「打开 CC Switch？」
3	允许打开，在 CC Switch 弹出的确认框里点「导入」	CC Switch 供应商列表里出现「云灵」
4	在 CC Switch 主界面把云灵这条切换为生效（按钮字样以你装的版本为准，不同版本措辞可能略有差异），然后重开终端	云灵这条带上「生效中」标记

一键导入不会漏配置导入会把端点地址、密钥、默认模型和后台小模型（claude-haiku-4-5）一次带齐—— 也就是手写路径里最容易漏的那一行，见「手写 settings.json」标签页的警告。
点了「导入」没任何反应？先手动启动一次 CC Switch（让系统注册它），回到网页再点导入。仍不行、或没有「导入」按钮，就在 CC Switch 里手动加：添加供应商时预设选「自定义」，把「手写 settings.json」标签页里代码块的 env 段原样贴进它的 JSON 编辑器即可，两边字段完全一样。

这个文件可能已经存在——只合并，别整个替换文件路径：macOS / Linux 是 ~/.claude/settings.json，Windows 是 %USERPROFILE%\.claude\settings.json。两个系统都一样：文件或 .claude 文件夹还不存在，就直接新建。
文件里已有内容的话，只把下面的 env 段合并进去，整文件替换会抹掉你已有的配置。改之前先备份：cp ~/.claude/settings.json ~/.claude/settings.json.bak—— 提示 No such file 属正常，说明你还没有这个文件，跳过备份直接新建即可。
打开方式：macOS 终端里跑 open -e ~/.claude/settings.json（或访达按 ⌘⇧G 输入 ~/.claude）；Windows 在 PowerShell 里跑 notepad $env:USERPROFILE\.claude\settings.json（提示文件不存在就点「是」新建）。

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yunling.yunshihub.com",
    "ANTHROPIC_AUTH_TOKEN": "yl_live_你的密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

变量	它是干什么的
ANTHROPIC_BASE_URL	接入地址，结尾不带 `/v1`。境内线把值整段换成 `https://cn.yunshihub.com:8443`（端口不能漏）
ANTHROPIC_AUTH_TOKEN	推荐用它：把密钥放进 Authorization: Bearer 头。用 `ANTHROPIC_API_KEY`（走 x-api-key 头）也兼容，两种都认——两个别同时填，留一个就好
ANTHROPIC_MODEL	主模型。建议明确指定：留空会用工具内置的默认模型名，那个名字不一定在云灵货架上。填哪个见第 07 章
ANTHROPIC_DEFAULT_HAIKU_MODEL	这行别漏。Claude Code 干活时会在后台反复调一个小模型（起标题、快速判断之类）。不指定成货架上的 `claude-haiku-4-5`，它会去要官方默认的小模型名，云灵货架上不一定有，可能导致后台功能异常
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	可选：减少与干活无关的后台请求（版本检查一类）。建议保留；删掉不影响主流程

这个文件里有明文密钥建议 chmod 600 ~/.claude/settings.json 收紧权限（Windows 可跳过这步：用户目录默认仅本人可访问）；确认 ~/.claude 没被纳入 git 仓库或云盘同步；密钥轮换后，这个文件（以及 CC Switch 里那条）要一起更新——这两条检查两个系统都适用。

第一次跑，先做最小测试

终端

claude -p "如果你已经接到云灵，请只回复：云灵已连接"

看到它原样回出「云灵已连接」就通了。先别急着让它改代码——先确认通路，再干活。万一回 404，先别急——见报错自查的 404 条按提示定位（多半是地址结尾或模型名写法）。

配 Codex

端点已开放

还没装 Codex？两分钟装好

终端 · 官方安装脚本

curl -fsSL https://chatgpt.com/codex/install.sh | sh

也可以用 npm（需已装 Node.js）：npm install -g @openai/codex；或 Homebrew：brew install --cask codex。npm 慢的话换镜像源，命令见上一章。

以上三种装法（安装脚本、npm、Homebrew）均已逐字核对 Codex 官方 README（2026-08-24）。

确认装好了终端里跑 codex --version，打印出版本号就装好了。提示 command not found 先重开一个终端窗口再试——多数是新命令还没被当前窗口认识，不是装失败。

路线 A：CC Switch 一键导入（推荐）

现已可用和 Claude Code 同一个入口：电脑网页版「API Key」页点行内「导入」，抽屉里「配到哪个工具」选 Codex，其余步骤与第 05 章的四步完全一样。导入的端点会自动带上 /v1，不用操心结尾。也可以改走下面的路线 B 手写。

路线 B：手写 config.toml（备选，与路线 A 二选一）

Codex 的配置在 ~/.codex/config.toml（Windows 是 %USERPROFILE%\.codex\config.toml；.codex 文件夹不存在就先建一个）。密钥不写进配置文件，走环境变量——这是 Codex 官方的规矩。两件事都做完再重开终端：

~/.codex/config.toml

model = "gpt-5.6-terra"
model_provider = "yunling"

[model_providers.yunling]
name = "云灵"
base_url = "https://yunling.yunshihub.com/v1"
wire_api = "responses"
env_key = "YUNLING_API_KEY"

model 必须显式填写：gpt-5.6-terra 是云灵全站的默认模型，不是「Codex 不填也会用它」——config.toml 里这行不能省。境内线把 base_url 整段换成 https://cn.yunshihub.com:8443/v1（端口不能漏）。
从旧教程迁过来的：老配置里的 wire_api = "chat" 已不被官方支持，唯一合法值是 "responses"（官方文档：省略这行时默认也是它），改掉或删掉这行即可。

用编辑器打开 ~/.zshrc（或 ~/.bashrc）——终端里跑 touch ~/.zshrc && open -e ~/.zshrc 就能在「文本编辑」里打开它；在末尾手动加一行，保存后重开终端：

~/.zshrc · 末尾加这一行

export YUNLING_API_KEY="yl_live_你的密钥"

两个密钥安全细节 ①别用 echo 命令往 rc 文件里写：命令行里敲过含密钥的命令，密钥会永久留在 shell 历史记录里——所以上面让你用编辑器打开粘贴； dotfiles 有同步到仓库或云盘习惯的，请把这行改放到不入库的本地文件里。 ②变量名别复用 OPENAI_API_KEY：会和 Codex 自带的 OpenAI 登录态打架，出现「一会儿能用一会儿不能用」这种最难查的毛病，用专属名字（比如 YUNLING_API_KEY）。另外：config.toml 和环境变量只做了一半的话，Codex 会因读不到 env_key 指定的变量而报错。

最小测试

终端

codex "如果你已经接到云灵，请只回复：云灵已连接"

成功标志：codex 会打开整屏交互界面，回复出现在对话区，看到「云灵已连接」就通了；按 Ctrl+C 或输入 /exit 退出。万一回 404，先别急——见报错自查的 404 条按提示定位（多半是地址结尾或模型名写法）。

选哪个模型

先记住口径：Claude Code 填 claude- 开头的模型；Codex 填 gpt- 开头的；整个货架（含 deepseek / glm / kimi）都能在 Cherry Studio / Chatbox 这类客户端里用。
编程工具最烧钱的地方是它会反复读文件、反复试。按活分三档用；下表价格为 2026-08-24 快照，单位元 / 百万 token，以「API Key」页的实时价目为准。

性价比档

日常改码、补测试、格式整理、大批量小任务、长时间跑批。

deepseek-v4-flash入 0.5 / 出 1.0

claude-haiku-4-5入 0.2 / 出 1.0

主力档

大多数开发任务的默认选择：常规功能、跨文件改动、代码审查。

claude-sonnet-5入 0.6 / 出 3.0

gpt-5.6-terra入 0.8 / 出 4.8

deepseek-v4-pro入 1.5 / 出 3.0

gpt-5.6-terra 同时是云灵全站默认模型，Codex 首选。

旗舰档

复杂重构、需要真看懂整个项目的硬骨头。贵，但一次做对比反复返工便宜。

claude-opus-5入 1.0 / 出 5.0

claude-fable-5入 5.0 / 出 25.0

还有 claude-opus-4-8（上一代旗舰，与 opus-5 同价——同为入 1.0 / 出 5.0，一般直接选新款）。

别按「国产 = 便宜」的直觉挑，按数字挑。 上表出价从 1.0 到 25.0 差 25 倍；也有不少型号价格高于主力档全部成员—— 例如 glm-5.2 出价 17.5、kimi-k2.7-code 出价 13.5。在售全量和实时价目（含 kimi-k3 这类大杯）见「API Key」页的「可用模型」清单。

选好了填到哪 Claude Code：填 settings.json 的 ANTHROPIC_MODEL（或 CC Switch 导入抽屉的「默认模型」）。 Codex：填 config.toml 的 model。 Cherry Studio / Chatbox：填第 03 章表格里的「模型」字段。模型名照抄清单，大小写、连字符、版本号都不能改，写错会报 model_not_found。个别型号临时维护中就换同档另一个。

怎么切回原配置

随时可切、随时可回，来回切换不限次数。三种情况各三行：

A	走 CC Switch 的主界面把原来那条（你原有的登录或其它供应商）切回生效，重开终端即可	原配置恢复生效
B	手写 settings.json 的把 `env` 段里加的五行删掉：`ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`，保存后重开终端	Claude Code 回到你原来的登录方式
C	Codex 手写 config.toml 的把顶部 `model = …` 那行和 `model_provider = "yunling"` 行一起删掉（接云灵之前就有自己的 `model` 设定的，恢复成原值），重开终端；`YUNLING_API_KEY` 环境变量留着无害，想清理：macOS / Linux 从 `~/.zshrc` 删那行，Windows 到系统「环境变量」设置里删掉 `YUNLING_API_KEY` 用户变量	Codex 回到你原来的登录方式

确认真的在走云灵

配好之后一定对一次账，确认这笔真的记在你这把密钥上，而不是还在走原来的额度。

A	看云灵用量明细网页版左侧「用量明细」（或 App 同名页），找刚才那个时间点。没看到就刷新、等一会儿再看，仍然没有再回去查配置	能看到本次调用的记录，模型名对得上
B	看扣费一次最小测试可能只扣几厘，明细里金额显示 0.00 属正常；计费以云灵明细为准	这条记录带模型名与金额（可能是 0.00）
C	看密钥限额「API Key」页看这把密钥的「已用 / 上限」。想真验一次限额保护：临时把总限额改成极小值跑一句，看是否返回 429 `insufficient_quota`，验完改回来	已用额度在涨

报错自查：看到哪个字，就是哪个病

云灵的报错里都带着机器可读的错误码。先在报错原文里找下面的关键词，按行对症；表里没有的再看下面的常见问题。

报错里看到什么字	什么原因	怎么办
401 `invalid_api_key`	密钥没通过验证	回「API Key」页重新复制，检查首尾有没有多带空格或换行；确认没被停用或轮换过（轮换后旧的立刻失效）。
403 `api_key_ip_forbidden`	这把密钥开了 IP 白名单，当前来源 IP 不在名单里	走 `yunling.yunshihub.com` 直连时，报错文案里带的就是你当前出口 IP，把它加进白名单即可（换网络、连热点都会触发）。走境内线 `cn.yunshihub.com:8443` 时，报错里的 IP 是中转机的、不是你的——别把它加白名单（等于对所有人放行）；要用 IP 白名单请改走直连地址。
403 `model_not_allowed`	模型不在这把密钥的模型白名单里	「API Key」页「编辑」这把密钥，把模型加进白名单；或换一把不限模型的密钥。
404 `model_not_found`	模型名写错，或该型号临时维护中	照抄「API Key」页「可用模型」清单里的名字，别自己改大小写或版本号；维护中就换同档另一个（见第 07 章）。注意 Claude Code / Codex 只认各自家族的模型名：前者填 `claude-` 开头的，后者填 `gpt-` 开头的。
404 但报错里没有 `model_not_found`	多半是打到了尚未开放的端点（Claude Code 的 `/v1/messages`、Codex 的 `/v1/responses`），或地址拼错	先跑第 03 章那条 curl 自证（Windows 用第 03 章的 Windows 版 `curl.exe` 命令）：能返回模型清单，说明密钥和地址都对，是端点还没开放——不是你配错了，先用第 03 章的客户端，开放后本页会更新。 curl 也不通，再检查地址结尾：Claude Code 不带 `/v1`（多写就成了 `/v1/v1`），OpenAI 协议要带 `/v1`。
402 `insufficient_balance`	钱包余额不足——402 只有这一个意思，和密钥限额无关	去「钱包 → 在线充值」充值。
429 `insufficient_quota` `API key spending limit reached`	这把密钥的花费上限（总限额或日限额）到顶	「API Key」页「编辑」调高限额，或换一把。这不是限流，稍等重试没有用。
429 `api_key_rate_limited`	触发每分钟请求数限流——每把密钥默认 60 次 / 分钟，编程工具一次任务连发几十上百个请求，撞上很常见	稍等重试（响应头 `retry-after` 会告诉你等几秒）、调低并发；长期不够就到「API Key」页把这把的「每分钟请求数上限」调高。调「花费上限」对这条没用，别调错开关。

不带错误码的常见问题

连不上超时 / 连接被重置 / 证书报错

走境内线的先怀疑 8443 端口被拦：部分公司网、校园网会挡非常规端口，把地址换回 https://yunling.yunshihub.com 再试。还不行就检查系统代理设置和 HTTP_PROXY / HTTPS_PROXY 环境变量有没有劫持流量。都排除了还连不上，到 App 或网页版 →「我的」→「反馈与建议」把报错原文发给我们。

卡顿时不时卡一下，但不报错

第一嫌疑：撞上每分钟 60 次的默认限流（见上表 api_key_rate_limited），去「API Key」页调高这把密钥的每分钟请求数上限。
其次检查 ANTHROPIC_DEFAULT_HAIKU_MODEL 是否已配成货架上的 claude-haiku-4-5——后台小模型和货架对不上，可能导致后台功能异常。

配置改完配置没生效

重开终端。shell 环境变量（~/.zshrc 里那类）要新开终端才生效； settings.json / config.toml 在下一次启动 claude / codex 时读取；最省事的做法就是重开一个终端窗口，CC Switch 切换供应商之后同理。VS Code 里用的话，要把 VS Code 整个重启。
两条配置路都做过的，先确认现在生效的是哪份——打开 ~/.claude/settings.json 看 env 段现状（见第 05 章「二选一」）。

费用刚启动什么都没干就扣钱了

正常。这类工具启动时会自己发几个初始化请求（读项目结构、准备上下文）。 Claude Code 里的 /cost 是客户端按官方牌价做的本地估算，和云灵的实际计费是两套口径，对不上属预期内，以云灵用量明细为准。

功能联网搜索用不了

Claude Code / Codex 的联网搜索是模型 API 侧的服务端工具，请求会经过你配置的接入点；云灵接入点暂不支持透传该工具，所以接云灵时联网搜索预期不可用，属正常现象。云灵 App 内的联网查询是另一套能力，不受影响。

去建密钥，先用现成客户端体验去充值还是不通？到 App 或网页版 →「我的」→「反馈与建议」把报错原文发给我们——对着上一章的关键词描述，处理会快很多。

更新日期：2026-08-24 · Claude Code / Codex 原生端点现已开放。

Claude、Claude Code 为 Anthropic 的商标；Codex 为 OpenAI 的商标；CC Switch 为其作者的开源项目； Cherry Studio、Chatbox 及其余提及的产品名归各自权利人所有。云灵为独立第三方服务，与上述任何厂商均无隶属、合作或授权关系；本页仅说明如何将上述工具指向兼容的 API 地址。

让终端里的 claude 和 codex用云灵的额度干活

注册、充值、建一把限额密钥

路线总览：照这个顺序走

接入地址：不同协议填的不一样

现在就能用：Cherry Studio、Chatbox 等

最小测试

装 CC Switch

配 Claude Code

还没装 Claude Code？两分钟装好

两条配置路，二选一——别两条都做

第一次跑，先做最小测试

配 Codex

还没装 Codex？两分钟装好

路线 A：CC Switch 一键导入（推荐）

路线 B：手写 config.toml（备选，与路线 A 二选一）

最小测试

选哪个模型

怎么切回原配置

确认真的在走云灵

报错自查：看到哪个字，就是哪个病

不带错误码的常见问题

让终端里的 claude 和 codex
用云灵的额度干活