Vmvia API

外观

CC Switch 统一配置 ​

本站推荐通过 CC Switch 统一管理 Claude Code、Codex 等工具的 API 配置。除非需要手动排障或高级自定义，否则不必分别编辑各工具的配置文件。

本文档中，ccs 指 CC Switch，cc 指 Claude Code，两者是不同的软件。

安装 ​

项目地址：https://github.com/farion1231/cc-switch

Windows ​

前往 Releases 下载安装版或便携版。

macOS ​

bash
brew tap farion1231/ccswitch && brew install --cask cc-switch

Linux ​

Linux 下需要装 Linuxbrew，然后用与 macOS 相同的命令：

bash
brew tap farion1231/ccswitch && brew install cc-switch

如果 Linuxbrew 装不上或不想装，可以直接从 Releases 下载对应架构的二进制（AppImage / deb / rpm，按发行版选）。

使用前先确认两件事 ​

  1. 关闭路由模式。CC Switch 的路由模式会把请求转一道，有时会掩盖真实报错，配置和排障时先关闭。
  2. 保存后直接用客户端验证。CC Switch 的「检测」按钮走的是它自己的探测请求，结果不一定代表 Claude Code / Codex 能否正常使用。保存并启用配置后，直接打开客户端发一条消息。

CC Switch 路由模式开关示意，使用前请关闭

如果出现 401 Unauthorized，且报错地址是 api.openai.com/v1/responses，也可能是旧会话的问题。先新开会话测试。新会话正常时，右键原会话 → 分叉 → 创建聊天分支。如果新会话也报错，再完全退出 Codex，按下面的步骤重新核对供应商配置。详见 配置或旧会话导致 401 的排查步骤。

通用配置流程 ​

先查模型，再配置 ​

打开 Vmvia 模型广场，用左侧「分组」筛选你准备使用的分组，确认它支持哪些模型。设置 model 时直接复制模型卡片上的完整名称，避免写错模型或分组不支持导致调用失败。

新建自定义供应商 ​

CC Switch 的预设供应商列表里没有 Vmvia，选「自定义配置」手动填写即可，五步搞定：

  1. 打开 CC Switch，点「添加配置」，选对应框架（Claude Code / Codex / 其它外接客户端）。
  2. 预设供应商选 「自定义配置」，供应商名称填 Vmvia，官网链接填 https://www.vmvia.com。
  3. 请求地址 按框架填写：Claude Code 填 https://www.vmvia.com，Codex 填 https://www.vmvia.com/v1。
  4. 填 API Key（sk-xxx），按所用分组确认 model（见下方 分组与模型对应）。
  5. 点「添加」并启用 → 重启终端或客户端。

CC Switch 自定义供应商填写示意（以 Codex 为例）

令牌设置：创建或编辑 API 令牌时，请关闭「模型限制」，限制令牌可调用的模型有时会引发未知异常。不要选择 default 分组。

CC Switch 无法使用或需要排查环境变量覆盖时，可查看各工具的手动配置页：Claude Code 配置参考 / Codex CLI 配置参考。

分组与模型对应关系 ​

完整分组说明见 完整手册「分组速查」，当前可用分组以登录后的 模型广场 为准。

框架令牌分组请求地址model 填写
Claude Codecc_maxhttps://www.vmvia.com留空，或按模型广场填写完整 Claude 模型名
其它客户端外接 Claudesale_kirohttps://www.vmvia.com按客户端要求填写 Claude 模型名
Codex（CLI / 桌面端 / 外接）codex 或 codex-wendinghttps://www.vmvia.com/v1推荐 gpt-5.6-sol，也可用 gpt-6-astra、gpt-6-sol
国产模型国模https://www.vmvia.com/v1从模型广场复制模型 ID
分组用途可用模型倍率
cc_max
Claude Code 专用
仅限在 Claude Code 客户端内部使用
站点说明：CC_MAX限制客户端（假一赔十）
claude-fable-5、claude-fable-5-1、claude-haiku-4-5、claude-haiku-4-5-20251001、claude-opus-4-5、claude-opus-4-5-20251101 等 14 个1.8x
sale_kiro
Claude 外接 · 低价
第三方客户端、IDE、网关等外接调用 Claude；内置 Prompt，支持 Thinking
站点说明：低价AWSQ（Kiro）逆向Claude（支持外部调用 有内置Prompt 支持Thinking）
claude-haiku-4-5-20251001、claude-opus-4-5-20251101、claude-opus-4-6、claude-opus-4-7、claude-opus-4-8、claude-opus-5 等 9 个0.3x
codex
Codex 专用
Codex CLI / Codex 桌面端 / 外接 Codex，纯 Pro 号池
站点说明：codex专用分组（纯pro号池）
gpt-5.6-sol、gpt-6-astra、gpt-6-sol0.2x
codex-wending
Codex 稳定版
与 codex 分组相同模型，线路更稳定，倍率略高
站点说明：codex稳定专用分组（纯pro号池）
gpt-5.6-sol、gpt-6-astra、gpt-6-sol0.35x
国模
国产模型
DeepSeek、豆包、GLM、Kimi、通义千问等，OpenAI 兼容协议
站点说明：国产模型
deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v4-pro、deepseek-v4-pro-0813、doubao-seed-2.0-lite、doubao-seed-2.1-turbo 等 27 个0.2x

cc_max 只接受 Claude Code 客户端的请求。如果你在 CC Switch 里为 JetBrains、Trae 等外接客户端配置 Claude，请改用 sale_kiro 分组的令牌。

外接调用说明 ​

外接调用时，除了选择正确分组，还需要按接入类型补对应的 User-Agent。

这部分规则已单独拆分到 外接调用 User-Agent 说明，请在以下场景优先查看：

  • OpenClaw 接第三方模型
  • 第三方平台或网关外接 Claude / Codex / 国产模型
  • 请求返回 403 block、403 Forbidden、Connection blocked

相关页面 ​

页面说明
Claude Code 快速上手安装、配置、启动
Codex CLI 快速上手安装、配置、推理深度
OpenClaw 配置网关 provider 配置
外接兼容与接入说明第三方客户端接入总入口
报错与踩坑常见问题排查

Vmvia API · 售后 QQ 群 1033966199

Copyright © 2026 vmvia.com