Windows+WSL2跨系统部署CC-Switch

原创已于 2026-06-23 17:51:14 修改 · 200 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

于 2026-06-23 17:45:48 首次发布

目标

部署一套CC-Switch代理，Windows+WSL2两套系统都能使用；而且Windows端CC-Switch有图形化界面，配置更直观。

本次使用免费的模型，Agnes.AI

Windows

注册创建API Key（https://platform.agnes-ai.com）
下载CC-Switch （https://github.com/farion1231/cc-switch/releases）
启动CC-Switch并配置自定义供应商
1. 供应商名称自定义填写，比如Agnes.AI
2. 官网链接（选填），https://agnes-ai.com
3. API Key填写第一步中创建的Key
4. 请求地址填写：https://apihub.agnes-ai.com/v1
5. API格式选择：OpenAI Chat Completions
6. 认证字段：ANTHROPIC_AUTH_TOKEN
7. 模型映射：全部填写agnes-2.0-flash，后续官网提供的模型更新了再更新该字段
8. 配置JSON中会自动生成一些字段，还需要手动添加如下字段
9. ```
{
  "allowed_openai_params": [
    "thinking",
    "context_management"
  ],
  "litellm_settings": {
    "drop_params": true
  }
}

// 允许指定的 OpenAI 参数通过。
// 自动丢弃模型不兼容的未知参数。
// 提高 Claude CLI 通过代理调用 OpenAI-Compatible API 时的兼容性。
```
10. 保存自定义供应商
配置CC-Switch路由
1. 点击左上角设置按钮，然后选择“路由”标签页
2. 使用默认的端口 15721 或者手动修改一个适合的端口
3. 打开路由总开关，打开Claude路由应用
在 CMD 中测试连通性，有数据返回则连通成功

curl http://localhost:15721/health
// 或者
curl http://127.0.0.1:15721/health

WSL2

WSL 是 Windows Subsystem for Linux 的简称，允许用户在 Windows 上运行 Linux 操作系统及其相关命令和应用程序。

WLS1：没有完整的Linux内核，它使用中间层将Linux系统调用翻译为 Windows 系统调用。
WLS2：底层是基于 Hiper-V 的轻量级、无需维护的虚拟机，运行完整的 Linux 内核。兼容性比WSL1高。

默认情况下，WSL2 和 Windows 是两套独立虚拟网卡，因此在 WSL2 中访问 127.0.0.1 是 WSL2中的网络，而不是 Windows 上的，使用不到CC-Switch的代理。

可以将 WSL2 默认的NAT网络模式改成镜像模式（Mirrored Mode），这样 WSL2 将直接使用主机的网络配置，共享相同的IP地址：

在 Windows 用户的根目录（通常是 C:\Users\<用户名>），创建一个文件名为 .wslconfig 的文本文件，内如如下

[wsl2]
networkingMode=mirrored # 开启镜像网络
firewall=true # 开启 Windows 防火墙
autoProxy=true # 开启自动同步代理，可让 WSL 自动同步 Windows 的代理设置，如果Windows使用了代理软件，这个很有用

PowerShell 中重启 WSL2
```
wsl --shutdown
```
重启 WSL后，测试连通性，有数据返回则连通成功

curl http://localhost:15721/health
// 或者
curl http://127.0.0.1:15721/health

在 WLS2 中配置 Claude Code 的配置文件，然后可以启动 claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:15721",
    "ANTHROPIC_AUTH_TOKEN": "PROXY_MANAGED",
    "ANTHROPIC_MODEL": "agnes-2.0-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODE": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "",
    "ANTHROPIC_DEFAULT_HAIKU_MODE": "",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "MAX_OUTPUT_TOKENS": 50000
  },
  "allowed_openai_params": [
    "thinking",
    "context_management"
  ],
  "litellm_settings": {
    "drop_params": true
  }
}

需要注意的配置说明：

ANTHROPIC_BASE_URL：也可以使用 http://127.0.0.1:15721，端口号必须跟CC-Switch中路由设置的端口号保持一致
ANTHROPIC_AUTH_TOKEN：PROXY_MANAGED，由CC-Switch代理统一管理后端API Key
MAX_OUTPUT_TOKENS：50000，限制最大输出token，避免上下文超限报错，Agnes-2.0-Flash 总上下文上限 262144 tokens，预留足够输入空间，如果是其他能提供更大上下文的模型，该配置可以删除

另外，假如使用镜像模式后，创建docker容器后，docker run -d -p 8080:80 nginx，通过localhost:8080无法访问，可以修改 /etc/docker/daemon.json 文件