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

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

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

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

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

# bash / zsh：隐藏输入，不把密钥写进命令历史
printf '粘贴云灵 API Key（输入不可见）：'
stty -echo
IFS= read -r YUNLING_API_KEY
stty echo
printf '\n'
export YUNLING_API_KEY
curl --fail-with-body https://yunling.yunshihub.com/v1/models \
  -H "Authorization: Bearer $YUNLING_API_KEY"

$yunlingSecret = Read-Host "粘贴云灵 API Key" -AsSecureString
$env:YUNLING_API_KEY = [System.Net.NetworkCredential]::new('', $yunlingSecret).Password
curl.exe --fail-with-body https://yunling.yunshihub.com/v1/models -H "Authorization: Bearer $env:YUNLING_API_KEY"

最小测试

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

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

看到它回复只代表这次生成完成；还需按第 09 章核对日志，确认走的是云灵。不通就先跑上面那条 curl 自证做二分定位： 目录能通、对话不通：继续核对协议、模型、白名单、余额和报错内容； 目录也不通：先排查网络、地址与密钥，回第 02 章、第 00 章检查。

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

brew install --cask cc-switch

安装方式于 2026-09-11 核对作者 README。官方当前系统要求：Windows 10+、macOS 12+；Linux 依具体发行版和安装包说明。教程不固定某个“最新版”编号。

安装 Claude Code 并确认版本

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

irm https://claude.ai/install.ps1 | iex

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

本页配置的是本机 CLI。CC Switch 管理供应商，手写方式管理用户配置；选定一种日常维护方式即可。 已手写过的先备份，再核对 ~/.claude/settings.json 的 env、终端环境变量与项目配置。 项目、命令行和组织策略可能覆盖用户设置，并非简单的“最后写入者生效”；排查时用 Claude Code 的 /status 查看当前模型与认证方式。

{
  "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"
  }
}

第一次跑，先做最小测试

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

看到它回复只代表这次生成完成；还需按第 09 章核对日志，确认走的是云灵。先别急着让它改代码——先确认通路，再干活。 万一回 404，先别急——见报错自查的 404 条按提示定位（多半是地址结尾或模型名写法）。

安装 Codex 并确认版本

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

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装脚本与配置说明于 2026-09-11 核对 Codex 官方文档；按你当前系统选择一种安装方式即可。

路线 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 文件夹不存在就先建一个）。 本例使用官方支持的 env_key 环境变量认证，不把密钥直接嵌入 TOML。 如设置过 CODEX_HOME，请修改那个目录下的文件。先备份已有文件，顶层 model / model_provider 放在任何 [表名] 之前，已有同名字段只改值、不重复添加；其余配置保留。

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"

export YUNLING_API_KEY="yl_live_你的密钥"

最小测试

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

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

从实时模型广场查当前状态、价格与能力，再回密钥页核对分组和白名单。 云灵的 CC Switch 导入器给 Claude Code 列出 claude- 型号、给 Codex 列出 gpt- 型号。 通用 OpenAI 客户端还需选择支持文本对话的模型，图片、视频等模型不能直接当聊天模型使用。

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

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

先看 HTTP 状态码，再看正文里的 error.code、error.type 或错误描述。 不同协议和上游的错误形状可能不同；HTML 错误页通常来自代理或网关，不能只按一个关键词判断。

不带错误码的常见问题

这是云灵当前接入范围，不是各厂商完整 API 的替代承诺。CLI 升级后新增的参数与工具，需要重新验证。

官方参考（2026-09-11 核对）： CC Switch 项目与安装说明 · CC Switch 导入协议 · Claude Code 网关配置 · Claude Code 配置优先级 · Codex 自定义 Provider · Codex 配置字段。 本页配置示例使用占位密钥；官方文档说明客户端行为，云灵支持范围以本页和实际接口返回为准。