配置

配置页面允许团队管理员对系统进行全局设置，包括站点参数和日志自动清理策略。合理的配置能够提升团队使用体验并有效管理系统资源。

访问配置页面

登录管理后台
在左侧导航栏选择「设置」
点击「配置」子菜单

站点参数配置

站点参数配置包含系统的基础设置，影响整体展示效果和计费方式。

站点标题

自定义系统的显示名称，该名称会显示在浏览器标签页和页面标题中。

字段类型：文本输入
最大长度：128 个字符
默认值：Claude Code Hub

货币显示

选择系统中金额数据的显示货币单位。支持的货币包括：

货币代码	货币名称	符号
USD	美元	$
CNY	人民币	¥
EUR	欧元	€
JPY	日元	¥
GBP	英镑	£
HKD	港币	HK$
TWD	新台币	NT$
KRW	韩元	₩
SGD	新加坡元	S$

注意：货币显示设置仅影响界面展示，不会进行实际的汇率换算。所有内部计算仍以 USD 为基准。

计费模型来源

配置计费时使用的模型名称来源：

重定向前（original）：使用客户端请求的原始模型名称进行计费
重定向后（redirected）：使用经过供应商模型重定向后的实际模型名称进行计费

当供应商配置了模型重定向时，此选项决定了成本计算依据哪个模型的价格。

允许全局使用情况查看

开启后，普通用户可以在仪表盘查看全局使用统计数据。关闭时，用户只能查看自己的使用数据。

默认值：关闭
适用场景：团队透明度较高，希望成员了解整体使用情况时可开启

启用 HTTP/2

控制代理请求是否使用 HTTP/2 协议。

字段类型：开关
默认值：关闭

状态	说明
关闭	使用 HTTP/1.1 协议（默认，兼容性更好）
开启	启用 HTTP/2 协议（性能更优，自动降级）

自动降级

启用 HTTP/2 后，如果连接失败会自动回退到 HTTP/1.1。SOCKS 代理不支持 HTTP/2，会强制使用 HTTP/1.1。

供应商错误详细信息

控制当没有可用供应商时返回给客户端的错误信息详细程度。

字段类型：开关
默认值：关闭

状态	说明
关闭	返回简洁错误信息（"No available providers"），保护内部架构
开启	返回详细错误诊断，包含每个供应商的过滤原因（限流、熔断等）

安全提示

生产环境建议保持关闭，避免向客户端暴露供应商架构信息。开发/调试环境可开启以便排查问题。

自动清理配置

自动清理功能用于定期清理历史请求日志，防止数据库过度增长。

启用自动清理

总开关，控制是否启用日志自动清理功能。

默认值：关闭
建议：长期运行的生产环境建议开启

保留天数

设置日志的保留期限，超过此期限的日志将被自动删除。

取值范围：1 - 365 天
默认值：30 天
建议：根据合规要求和存储空间综合考虑，一般建议保留 30-90 天

清理计划（Cron 表达式）

使用 Cron 表达式设置清理任务的执行时间。

默认值：0 2 * * *（每天凌晨 2 点执行）
格式说明：分钟小时日期月份星期

常用示例：

Cron 表达式	含义
`0 2 * * *`	每天凌晨 2:00
`0 3 * * 0`	每周日凌晨 3:00
`0 4 1 * *`	每月 1 日凌晨 4:00

建议：选择系统低峰期执行清理任务，避免影响正常使用。

批量大小

每次清理操作删除的最大记录数，用于控制单次清理对数据库的压力。

取值范围：1,000 - 100,000
默认值：10,000
建议：
- 数据量较小时可设置较大值以加快清理速度
- 数据量较大时建议使用较小值，分多次清理

保存配置

完成配置修改后，点击对应区块的「保存」按钮提交更改。

站点参数保存后会自动刷新页面以应用货币显示变更
自动清理配置保存后立即生效，下次到达计划时间时开始执行

最佳实践

初次部署时：建议先设置好站点标题和货币显示，便于团队识别
生产环境：务必开启自动清理，避免日志数据无限增长
保留天数：根据审计需求设置合理值，既满足回溯需要又不占用过多存储
清理时间：选择凌晨低峰期，批量大小根据服务器性能适当调整

配置