CC Switch 代理服务详解本地 HTTP 代理的启动、配置、接管与故障转移实战【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇技术指南基于 CC Switch跨平台 Claude Code / Codex / OpenCode / OpenClaw / Grok Build / Hermes Agent 一体化桌面助手官方用户手册的「4.1 代理服务」章节整理并结合src-tauri/src/proxy/目录下的 Rust 源码实现进行纵深解读。你将完整掌握如何在主界面或设置页启动/停止本地代理、监听地址与端口等核心配置的默认值与修改流程、代理面板各项运行状态服务地址、当前供应商、统计指标、故障转移队列的含义以及请求转发、应用配置接管、API 格式转换、日志记录等底层工作原理与常见问题排查方法。一、功能说明代理服务是什么代理服务在本地启动一个 HTTP 代理所有 API 请求都通过该代理转发。从源码实现看代理服务器基于 Axum 框架构建见 server.rs 头部模块注释「基于Axum的HTTP服务器处理代理请求」运行在独立 tokio 任务中通过TcpListener绑定用户配置的listen_address:listen_port组合。主要用途记录请求日志统计 API 用量支持故障转移集中管理多个应用的请求Claude / Codex / Gemini / Grok Build 等代理的核心状态由 ProxyState 结构体持有包含数据库句柄、代理配置ProxyConfig、运行状态ProxyStatus、各应用当前供应商映射、共享的ProviderRouter持有熔断器状态跨请求保持、以及故障转移切换管理器FailoverSwitchManager等这些组件共同支撑了后文介绍的统计与故障转移能力。二、启动代理方式一主界面开关点击主界面顶部的代理开关按钮。开关状态白色代理未运行绿色代理运行中对应的 UI 组件为 ProxyToggle.tsx开关状态与后端通过 useProxyStatus.ts 中的 Tauri 事件保持同步。方式二设置页面打开「设置 → 高级 → 代理服务」点击右上角的开关三、代理配置3.1 基础配置配置项说明默认值监听地址代理绑定的 IP 地址127.0.0.1监听端口代理监听的端口15721启用日志是否记录请求日志开启这三个默认值可以直接在后端配置结构体中得到印证。types.rs 中ProxyConfig::default()的定义为impl Default for ProxyConfig { fn default() - Self { Self { listen_address: 127.0.0.1.to_string(), listen_port: 15721, // 使用较少占用的高位端口 max_retries: 3, request_timeout: 600, enable_logging: true, live_takeover_active: false, streaming_first_byte_timeout: 60, streaming_idle_timeout: 120, non_streaming_timeout: 600, } } }除用户手册列出的三项基础配置外从源码结构看ProxyConfig还包含若干超时类参数它们直接影响长对话与流式请求的稳定性参数说明默认值 / 范围max_retries最大重试次数3streaming_first_byte_timeout流式首字超时秒——等待首个数据块的最大时间60秒范围 1–120streaming_idle_timeout流式静默超时秒——两个数据块之间的最大间隔填 0 禁用防止中途卡住120秒范围 60–600non_streaming_timeout非流式总超时秒——非流式请求的总超时时间600秒范围 60–1200字段注释来自 types.rs 第 9–27 行。3.2 修改配置停止代理服务必须先停止修改监听地址或端口点击「保存」重新启动代理⚠️ 修改地址/端口需要先停止代理服务。这一约束与源码实现一致ProxyServer::start 在启动时会检查是否已在运行shutdown_tx是否已有值若已运行则直接返回ProxyError::AlreadyRunning错误因此无法在运行中换绑端口。而运行时配置如超时、日志开关可以通过 apply_runtime_config 在不重启服务的情况下热更新——「地址/端口需重启、其余可热更」正是文档建议先停止再修改的底层原因。3.3 监听地址说明地址说明127.0.0.1仅本机可访问推荐0.0.0.0允许局域网访问绑定动作发生在start()中先拼接listen_address:listen_port解析为SocketAddr再调用tokio::net::TcpListener::bind(addr)见 server.rs 第 100–117 行。绑定失败会抛出ProxyError::BindFailed即「常见问题」中提到的Address already in use错误的来源。四、运行状态代理运行时面板显示以下信息前端实现见 ProxyPanel.tsx。4.1 服务地址http://127.0.0.1:15721点击「复制」按钮可复制地址。该地址由ProxyServerInfo中的address与port拼接而成启动成功后还会通过set_proxy_port(actual_port)写入全局代理端口用于系统代理检测server.rs 第 122–123 行。4.2 当前供应商显示各应用当前使用的供应商Claude: PackyCode Codex: AIGoCode Gemini: Google 官方从源码看这一信息由ProxyState.current_providersapp_type - (provider_id, provider_name)映射提供get_status()会将其转换为active_targets列表返回给前端server.rs 第 257–277 行。代码注释特别指出set_active_target()表示的是该应用类型当前的「目标供应商」用于 UI 展示「不代表该供应商一定已经处理过请求而是用于热切换/启用故障转移立即切 P1 等场景下让 UI 能立刻反映最新目标」。4.3 统计数据指标说明活跃连接当前正在处理的请求数总请求数启动以来的总请求数成功率请求成功的百分比90% 绿色≤90% 黄色运行时间代理已运行的时长这些指标与 ProxyStatus 结构体一一对应active_connections活跃连接数、total_requests总请求数、success_requests/failed_requests/success_rate成功率 0–100、uptime_seconds运行时间秒数由start_time的Instant计算此外还有文档未展开的failover_count故障转移次数、last_request_at、last_error等字段可供排障参考。4.4 故障转移队列代理面板会按应用类型显示故障转移队列Claude ├── 1. PackyCode [当前使用] ● ├── 2. AIGoCode ● └── 3. 备用供应商 ○ Codex ├── 1. AIGoCode [当前使用] ● └── 2. 备用供应商 ●队列说明数字表示优先级顺序「当前使用」标签表示正在使用的供应商健康徽章显示供应商状态绿色健康连续失败 0 次黄色降级连续失败 1–2 次红色不健康连续失败 ≥3 次队列与健康状态由ProviderRouterprovider_router.rs与熔断器 circuit_breaker.rs 共同支撑。每个供应商对应一个CircuitBreaker实例采用经典三态模型Closed正常、Open熔断激活拒绝请求、HalfOpen尝试恢复允许部分请求通过。其默认阈值为CircuitBreakerConfig::defaultfailure_threshold: 4, // 连续失败 4 次后打开熔断器 success_threshold: 2, // 半开状态下成功 2 次后关闭熔断器 timeout_seconds: 60, // 熔断打开 60 秒后尝试半开 error_rate_threshold: 0.6, // 错误率超过 60% 时打开熔断器 min_requests: 10, // 计算错误率前的最小请求数面板上的健康徽章读取的是 ProviderHealth 中的consecutive_failures字段按「0 / 1–2 / ≥3 次」三档映射为绿、黄、红三色。这些熔断参数均可在应用级代理配置AppProxyConfig的circuit_failure_threshold、circuit_success_threshold等字段中调整并通过update_circuit_breaker_configs热更新到所有已创建的熔断器实例server.rs 第 386–405 行。五、工作原理5.1 请求流程具体到路由层面代理为不同 CLI 暴露了覆盖多种协议前缀的端点build_router端点用途GET /health、GET /status健康检查与状态查询POST /v1/messages、POST /claude/v1/messagesClaude APIAnthropic MessagesPOST /chat/completions、POST /v1/chat/completions、POST /codex/v1/chat/completions等OpenAI Chat CompletionsCodex CLIGET /models、GET /v1/modelsOpenAI ModelsCodex CLI 连通性检查POST /responses、POST /v1/responses、POST /codex/v1/responses等OpenAI Responses APICodex CLIPOST /responses/compact含各前缀别名OpenAI Responses Compact远程压缩透传any /v1beta/*path、any /gemini/v1beta/*path、any /gemini/v1/*pathGemini API用any覆盖全部 HTTP 方法确保 GET 类只读端点也进入代理统计与整流链路路由上还显式设置了DefaultBodyLimit::max(200 * 1024 * 1024)将默认请求体上限提高到 200 MB避免大上下文请求触发 413 Payload Too Large。此外服务器采用手动 hyper HTTP/1.1 accept 循环并开启preserve_header_case(true)通过先 peek 原始 TCP 字节捕获请求头的原始大小写server.rs 第 138–208 行使转发到上游的请求头在 wire 层面与直连请求保持一致——这是保证各供应商鉴权头如x-api-key、Authorization不被意外小写化而失效的关键细节。5.2 应用配置接管Live Takeover启动代理并开启应用接管后CC Switch 会改写各应用的配置使其指向本地代理Claude改写 settings 中的环境变量{ env: { ANTHROPIC_BASE_URL: http://127.0.0.1:15721 } }Codex改写 TOML 配置base_url http://127.0.0.1:15721/v1Gemini改写环境变量GOOGLE_GEMINI_BASE_URLhttp://127.0.0.1:15721从源码结构看接管状态由 ProxyTakeoverStatus 逐应用跟踪claude/codex/gemini/grokbuild/opencode/openclaw各自的 bool 位改写前的原始配置会存入LiveBackup备份记录含app_type、original_config、backed_up_at这正是「停止代理时恢复应用配置到原始状态」能够可靠完成的数据基础。接管逻辑的完整实现集中在 services/proxy.rs 中。六、API 格式转换代理支持为配置了非 Anthropic 格式的供应商自动进行 API 格式转换。这使你可以将仅支持 OpenAI 兼容 API 的供应商用于 Claude Code。供应商 API 格式代理行为Anthropic Messages透传不转换OpenAI Chat Completions将 Anthropic 请求转换为 OpenAI Chat 格式响应反向转换OpenAI Responses API将 Anthropic 请求转换为 OpenAI Responses 格式响应反向转换API 格式在添加或编辑 Claude 供应商时于高级选项中按供应商配置。注意格式转换需要代理运行并启用应用接管。转换同时支持流式和非流式请求。格式转换的实现分布在 providers/ 目录如 transform_codex_anthropic.rsAnthropic → Codex、transform_responses.rsAnthropic → OpenAI Responses、transform_codex_chat.rsAnthropic → OpenAI Chat配套streaming_*系列文件处理流式响应的反向转换供应商元数据中的api_format字段取值如anthropic/openai_chat/openai_responses决定了请求进入哪条转换链路。七、停止代理7.1 方式一主界面开关点击代理开关按钮关闭。7.2 方式二设置页面在代理服务面板中关闭开关。7.3 停止后的处理停止代理时CC Switch 会恢复应用配置到原始状态基于第五节提到的LiveBackup备份保存请求日志关闭所有连接源码层面ProxyServer::stop 的流程是先通过 oneshot 通道发送关闭信号终止 accept 循环再等待服务器任务真正结束并带有 5 秒超时保护——超时则记录StopTimeout警告并强制继续确保 UI 操作不会被卡死的连接阻塞。八、日志记录8.1 开启日志在代理面板中开启「启用日志」开关即ProxyConfig.enable_logging默认true。8.2 日志内容每条请求记录包含字段说明时间请求时间应用Claude / Codex / Gemini供应商使用的供应商模型请求的模型Token输入/输出 token 数延迟请求耗时状态成功/失败请求日志的写入与用量计算由 usage/ 模块完成logger.rs 负责落库parser.rs 解析响应中的 token 用量calculator.rs 计算成本统计。8.3 查看日志在「设置 → 用量」Tab 中查看请求日志前端表格组件为 RequestLogTable.tsx支持按时间范围等条件筛选配合 UsageDashboard.tsx 提供整体用量视图。九、常见问题9.1 端口被占用错误信息Address already in use解决方法更换端口如 5001或关闭占用端口的程序该错误由TcpListener::bind失败触发包装为ProxyError::BindFailedserver.rs 第 112–117 行。注意换端口后需按「三、修改配置」的流程操作先停止代理再改端口。9.2 代理启动失败检查端口是否被占用是否有足够权限防火墙是否阻止9.3 请求超时可能原因网络问题供应商服务器问题代理配置错误解决方法检查网络连接尝试直接访问供应商 API检查供应商配置排查超时时可结合第三节列出的三个超时参数流式首字 60 秒 / 流式静默 120 秒 / 非流式 600 秒判断属于哪一类超时首字超时通常意味着上游长时间无响应流式静默超时说明响应中途断流非流式超时则多为供应商侧整体响应过慢。同时可观察面板成功率与供应商健康徽章若某供应商连续失败达到熔断阈值默认连续失败 4 次熔断器会切到 Open 状态并触发故障转移队列切换。十、延伸阅读围绕本地代理仓库中还有以下相关文档与源码可继续深入路由与多应用配置docs/user-manual/zh/4-proxy/4.2-routing.md故障转移机制详解docs/user-manual/zh/4-proxy/4.3-failover.md用量统计docs/user-manual/zh/4-proxy/4.4-usage.md代理路由综合指南docs/guides/proxy-guide-zh.md全局代理设置前端组件GlobalProxySettings.tsx各供应商协议适配层providers/mod.rs【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CC Switch 代理服务详解：本地 HTTP 代理的启动、配置、接管与故障转移实战
CC Switch 代理服务详解本地 HTTP 代理的启动、配置、接管与故障转移实战【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本篇技术指南基于 CC Switch跨平台 Claude Code / Codex / OpenCode / OpenClaw / Grok Build / Hermes Agent 一体化桌面助手官方用户手册的「4.1 代理服务」章节整理并结合src-tauri/src/proxy/目录下的 Rust 源码实现进行纵深解读。你将完整掌握如何在主界面或设置页启动/停止本地代理、监听地址与端口等核心配置的默认值与修改流程、代理面板各项运行状态服务地址、当前供应商、统计指标、故障转移队列的含义以及请求转发、应用配置接管、API 格式转换、日志记录等底层工作原理与常见问题排查方法。一、功能说明代理服务是什么代理服务在本地启动一个 HTTP 代理所有 API 请求都通过该代理转发。从源码实现看代理服务器基于 Axum 框架构建见 server.rs 头部模块注释「基于Axum的HTTP服务器处理代理请求」运行在独立 tokio 任务中通过TcpListener绑定用户配置的listen_address:listen_port组合。主要用途记录请求日志统计 API 用量支持故障转移集中管理多个应用的请求Claude / Codex / Gemini / Grok Build 等代理的核心状态由 ProxyState 结构体持有包含数据库句柄、代理配置ProxyConfig、运行状态ProxyStatus、各应用当前供应商映射、共享的ProviderRouter持有熔断器状态跨请求保持、以及故障转移切换管理器FailoverSwitchManager等这些组件共同支撑了后文介绍的统计与故障转移能力。二、启动代理方式一主界面开关点击主界面顶部的代理开关按钮。开关状态白色代理未运行绿色代理运行中对应的 UI 组件为 ProxyToggle.tsx开关状态与后端通过 useProxyStatus.ts 中的 Tauri 事件保持同步。方式二设置页面打开「设置 → 高级 → 代理服务」点击右上角的开关三、代理配置3.1 基础配置配置项说明默认值监听地址代理绑定的 IP 地址127.0.0.1监听端口代理监听的端口15721启用日志是否记录请求日志开启这三个默认值可以直接在后端配置结构体中得到印证。types.rs 中ProxyConfig::default()的定义为impl Default for ProxyConfig { fn default() - Self { Self { listen_address: 127.0.0.1.to_string(), listen_port: 15721, // 使用较少占用的高位端口 max_retries: 3, request_timeout: 600, enable_logging: true, live_takeover_active: false, streaming_first_byte_timeout: 60, streaming_idle_timeout: 120, non_streaming_timeout: 600, } } }除用户手册列出的三项基础配置外从源码结构看ProxyConfig还包含若干超时类参数它们直接影响长对话与流式请求的稳定性参数说明默认值 / 范围max_retries最大重试次数3streaming_first_byte_timeout流式首字超时秒——等待首个数据块的最大时间60秒范围 1–120streaming_idle_timeout流式静默超时秒——两个数据块之间的最大间隔填 0 禁用防止中途卡住120秒范围 60–600non_streaming_timeout非流式总超时秒——非流式请求的总超时时间600秒范围 60–1200字段注释来自 types.rs 第 9–27 行。3.2 修改配置停止代理服务必须先停止修改监听地址或端口点击「保存」重新启动代理⚠️ 修改地址/端口需要先停止代理服务。这一约束与源码实现一致ProxyServer::start 在启动时会检查是否已在运行shutdown_tx是否已有值若已运行则直接返回ProxyError::AlreadyRunning错误因此无法在运行中换绑端口。而运行时配置如超时、日志开关可以通过 apply_runtime_config 在不重启服务的情况下热更新——「地址/端口需重启、其余可热更」正是文档建议先停止再修改的底层原因。3.3 监听地址说明地址说明127.0.0.1仅本机可访问推荐0.0.0.0允许局域网访问绑定动作发生在start()中先拼接listen_address:listen_port解析为SocketAddr再调用tokio::net::TcpListener::bind(addr)见 server.rs 第 100–117 行。绑定失败会抛出ProxyError::BindFailed即「常见问题」中提到的Address already in use错误的来源。四、运行状态代理运行时面板显示以下信息前端实现见 ProxyPanel.tsx。4.1 服务地址http://127.0.0.1:15721点击「复制」按钮可复制地址。该地址由ProxyServerInfo中的address与port拼接而成启动成功后还会通过set_proxy_port(actual_port)写入全局代理端口用于系统代理检测server.rs 第 122–123 行。4.2 当前供应商显示各应用当前使用的供应商Claude: PackyCode Codex: AIGoCode Gemini: Google 官方从源码看这一信息由ProxyState.current_providersapp_type - (provider_id, provider_name)映射提供get_status()会将其转换为active_targets列表返回给前端server.rs 第 257–277 行。代码注释特别指出set_active_target()表示的是该应用类型当前的「目标供应商」用于 UI 展示「不代表该供应商一定已经处理过请求而是用于热切换/启用故障转移立即切 P1 等场景下让 UI 能立刻反映最新目标」。4.3 统计数据指标说明活跃连接当前正在处理的请求数总请求数启动以来的总请求数成功率请求成功的百分比90% 绿色≤90% 黄色运行时间代理已运行的时长这些指标与 ProxyStatus 结构体一一对应active_connections活跃连接数、total_requests总请求数、success_requests/failed_requests/success_rate成功率 0–100、uptime_seconds运行时间秒数由start_time的Instant计算此外还有文档未展开的failover_count故障转移次数、last_request_at、last_error等字段可供排障参考。4.4 故障转移队列代理面板会按应用类型显示故障转移队列Claude ├── 1. PackyCode [当前使用] ● ├── 2. AIGoCode ● └── 3. 备用供应商 ○ Codex ├── 1. AIGoCode [当前使用] ● └── 2. 备用供应商 ●队列说明数字表示优先级顺序「当前使用」标签表示正在使用的供应商健康徽章显示供应商状态绿色健康连续失败 0 次黄色降级连续失败 1–2 次红色不健康连续失败 ≥3 次队列与健康状态由ProviderRouterprovider_router.rs与熔断器 circuit_breaker.rs 共同支撑。每个供应商对应一个CircuitBreaker实例采用经典三态模型Closed正常、Open熔断激活拒绝请求、HalfOpen尝试恢复允许部分请求通过。其默认阈值为CircuitBreakerConfig::defaultfailure_threshold: 4, // 连续失败 4 次后打开熔断器 success_threshold: 2, // 半开状态下成功 2 次后关闭熔断器 timeout_seconds: 60, // 熔断打开 60 秒后尝试半开 error_rate_threshold: 0.6, // 错误率超过 60% 时打开熔断器 min_requests: 10, // 计算错误率前的最小请求数面板上的健康徽章读取的是 ProviderHealth 中的consecutive_failures字段按「0 / 1–2 / ≥3 次」三档映射为绿、黄、红三色。这些熔断参数均可在应用级代理配置AppProxyConfig的circuit_failure_threshold、circuit_success_threshold等字段中调整并通过update_circuit_breaker_configs热更新到所有已创建的熔断器实例server.rs 第 386–405 行。五、工作原理5.1 请求流程具体到路由层面代理为不同 CLI 暴露了覆盖多种协议前缀的端点build_router端点用途GET /health、GET /status健康检查与状态查询POST /v1/messages、POST /claude/v1/messagesClaude APIAnthropic MessagesPOST /chat/completions、POST /v1/chat/completions、POST /codex/v1/chat/completions等OpenAI Chat CompletionsCodex CLIGET /models、GET /v1/modelsOpenAI ModelsCodex CLI 连通性检查POST /responses、POST /v1/responses、POST /codex/v1/responses等OpenAI Responses APICodex CLIPOST /responses/compact含各前缀别名OpenAI Responses Compact远程压缩透传any /v1beta/*path、any /gemini/v1beta/*path、any /gemini/v1/*pathGemini API用any覆盖全部 HTTP 方法确保 GET 类只读端点也进入代理统计与整流链路路由上还显式设置了DefaultBodyLimit::max(200 * 1024 * 1024)将默认请求体上限提高到 200 MB避免大上下文请求触发 413 Payload Too Large。此外服务器采用手动 hyper HTTP/1.1 accept 循环并开启preserve_header_case(true)通过先 peek 原始 TCP 字节捕获请求头的原始大小写server.rs 第 138–208 行使转发到上游的请求头在 wire 层面与直连请求保持一致——这是保证各供应商鉴权头如x-api-key、Authorization不被意外小写化而失效的关键细节。5.2 应用配置接管Live Takeover启动代理并开启应用接管后CC Switch 会改写各应用的配置使其指向本地代理Claude改写 settings 中的环境变量{ env: { ANTHROPIC_BASE_URL: http://127.0.0.1:15721 } }Codex改写 TOML 配置base_url http://127.0.0.1:15721/v1Gemini改写环境变量GOOGLE_GEMINI_BASE_URLhttp://127.0.0.1:15721从源码结构看接管状态由 ProxyTakeoverStatus 逐应用跟踪claude/codex/gemini/grokbuild/opencode/openclaw各自的 bool 位改写前的原始配置会存入LiveBackup备份记录含app_type、original_config、backed_up_at这正是「停止代理时恢复应用配置到原始状态」能够可靠完成的数据基础。接管逻辑的完整实现集中在 services/proxy.rs 中。六、API 格式转换代理支持为配置了非 Anthropic 格式的供应商自动进行 API 格式转换。这使你可以将仅支持 OpenAI 兼容 API 的供应商用于 Claude Code。供应商 API 格式代理行为Anthropic Messages透传不转换OpenAI Chat Completions将 Anthropic 请求转换为 OpenAI Chat 格式响应反向转换OpenAI Responses API将 Anthropic 请求转换为 OpenAI Responses 格式响应反向转换API 格式在添加或编辑 Claude 供应商时于高级选项中按供应商配置。注意格式转换需要代理运行并启用应用接管。转换同时支持流式和非流式请求。格式转换的实现分布在 providers/ 目录如 transform_codex_anthropic.rsAnthropic → Codex、transform_responses.rsAnthropic → OpenAI Responses、transform_codex_chat.rsAnthropic → OpenAI Chat配套streaming_*系列文件处理流式响应的反向转换供应商元数据中的api_format字段取值如anthropic/openai_chat/openai_responses决定了请求进入哪条转换链路。七、停止代理7.1 方式一主界面开关点击代理开关按钮关闭。7.2 方式二设置页面在代理服务面板中关闭开关。7.3 停止后的处理停止代理时CC Switch 会恢复应用配置到原始状态基于第五节提到的LiveBackup备份保存请求日志关闭所有连接源码层面ProxyServer::stop 的流程是先通过 oneshot 通道发送关闭信号终止 accept 循环再等待服务器任务真正结束并带有 5 秒超时保护——超时则记录StopTimeout警告并强制继续确保 UI 操作不会被卡死的连接阻塞。八、日志记录8.1 开启日志在代理面板中开启「启用日志」开关即ProxyConfig.enable_logging默认true。8.2 日志内容每条请求记录包含字段说明时间请求时间应用Claude / Codex / Gemini供应商使用的供应商模型请求的模型Token输入/输出 token 数延迟请求耗时状态成功/失败请求日志的写入与用量计算由 usage/ 模块完成logger.rs 负责落库parser.rs 解析响应中的 token 用量calculator.rs 计算成本统计。8.3 查看日志在「设置 → 用量」Tab 中查看请求日志前端表格组件为 RequestLogTable.tsx支持按时间范围等条件筛选配合 UsageDashboard.tsx 提供整体用量视图。九、常见问题9.1 端口被占用错误信息Address already in use解决方法更换端口如 5001或关闭占用端口的程序该错误由TcpListener::bind失败触发包装为ProxyError::BindFailedserver.rs 第 112–117 行。注意换端口后需按「三、修改配置」的流程操作先停止代理再改端口。9.2 代理启动失败检查端口是否被占用是否有足够权限防火墙是否阻止9.3 请求超时可能原因网络问题供应商服务器问题代理配置错误解决方法检查网络连接尝试直接访问供应商 API检查供应商配置排查超时时可结合第三节列出的三个超时参数流式首字 60 秒 / 流式静默 120 秒 / 非流式 600 秒判断属于哪一类超时首字超时通常意味着上游长时间无响应流式静默超时说明响应中途断流非流式超时则多为供应商侧整体响应过慢。同时可观察面板成功率与供应商健康徽章若某供应商连续失败达到熔断阈值默认连续失败 4 次熔断器会切到 Open 状态并触发故障转移队列切换。十、延伸阅读围绕本地代理仓库中还有以下相关文档与源码可继续深入路由与多应用配置docs/user-manual/zh/4-proxy/4.2-routing.md故障转移机制详解docs/user-manual/zh/4-proxy/4.3-failover.md用量统计docs/user-manual/zh/4-proxy/4.4-usage.md代理路由综合指南docs/guides/proxy-guide-zh.md全局代理设置前端组件GlobalProxySettings.tsx各供应商协议适配层providers/mod.rs【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考