mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-22 17:11:04 +08:00

Files

Dex Miller 0fcb1b01e2 docs: add user manual documentation (#979 )

* docs: add user manual documentation

Add comprehensive user manual covering getting started, provider management,
extensions (MCP/prompts/skills), proxy configuration, and FAQ sections.
Includes screenshots and a README index.

* fix(docs): align user manual with v3.10.3 codebase

- Add OpenCode as 4th supported app throughout all docs
- Fix proxy default port 15762 → 15721
- Update Claude presets (9 → 26), Codex (3 → 10), Gemini (3 → 7)
- Add OpenCode presets (25 entries)
- Fix timeout defaults and ranges (stream first byte 60s/90s, etc.)
- Fix circuit breaker defaults with per-app values (Claude vs general)
- Fix Skills support: all 4 apps, not just Claude/Codex
- Remove non-existent Gemini authMode field
- Fix prompt deletion behavior: enabled prompts cannot be deleted
- Remove non-existent Legacy deeplink protocol, use V1 only
- Fix DB table names (usage_logs → proxy_request_logs) and add missing tables
- Fix migration version v3.8.0 → v3.7.0
- Add missing V1 deeplink parameters (config, configFormat, etc.)
- Update doc version v3.9.1 → v3.10.3
- Add claude-opus-4-1 to pricing table
- Fix recovery wait time range 10-300 → 0-300

---------

Co-authored-by: Jason <farion1231@gmail.com>

2026-02-09 15:01:15 +08:00

2.6 KiB

Raw Blame History

5.4 环境变量冲突

功能说明

CC Switch 会自动检测系统环境变量与应用配置的冲突，避免配置被意外覆盖。

检测的环境变量：

ANTHROPIC_API_KEY - Claude API 密钥
ANTHROPIC_BASE_URL - Claude API 端点
OPENAI_API_KEY - OpenAI API 密钥
GEMINI_API_KEY - Gemini API 密钥
其他相关环境变量

冲突警告

当检测到冲突时，界面顶部会显示黄色警告横幅：

⚠️ 检测到环境变量冲突
发现 X 个环境变量可能与 CC Switch 配置冲突
[展开] [关闭]

查看冲突详情

点击「展开」按钮查看详细信息：

字段	说明
变量名	环境变量名称
变量值	当前设置的值
来源	变量的来源位置

来源类型

来源	说明
用户注册表	Windows 用户级环境变量
系统注册表	Windows 系统级环境变量
Shell 配置	macOS/Linux 的 shell 配置文件
系统环境	系统级环境变量

处理冲突

选择要删除的变量

勾选要删除的环境变量
或点击「全选」选择所有冲突变量

删除变量

点击「删除选中」按钮
确认删除操作
CC Switch 会自动备份并删除选中的变量

自动备份

删除前会自动备份：

备份位置：~/.cc-switch/env-backups/
备份格式：JSON 文件
包含变量名、值、来源等信息

忽略警告

如果确认冲突不影响使用，可以：

点击警告横幅右侧的「关闭」按钮
警告会暂时隐藏
下次启动时会重新检测

手动处理

如果不想通过 CC Switch 删除，可以手动处理：

Windows

打开「系统属性 → 高级 → 环境变量」
在用户变量或系统变量中找到冲突变量
删除或修改变量

macOS / Linux

编辑 shell 配置文件（如 ~/.zshrc、~/.bashrc）
删除或注释掉相关的 export 语句
重新加载配置：source ~/.zshrc

为什么会冲突

环境变量的优先级通常高于配置文件，可能导致：

CC Switch 设置的供应商配置被覆盖
API 请求发送到错误的端点
使用错误的 API 密钥

最佳实践

使用 CC Switch 管理配置：避免在系统环境变量中设置 API 密钥
定期检查：关注冲突警告，及时处理
备份重要变量：删除前确认已备份

恢复已删除的变量

如果误删了环境变量：

找到备份文件：~/.cc-switch/env-backups/
打开对应的 JSON 文件
手动恢复变量到系统环境

2.6 KiB Raw Blame History Unescape Escape