Claude Gateway 文档

分组与风控

创建分组、分配 Token、选择调用范围和配置限速。

分组同时决定成员与规则

先在“风控管理”创建组并配置规则,再在 Token 创建或编辑时选择该 Token 所属的组。一个 Token 可以加入多个自定义组。

default 固定包含全部 Token,不能删除。Token 不选择自定义组时,仍属于 default。按套餐修改账号不会自动改变分组。

每个请求只使用一个组

调用模型时,通过 模型ID|[组名] 指定组;省略后缀或明确使用 default 时使用全池。

所选组的规则不与其他组叠加。同一 Token 在不同组中的额度、冷却和限速仍然共享。自定义组没有可用 Token 时,不会从其他组借用。

default与两个自定义组的成员关系示意,共享Token的额度与负载不会按组复制打开原图

客户端与请求规则

“仅允许 Claude Code”适合只接收该客户端的组。普通 Messages API 客户端需要在自己使用的组中取消这一限制。

新增风控分组的实际界面示例,编号标出组名与仅允许原生 Claude Code 选项打开原图

图中是尚未提交的配置示例,点击可放大。创建组后,还要在 Token 中选择成员组。

其他规则按页面分类配置。建议先明确需要接收的客户端、模型和调用范围,再逐项启用;发生拦截时查看具体错误,避免同时改动多个选项而无法确定原因。

限速设置

Token 的并发、RPM 和活跃会话限制可以单独设置,留空时跟随套餐默认值;默认值在系统配置中维护。Count Tokens 有独立规则。

已有会话的连续调用与新会话可能适用不同的限速处理。达到会话或请求限制时,先看 Token 负载及日志,不要仅通过重复发送请求排查。

编辑Token的实际界面示例,标出分组选择与Token并发覆盖值打开原图

常见配置错误

情况检查方法
指定组报错检查名称、大小写和 `
组里没有可用账号检查成员、启停、授权状态、冷却、额度和各项限制
普通 API 被拒绝查看该组是否仍仅允许 Claude Code,以及是否命中其他规则
加入多个组却没有额外额度同一 Token 的限制和用量在各组间共享,不会按组重复分配

调用格式见 模型接入,HTTP 错误排查见 常见问题。

本页目录