选择分组

HRET API 的分组会限制 API 密钥可访问的模型范围。创建或编辑 API 密钥时,需要给密钥选择合适的分组。

分组的作用

分组通常由管理员按模型厂商、计费策略或使用场景配置,例如 Claude、OpenAI、Gemini、DeepSeek 等。普通用户只需要在「API 密钥」表单中选择自己需要的分组即可。

不同 HRET API 实例的分组名称可能不同。本文用 Claude、OpenAI、Gemini、DeepSeek 举例,实际请以你的控制台展示为准。

常见选择

C

Claude 分组

适合 Claude Code

如果你主要使用 Claude Code,API 密钥需要能访问 Claude 或 Anthropic 兼容模型分组。

适用场景:

  • • Claude Code 命令行工具
  • 长上下文代码分析
  • 复杂代码生成和重构
O

OpenAI 分组

适合 Codex CLI 和 OpenAI 兼容工具

如果你使用 Codex CLI、OpenAI SDK 或其他 OpenAI 兼容客户端,API 密钥需要能访问 OpenAI 或 GPT 分组。

适用场景:

  • • OpenAI Codex CLI
  • OpenAI SDK 和兼容客户端
  • 通用聊天、代码和工具调用场景
一个 API 密钥可以选择多个分组,但建议按工具和用途拆分密钥。这样可以单独限额、停用和追踪调用来源。

如何选择?

使用场景建议分组说明
Claude CodeClaude选择能访问 Claude 或 Anthropic 兼容模型的分组。
Codex CLIOpenAI选择能访问 OpenAI 兼容聊天模型的分组。
多工具共用测试多个分组可临时选择多个分组,测试通过后再拆成独立密钥。

在 API 密钥中设置分组

进入「API 密钥」页面,新建或编辑密钥,在表单里的「分组」字段勾选需要的分组。

# API 密钥分组示例
# Example API key groups

名称 / Name: claude-code
分组 / Groups:
  ☑ Claude     <- 用于 Claude Code
  ☐ OpenAI
  ☐ Gemini
  ☐ DeepSeek

名称 / Name: codex-cli
分组 / Groups:
  ☐ Claude
  ☑ OpenAI     <- 用于 Codex CLI

下一步

确认 API 密钥和分组后,就可以使用 HRET API 自带的「CC 切换」把密钥配置到 Claude Code、Codex CLI 或 Gemini 工具中。

CC Switch 使用 →