选择使用方案

使用方案决定 API Key 适用于哪类客户端、可以调用哪些模型，以及是否允许在订阅资源不可用时进入 PAYG。应当根据实际客户端选择方案，而不是只根据模型名称选择。

Agent 订阅（按量兜底）agent-subscription-payg-fallback

适合

标准 Agent Harness，需要按量兜底

调用方式

先使用 Agent 订阅；不可用时再进入 PAYG。

需要

Agent 套餐；兜底时还需要 PAYG 可用额度

默认

Agent 订阅agent-subscription

适合

标准 Agent Harness，不允许按量兜底

调用方式

只使用 Agent 订阅；不可用时直接返回错误。

需要

适用于 Agent 订阅的套餐

Codex 订阅codex-subscription

适合

Codex App / CLI，可通过 CC Switch 配置

调用方式

使用 Codex 订阅支持的 GPT 编码模型。

需要

适用于 Codex 订阅的套餐

Claude Code 订阅claude-code-subscription

适合

Claude Code CLI / Claude App，可通过 CC Switch 配置

调用方式

使用 Claude Code 订阅支持的模型。

需要

适用于 Claude Code 订阅的套餐

PAYGpayg

适合

自定义 Harness、后端服务和直接 API 调用

调用方式

不限制 Harness，按实际用量调用模型。

需要

PAYG 套餐或钱包可用额度

默认选择

使用受支持的标准 Agent 客户端，并且希望订阅资源不可用时继续调用，可选择 Agent 订阅（按量兜底）。自定义 Harness 或自行编写的 API 程序应选择 PAYG。

Agent 方案的客户端要求

Agent 方案只允许在标准 Harness 环境中使用。Harness 是实际发起并编排模型请求的 Agent 客户端，当前包括：

• OpenClaw
• Hermes Agent
• Codex App / CLI
• Claude Code CLI / Claude App
• OpenCode
• Cline
• Pi

CC Switch 可以用于管理 Codex、OpenClaw 和 Hermes Agent 的 Provider 配置，但不会改变客户端本身的 Harness 类型。

不支持自定义 Harness

agent-subscription 和 agent-subscription-payg-fallback 都不可用于自定义 Harness、普通后端服务或自行编写脚本的直接 API 调用。此类调用请使用 payg。

Agent 订阅（按量兜底）

适合上述标准 Agent 客户端，并且需要在订阅资源暂不可用时继续完成请求的场景。

Agent 订阅可用 → 使用 Agent 订阅额度
Agent 订阅不支持当前模型或暂不可用 → 尝试 PAYG

该方案会先尝试 Agent 订阅，因此仍然必须满足标准 Harness 要求。具有 PAYG 兜底不代表自定义 Harness 可以使用这个方案。进入 PAYG 后，请求使用 PAYG 可用额度并按 PAYG 费用记录。

Agent 订阅

只允许上述标准 Agent 客户端使用 Agent 订阅，不进入 PAYG。

适合：

• 明确不允许使用 PAYG 的 Agent 任务。
• 能接受部分模型或高峰期暂时不可用的任务。
• 客户端已经实现任务队列、等待和有限重试。

如果当前模型在 Agent 订阅中暂时不可用，请求会失败并提示当前没有可用服务，不会转为按量调用。

Codex 订阅

供 Codex App / CLI 使用，也可以通过 CC Switch 管理 Codex Provider。该方案使用 Responses 协议调用模型广场中标记为 Codex 订阅的 GPT 编码模型。

注意：

• Key 必须选择 codex-subscription。
• Codex 配置应使用 Responses 协议。
• 模型广场中出现某模型，不代表它一定属于 Codex 订阅；还要检查该模型的使用方案标记。

Claude Code 订阅

供 Claude Code CLI、Claude App 使用，也可以通过 CC Switch 管理 Claude Provider。该方案使用 Anthropic Messages 协议调用模型广场中标记为 Claude Code 订阅的模型。

Key 应选择 claude-code-subscription，客户端使用 Anthropic Messages 协议。不要因为同一个 Claude 模型也出现在 PAYG 中，就把 Claude Code 的 Key 改成 PAYG；两种方案的额度和使用目的不同。

PAYG

按实际用量计费，不受标准 Harness 限制。

适合：

• 自定义 Harness、自建后端服务或直接调用 API 的脚本。
• 模型和协议兼容范围优先于计划成本。
• 生产服务不能接受订阅额度耗尽后直接中断。
• Embedding、Rerank 等按量能力。

PAYG 消耗可能显著高于订阅或计划方案。发起大批量任务前，应先设置独立 Key 和合理的 Key 额度上限。

按量兜底的边界

按量兜底不覆盖所有失败：

• 请求开始前检测到 Agent 订阅暂不可用时，可以进入 PAYG。
• 开始输出前出现可重试的服务错误时，可能进入 PAYG。
• 已经开始流式输出后再中断，不会自动重新发起请求。
• 客户端主动断开、请求体不合法、Key 无权限或额度不足时，不会进入 PAYG。

客户端仍需针对网络中断和可重试的 5xx 实现有限次数的指数退避。不要对 401、403、402 或参数错误进行无限重试。

如何确认模型属于某个方案

打开 模型广场：

1. 选择你准备使用的方案。
2. 搜索完整模型名称。
3. 检查接口类型，例如 Chat、Responses、Anthropic 或 Gemini。
4. 查看该方案下显示的费用信息。

调用前以模型广场显示的模型、接口类型、使用方案和价格为准。