Configuration

配置说明

配置文件默认位于 portable EXE 同目录的 config.json。也可以通过 CCPROXY_CONFIG 指定其他路径。

Server

字段	默认值	说明
host	127.0.0.1	本地监听地址；桌面版不要改成公网地址
port	15722	首选监听端口
autoPort	true	端口占用时自动递增寻找可用端口
maxRequestBodyBytes	64000000	请求体硬限制，超限返回 413

Upstream

字段	说明
baseUrl	CC Switch 或兼容模型网关地址
chatPath	默认聊天路由
aiRoutes	进入 Orchestrator 的路由列表
timeoutMs	上游请求超时
autoDiscover	配置地址不可达时扫描本地候选端口

Token Policy

推荐保持以下相对关系：

toolResultClearTarget < toolResultClearTrigger < compactThreshold < hardLimit
hardLimit - safetyMargin - responseReserve > 0

hardLimit 是代理安全阈值，不一定等于模型公开窗口。若经常出现本地估算明显低于上游统计，应降低阈值，而不是把输出预算压到 0。

Vision

• enabled：启用图片预处理。
• models：一个或多个 Vision 模型。
• compareModels：是否同时获取多模型摘要。
• apiKeyEnv：推荐的密钥环境变量名。
• apiKey：兼容直接配置，但不推荐长期明文保存。
• stripImagesAfterSummary：摘要成功后是否移除原始图片。

Claude Patch

• claudeConfigPatch.enabled：接管 Claude Code。
• autoCompactEnabled：注入原生 compact 环境变量。
• autoCompactReserveTokens：为输出和工具调用保留窗口。
• hookObserverEnabled：启用 Observer Hooks。
• claudeDesktopConfigPatch.enabled：接管 Desktop Gateway。
• desktopWatchIntervalMs：Gateway 漂移检测间隔，0 表示关闭。

配置变更风险

v0.4.92 保存配置后会重启代理。当前不是事务式切换：新配置无法启动时，代理会保持停止且磁盘上仍是新配置。修改 host、port、upstream 和路径前应保留可用配置副本；事务配置属于 Production-Roadmap。