docs/proxy-guide-zh.md
CC Switch 的代理功能是一个本地 HTTP 代理服务器，可以统一管理 Claude Code、Codex 和 Gemini CLI 的 API 请求。主要特性包括：
在 CC Switch 主界面，点击右上角的 Proxy 按钮，可以看到代理控制面板。
点击 启动代理 按钮启动本地代理服务器。代理默认监听 127.0.0.1:15721。
代理启动后，你可以选择让哪些应用的请求通过代理：
点击对应应用的开关即可启用/禁用接管。
注意：启用接管后，CC Switch 会自动修改对应应用的配置文件，将 API 端点指向本地代理。原始配置会被安全备份。
启用接管后，你可以正常使用各个 CLI 工具。所有请求都会经过 CC Switch 代理转发到配置的供应商。
当你不再需要代理时，点击 停止代理 按钮。CC Switch 会：
代理功能内置了智能故障转移机制：
要使用故障转移功能，你需要：
在供应商卡片上可以看到健康状态指示：
v3.9.0 新增了按应用分粒度控制功能：
CC Switch 通过检测配置备份来判断接管状态：
这确保了即使 CC Switch 异常退出，重新启动后也能正确识别状态。
在代理面板中，你可以配置以下参数：
| 参数 | 默认值 | 说明 |
|---|---|---|
| 监听地址 | 127.0.0.1 | 代理服务器绑定地址 |
| 监听端口 | 15721 | 代理服务器端口 |
| 最大重试 | 3 | 请求失败时的最大重试次数 |
| 请求超时 | 120 秒 | 单个请求的超时时间 |
| 启用日志 | 是 | 是否记录请求日志 |
A: 默认端口 15721 可能被其他程序占用。你可以：
A: 请检查：
A: 点击 停止代理 按钮，CC Switch 会自动恢复所有应用的原始配置。
如果 CC Switch 异常退出，重新启动后会检测到之前的备份，你可以：
A: 请确保：
A: 本地代理的延迟开销非常小（通常 < 1ms）。但如果启用了请求日志，在高频请求场景下可能会有少量性能影响。
启用接管后，CC Switch 会修改以下配置文件：
| 应用 | 配置文件 | 修改内容 |
|---|---|---|
| Claude | ~/.claude/settings.json | apiBaseUrl 指向代理 |
| Codex | ~/.codex/config.toml | [api] baseUrl 指向代理 |
| Gemini | ~/.gemini/.env | GEMINI_BASE_URL 指向代理 |
原始配置备份在 CC Switch 数据库中，停止代理时自动恢复。
代理服务器运行在接管模式下，会：
代理功能使用以下数据库表：
proxy_config - 代理配置provider_health - 供应商健康状态proxy_request_logs - 请求日志circuit_breaker_config - 熔断器配置proxy_live_backup - Live 配置备份