Dashboard 功能
用户管理
用户管理是 Claude Code Hub 的核心功能之一，允许管理员创建和管理团队成员，为每个用户配置独立的限额和权限。本文将详细介绍用户管理页面的各项功能。
页面概览
用户管理页面采用主从布局设计：
- 左侧：用户列表，显示所有用户及其基本信息
- 右侧：选中用户的 API Key 列表及详细信息
普通用户登录后只能看到自己的 API Key 列表，不会显示用户列表。只有管理员才能看到完整的主从布局。
用户列表
搜索与筛选
页面顶部提供了三个筛选工具：
- 搜索框：根据用户名或标签进行模糊搜索
- 分组筛选：按供应商分组筛选用户（显示所有已配置的分组）
- 标签筛选：按用户标签筛选（显示所有已使用的标签）
用户卡片
每个用户卡片显示以下信息：
| 元素 | 说明 |
|---|---|
| 用户名 | 用户的显示名称 |
| 备注 | 用户的描述信息（如有） |
| Key 数量 | 该用户拥有的 API Key 总数 |
| 启用 Key 数 | 当前处于启用状态的 Key 数量 |
点击用户卡片可在右侧查看该用户的详细信息和 API Key 列表。
创建用户
管理员可以通过点击用户列表右上角的「添加用户」按钮创建新用户。
基础配置
| 字段 | 必填 | 说明 |
|---|---|---|
| 用户名 | 是 | 用户的唯一标识名称，最大 64 字符 |
| 备注 | 否 | 用户的描述信息，最大 200 字符 |
| 用户标签 | 否 | 为用户添加分类标签，每个标签最大 32 字符，最多 20 个 |
| 供应商分组 | 否 | 限制用户只能使用特定分组的供应商 |
| RPM | 是 | 每分钟请求数限制，默认 60 |
| 每日额度 | 是 | 每日消费上限（美元），默认 100 |
高级限额配置
管理员可以为用户配置更细粒度的消费限制：
| 字段 | 说明 |
|---|---|
| 5 小时限额 | 5 小时内的消费上限（美元） |
| 周限额 | 每周消费上限（美元） |
| 月限额 | 每月消费上限（美元） |
| 总消费上限 | 历史累计消费上限（美元），超过后拒绝所有请求 |
| 并发 Session 限制 | 同时活跃的会话数量上限 |
留空的限额字段表示不限制。建议根据团队成员的实际需求合理配置限额，避免意外超支。
编辑用户
点击用户名右侧的编辑图标（铅笔图标）可以修改用户信息。编辑表单与创建表单字段相同，所有配置项均可修改。
删除用户
点击用户名右侧的删除图标（垃圾桶图标）可以删除用户。
删除用户是软删除操作，会同时删除该用户的所有 API Key。历史日志数据会保留以供审计，但用户将无法继续使用系统。
删除确认对话框会显示：
- 即将删除的用户名
- 该用户拥有的 Key 数量
用户角色
系统支持两种用户角色：
| 角色 | 权限说明 |
|---|---|
admin | 管理员，可以管理所有用户、供应商和系统配置 |
user | 普通用户，只能查看和管理自己的 API Key |
用户角色目前无法通过 Web UI 修改，需要直接在数据库中更新。初始管理员账户在系统部署时自动创建。
API Key 管理
选中用户后，右侧面板显示该用户的所有 API Key。
Key 列表头部
头部区域显示：
- 用户名：当前选中的用户
- 今日消耗：今日已消费金额 / 每日额度
- 实时状态：活跃请求数、最后一次请求的供应商和模型
Key 列表
每个 Key 显示以下信息：
| 列 | 说明 |
|---|---|
| 名称 | Key 的描述性名称，可展开查看详情 |
| Key | 脱敏显示的 API Key，可复制完整值 |
| 今日调用 | 今日 API 调用次数 |
| 今日消耗 | 今日消费金额 |
| 最后使用 | 最后一次使用时间和使用的供应商 |
| 操作 | 查看日志、编辑、删除 |
Key 详情
点击「详情」按钮可展开查看：
- 模型统计：今日各模型的调用次数和消费金额
- 限额使用情况：各维度限额的当前使用进度
创建 API Key
点击「添加 Key」按钮可为当前用户创建新的 API Key。创建成功后会显示完整的 Key 值。
API Key 只在创建时显示一次，请务必妥善保存。如果丢失，需要创建新的 Key。
编辑 API Key
可以修改 Key 的以下配置：
- 名称
- 启用/禁用状态
- 过期时间
- Web UI 登录权限
- 各维度限额配置
删除 API Key
每个用户至少需要保留一个 API Key，因此当用户只有一个 Key 时，删除按钮会被禁用。
供应商分组
供应商分组功能允许管理员控制用户可以使用的供应商范围：
- 在「供应商管理」中为供应商设置分组标签
- 在「用户管理」中为用户指定供应商分组
- 用户只能使用匹配其分组的供应商
如果用户未设置供应商分组，则可以使用所有启用的供应商。这对于需要限制特定用户使用特定供应商的场景非常有用。
用户标签
用户标签功能允许管理员对用户进行灵活分类管理：
- 添加标签：在用户创建/编辑表单中输入标签名称，按回车添加
- 删除标签：点击标签上的删除图标移除
- 筛选用户：在用户列表页使用标签筛选器快速定位
标签可用于区分用户类型（如 VIP、测试用户）、部门归属或其他自定义分类。
权限说明
| 操作 | 管理员 | 普通用户 |
|---|---|---|
| 查看用户列表 | 可以 | 不可以 |
| 创建用户 | 可以 | 不可以 |
| 编辑用户 | 可以 | 不可以 |
| 删除用户 | 可以 | 不可以 |
| 查看自己的 Key | 可以 | 可以 |
| 创建自己的 Key | 可以 | 可以 |
| 编辑自己的 Key | 可以 | 可以 |
| 删除自己的 Key | 可以 | 可以 |
| 查看他人的 Key | 可以 | 不可以 |
| 管理他人的 Key | 可以 | 不可以 |
