用 CC Switch 接入 Voguesly API

2026-10-17 定价更新:请以当前价目页所选渠道、模型及最终账单为准;模型例外价优先于分组折扣。旧的 GPT官+AZ 混合、Claude特供分组已停止在本站销售。本文早于19:56的实测金额是调价前历史记录,不是当前固定单次收费。

Claude Desktop、Claude Code 与 Codex 的图文配置指南 · macOS · 2026-10-17

当前验证:CC Switch 4.0.13、Claude Desktop Cowork 已通过本站 Sonnet 5.5 返回 OK,并核对客户与代理日志。Codex App 与 CLI 已通过本站 GPT-5.6 Terra 短文本并核对扣费,具体配置和账单见第5、6节;Codex CLI 已以 none 推理模式通过两轮真实工具/读写文件/编码测试,带推理的密文续接仍有上游兼容问题,App 工具未验。当前按渠道展示售价,单独模型例外价保留;以实时价目和账单为准。

四个入口,两种接法

1. 先分清四个入口

使用入口 CC Switch 选择 本次实测的接法 当前验证
Claude Desktop / Cowork Claude Desktop 原生 Messages,直连 已跑通,已对账
Claude Code CLI Claude Code 原生 Messages,直连 短文本成功并核扣费;复测仍有上游失败
Codex CLI Codex GPT-5.6 Terra,原生 Responses,经本地路由 短文本已过;none 模式两轮编码已过,见第5节
Codex 桌面 App Codex 同上;保留官方登录,新空聊天 已返回测试标记,实扣 US$0.022954

CC Switch 是配置管理和可选的本地转发工具。它不是模型供应商,也不附送本站余额;本站 API 用量与 Claude / ChatGPT 官方订阅分开计算。一个入口配置成功,不代表另外三个也已生效。

先看 API 注册、余额、首个请求与 Chatbox 入门教程。

2. 准备工作

  1. 从 CC Switch 官方项目 安装适合自己系统的版本。本教程以实际安装的4.0.13界面为准;后续版本按钮可能变化。
  2. 登录 本站,确认钱包有余额,准备自己的已有 API key。
  3. 从本站“API 密钥”页复制现有key;账号邮箱和登录密码都不是API key。密钥只填 CC Switch 的遮罩框,不放教程、截图、分享链接或聊天中。
  4. 第一次验证新建空聊天,不恢复含私人文件或旧模型推理内容的历史会话。
  5. 看清当前生效的供应商,保留它作为回退。修改供应商不会代替安装 Claude Code / Codex 本身。

3. Claude Desktop:本站 Sonnet 5.5(已实测)

填表

左侧选择 Claude Desktop → 添加供应商 → 自定义配置。

字段 填写
名称 易联 或 Voguesly API
官网链接 https://api.ylink.uk
API Key 自己的本站密钥(不是登录邮箱)
请求地址 https://api.ylink.uk,不要加末尾斜杠
接入方式 直连
模型列表 先添加 claude-sonnet-5-5
1M 先不勾选;只有确认所用模型及路由支持后再声明

Claude Desktop 的本站配置,密钥保持遮罩

本站已验证原生 /v1/messages。这里填根地址,客户端拼接请求路径;不要把 /v1/messages 或 /chat/completions 当根地址重复填。

启用

添加后在“易联”卡片上点 切换。如果当前是路由模式,可选 直连 → 回到直连并使用。看到“直连生效中 · 直接连接 易联”才表示该配置已经启用,仅看到供应商卡片不算生效。

然后完全退出并重新打开 Claude Desktop。检查模型菜单中是 Sonnet 5.5,新建空任务发送:

Reply only OK. Do not use tools, files, connectors, web search, or create anything.

Claude Desktop 本次实际返回 OK

本次实测的是 Cowork,不据此承诺 Code 模式、工具调用、文件处理、图片或长上下文已经验证。

为什么不用截图里原来的 DeepSeek 映射?

“模型映射”会把客户端的 Sonnet / Opus / Haiku 档位改成实际请求的模型。若 Sonnet 一行填写 deepseek-v4-pro,实际请求就是 DeepSeek,不能对客户说它调用了 Sonnet。本次要用本站原生 Claude,因此先使用直连及真实 Claude 模型 ID。

如果以后确实要在 Claude Desktop 使用 DeepSeek等其他模型,再选映射模式,并将“菜单显示名”和实际模型对应写清楚;映射模式需要 CC Switch 保持运行。

4. Claude Code CLI:单独配置

在 CC Switch 左侧选 Claude Code。不要以为 Claude Desktop 的配置会自动套到这里。

常规自定义供应商填法:

字段 值
请求地址 / ANTHROPIC_BASE_URL https://api.ylink.uk
API Key 自己的本站密钥(不是登录邮箱)
上游格式(如出现) Anthropic Messages
默认模型 / ANTHROPIC_MODEL claude-sonnet-5-5
Sonnet 默认模型 claude-sonnet-5-5
Opus / Haiku 按站上可用的真实模型ID填写;本次未实测这两档

也可从 添加供应商 → 统一供应商 → 自定义网关 一次生成 Claude Code 和 Codex 两张供应商卡片。它省去重复填 key,但两边的协议、启用和实测仍须分别检查。不要额外启用暂时不用的 Gemini 等应用。

保存后启用本站卡片,在新终端中启动 claude --model claude-sonnet-5-5,发送一次短问题,再核对站上日志。若旧终端有遗留 ANTHROPIC_BASE_URL / key 环境变量,可能覆盖 CC Switch 设置;不要把完整环境变量输出给客服。

首轮诊断可用 CLI 的输出预算、禁工具和空目录方式控制范围。正常编码任务则按真实工作需要使用,不要照搬诊断限制到日常工作。

Claude Code 2.1.299:关闭本次上游不接受的实验性 beta

本次 CLI 起初失败,客户日志显示上游拒绝若干 anthropic-beta 特性;失败链也有无可用通道503和分组无权限403。不能只看终端最后一条403,就断定密钥填错或需要充值。

在 CC Switch 的 Claude Code → 编辑本站供应商 → 配置 JSON,在已有的 env 对象内新增:

"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"

注意逗号和 JSON 语法。只新增这个字段,不要用它覆盖整份配置或删除原有地址、模型、密钥字段。 点保存,再启动新的 Claude Code 进程。该设置关闭实验特性,不是关闭证书校验或冒充另一客户端。

也可以先在新终端做一次临时验证:

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 claude --model claude-sonnet-5-5

14:17:24 实测已成功: 返回预期测试标记,输入381/输出21、5分钟缓存写入666 tokens,本站实扣 US$0.001318。CLI估算US$0.002637按其本地标价计算,不等于本站最终收费。此为禁工具、空目录的一条短文本测试;编码工具、文件修改与完整Agent工作流尚未逐项验收。

随后把同一 beta 开关保存到 CC Switch 再做新进程复测,客户端超时未收到结果;后续刷新查到服务端在14:22:19完成请求,输入381/输出18、缓存写636,另扣US$0.001266。因此超时不能直接当作没有执行或没有扣费,先查日志再决定重试。这仍不是客户端第二次成功验收。

5. Codex CLI:GPT-5.6 Terra 原生 Responses(已实测)

本次选择本站刚有成功记录的 gpt-5.6-terra,不继续重试饱和的 gpt-6-luna。在 CC Switch 左侧 Codex → 添加供应商 → 自定义配置,或编辑已保存的本站供应商:

字段 填写内容
名称 易联 API · Codex,可自定
官网链接 https://api.ylink.uk
API Key 自己的本站 API key,只填遮罩框
API 请求地址 https://api.ylink.uk/v1
默认模型/模型列表第一项 gpt-5.6-terra
高级选项 → 上游格式 Responses(原生)

点 保存,再在 Codex 的 路由 模式选择此卡片。确认“路由生效中 → 易联 API · Codex”;保持 CC Switch 和本地路由运行。此路径中 Codex 的 Responses 请求直接转发到本站 /v1/responses,无需转成 Anthropic Messages。不要把完整 /responses 再填进只要 /v1 前缀的栏位。

新开 CLI 进程,在空目录开始全新会话,使用 /model 选 gpt-5.6-terra。首次只发:

Reply exactly CODEX_CLI_TERRA_OK. Do not use tools.

2026-10-17 16:53:27 实测: Codex CLI 0.162.1 返回 CODEX_CLI_TERRA_OK,退出码0;本站记录 Azure、输入17,167/输出11、缓存写入17,164 tokens,实扣 US$0.019372。客户请求ID与代理日志精确匹配。这次为隔离空目录、read-only、单次且禁自动重试的短文本验证,保留真实工具定义,但没有执行工具或修改文件,不能据此宣称完整编码工作流已验收。

若请求先在本地报502,检查 CC Switch 设置 → 网络 → 全局出站代理 是否与自己的网络相符。本机使用已经运行的本地代理才到达上游;每台电脑端口可能不同,不能照抄端口。不要关闭证书验证,也不要为此随意切换系统TUN。

已知失败路线: 本次 gpt-6-luna 返回429“上游负载已饱和”,已停止反复测试;Sonnet经 Responses→Messages 转换时,Bedrock拒绝 tools.*.strict 返回400,因此本教程不把这条转换路线列为已通过。不要删掉全部工具定义来凑一个“编码接通”的结论。

多轮编码:已验证的 none 兼容方案

适用范围:Codex CLI 0.162.1、CC Switch 4.0.13、本站 gpt-5.6-terra 原生 Responses。 先确认 CC Switch 显示“路由生效中 → 易联 API · Codex”,再开一个不含私人文件的空测试目录,启动新会话:

mkdir -p ~/ylink-codex-demo
cd ~/ylink-codex-demo
codex -m gpt-5.6-terra -c 'model_reasoning_effort="none"'

none 表示关闭该模式的深度推理,不是换模型,也不是关闭工具、沙盒、审批或证书验证。它可能降低复杂任务的推理能力;本次只是针对密文续接错误验证的兼容选择。这个启动参数不改写全局配置。目录里已有内容时,请另选一个空目录;在正常权限提示中只批准本测试需要的操作。

可以在同一个会话依次验证下面两轮,不要每轮都重开新聊天:

  1. 第一轮:创建 Python invoice.py 的 total(rows),用 Decimal 计算金额并 HALF_UP 保留两位;创建 unittest,检查空列表、0.10×3+19.99×2=40.28、1.005→1.01,实际运行测试。
  2. 第二轮:先读取刚才两份文件,再把函数改为 total(rows, discount_percent="0");折扣在最终舍入前计算,拒绝低于0或高于100的折扣,新增10%、100%、范围及舍入测试,再实际运行全部测试。

2026-10-17 17:15–17:16 实测: 第一轮真实创建两个文件并通过3条测试;第二轮恢复同一会话ID,真实读文件、更新两个文件并通过7条测试,返回 TOOL_ROUND2_OK;独立重跑7条全部通过,两份文件的字节确实改变。两轮推理输出均为0,历史中没有新增加密推理条目。

编码阶段 站上逐笔实扣(USD) 小计
首轮创建与3条测试 0.012338 + 0.003320 + 0.001660 0.017318
同会话续接、修改与7条测试 0.001932 + 0.004242 + 0.001938 0.008112
两轮编码合计 — 0.025430

客户精确金额与代理同时间、模型、token记录匹配;第一轮输入32,141/输出544,第二轮新增输入35,288/输出678。客户端 resume 的 usage 是会话累计数,不能把两次累计值再相加。缓存读取已命中,实际金额随上下文和路由变化,以上不是固定任务报价。

encrypted_content 报错意味着什么

此前 low 推理模式在工具续接时报“encrypted content could not be verified / decrypted or parsed”。本次不经过 Codex CLI,将同一段测试密文原样回传,上游仍记录相同400,之后该请求返回成功;CC Switch 本机记录只有一次向本站转发,没有密文整流重试日志。结合4.0.13原生转发源码,证据主要指向上游密文续接/内部重试兼容,未发现 CC Switch 篡改该密文的证据。究竟是否由上游账号、通道或密钥域变化引起,尚未证实。

none 两轮通过是规避这条故障路径,不代表上游带推理的原路线已修复。已有带旧密文的会话不要靠修改或删除历史来“修复”;先保存工作,再开新会话使用此兼容参数。不要关闭 TLS 校验,也不要持续点重试。本次定位额外三条小探针合计US$0.000260,加上两轮编码,整个排查共US$0.025690。

Codex App 仍只验证到短文本。 CLI 的两轮成功不能替代 App 的工具/文件/多轮验收,也不保证长任务、并发或长期稳定性。需要深度推理时,保留可回退的供应商;不要把 none 说成与高推理模式能力相同。

6. Codex 桌面 App:GPT-5.6 Terra(已实测)

  1. 在 CC Switch 设置 → 应用配置 → Codex 保持 “非接管切换时保留官方登录” 开启;路由接管期间亦保留官方登录。不要把官方登录 token 当本站 API key。
  2. 使用第5节同一张供应商卡:https://api.ylink.uk/v1 + gpt-5.6-terra + Responses(原生),保存并启用路由。
  3. 在 Codex App 新建空聊天,从模型菜单选 GPT-5.6 Terra。菜单显示名和本站精确模型名可能格式不同;最终查本站日志。不要恢复原供应商的旧会话,避免把旧内容发送给新供应商,或遇到 encrypted_content 无法解密。
  4. 发送一次下方测试;若模型菜单没有相应条目,保存配置后再启动新的 App 进程检查,先保存正在做的工作。
Reply exactly CODEX_APP_TERRA_OK. Do not use tools.

2026-10-17 16:54:10 实测: App返回 CODEX_APP_TERRA_OK,CC Switch记录Codex→易联API路由;本站实际模型 gpt-5.6-terra、Azure、推理强度high,输入20,361/输出9、缓存写入20,358 tokens,实扣 US$0.022954。客户与代理同一请求ID核对通过。

Codex App 通过易联 API 返回测试标记的实际截图

同次操作在代理日志中还看到一条503“High demand”,费用US$0,之后成功;没有逐层抓包,不判断重试由客户端、本地路由还是上游哪层触发。这证明本次可以调用,不代表无波动或固定可用率。 遇错先查日志,不连续点发送。

两端真实账单(非固定单次报价)

入口 输入 / 输出 缓存读取 / 写入 最终实扣
CLI,16:53:27 17,167 / 11 0 / 17,164 US$0.019372
App,16:54:10 20,361 / 9 0 / 20,358 US$0.022954
本轮合计 — — US$0.042326

两笔主要是首次缓存写入,不是缓存读取命中;客户端会附带系统指令和工具定义,短短“OK”也不代表只有几个输入token。本站本笔按standard档及0.45折扣,分别列新增输入、输出与缓存写入,费用最终按本站明细取整。客户端/CC Switch本地估算不等于本站实扣。此页不改变任何售价,不把这两笔当作所有后续任务的价格。

7. 真实费用:不要拿一句“OK”的字数估价

本次 Claude Desktop / Cowork 验证新增了以下三笔成功记录,客户及代理同时间、同模型记录已匹配:

时间(北京时间) 输入 / 输出 缓存写入 客户最终金额
2026-10-17 12:28:51 9 / 1 — US$0.000014
2026-10-17 12:30:18 544 / 16 — US$0.000624
2026-10-17 12:30:25 3,103 / 4 47,788 tokens,1小时 US$0.098700
合计 US$0.099338

只有一次手动 Cowork 任务;另外两笔为本次启用/任务期间的附加调用,未抓取各自请求正文,不能断言分别是什么用途。主请求的费用主要来自缓存写入。Agent 可能自动附带系统提示、工具定义、历史和辅助请求,简短回答不等于低输入量。

这些是本次样本,不是固定任务价。请在 使用日志 查看自己的时间、模型、分组、输入输出、缓存、最终金额和请求ID。客户端估算、代理四位小数显示、钱包四舍显示都不能代替精确费用详情。

后续真实自测:缓存读取已命中(13:51–13:53)

后续同测试账号的使用日志已有明确缓存读取样本:

时间(北京时间) 缓存读取 5分钟缓存写入 最终实扣
13:51:10 未显示 523,686 US$0.660064
13:52:08 85,538 442,639 US$0.559432
13:53:42 532,257 1,750 US$0.031206

13:53:42的缓存读取部分实收 US$0.02661285,有效读价US$0.05/百万tokens;同档普通输入有效价US$1/百万,读取该批已有缓存比普通输入便宜95%。整笔还包括新输入、输出和新增缓存写入,不能把95%理解为整笔账单或所有路由的统一折扣。

缓存读取不等于免费,缓存写入也会收费。 第二行虽有命中,但另有44万余tokens写入,因此仍贵。明细证明“大段内容未复用”,具体是内容前缀、路由、缓存分段还是其他变化,缺少对应请求证据,不能直接归因。

同一个key不是缓存命中的充分条件;不要只靠切key或频繁换模型来验证。先看每笔的缓存读取/写入和适用时长。日志里另有503无通道、403分组权限样本,均显示US$0;这与缓存是否命中分开排查,不循环重试。

8. 排错与恢复

情况 先检查
名称显示易联,但没扣本站余额 是否真的启用了本站卡片;是否仍走旧环境变量;看本站日志
401 / 403 是否本站key、是否有空格、所选认证头;不要反复充值
404 / /responses 找不到 Codex用Claude时是否选Anthropic上游并启用本地路由
temperature is deprecated 是否走了会携带不支持参数的另一协议/客户端;不要只反复改温度数值
模型名或品牌不一致 核实际请求模型与映射,不只看菜单显示名
encrypted_content 无法验证 保存工作后开新会话;本站 Terra CLI 可用第5节已验证的 none 参数。带推理原路线未修,不改旧历史、不连续重试
回复截断 检查输出上限与真实停止原因,别直接循环重试
费用比Chatbox高很多 展开缓存与输入明细;Agent的系统上下文通常更多
切换没生效 Claude Desktop完全重启;Codex重启对应App/CLI;新空会话验证

回退时回到原供应商卡片切换;Claude Desktop可选 Claude Desktop Official 恢复官方模式,再重启。只切供应商,不删除原账号、历史或备份。日志先查明再重试,避免重复扣费。

9. 验证边界与来源

官方参考(配置行为参考,不等于本站实测):


前往 API 站注册/使用 · 查看当前分档价格

API 服务与住宅 IP 套餐分别计费。网络排查见 连接自测;本页不承诺共享通道 SLA、零保留或退款保证。具体使用与退款条件以 API 站现行条款为准。