选择分组
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 Code | Claude | 选择能访问 Claude 或 Anthropic 兼容模型的分组。 |
| Codex CLI | OpenAI | 选择能访问 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