CC Switch 配置使用 Claude Code、Desktop 和 Codex

CC Switch 配置使用 Claude Code、Desktop 和 Codex

一、工具定位对比

这篇文章把三个工具放在不同层次来理解：

• Claude Code CLI：结对编程式终端 agent，适合复杂推理、多文件重构和实时协作

• Claude Code Desktop：和cli区别，沙箱限制，但是桌面GUI简化了上手难度、清晰的界面管理

• Codex CLI：异步执行型工具，适合明确任务、批量执行和自动化流程

• CC Switch：供应商切换管理器，负责统一管理模型和 API 提供商配置

可以把它们理解成：

• CC Switch 管配置

• Claude Code、Desktop 和 Codex 跑任务

二、前置条件

1. 安装 Node.js

Claude Code CLI、Desktop 和 Codex 依赖 Node.js 22+。

安装后建议验证：

node --version
npm --version

2. 安装 Git for Windows

Claude Code Desktop 依赖 Git。

安装完成后，建议重启终端或电脑，让环境变量生效。

三、CC Switch 安装配置

1. CC Switch 是什么

CC Switch 是 Windows 平台上的 AI 编程工具供应商切换管理器，作用是：

• 一键切换不同模型和 API 提供商

• 减少手动改环境变量的麻烦

2. 安装方式

文章建议从官方渠道下载安装包，按常规 Windows 程序安装即可。

3. 以 SiliconFlow 为例配置供应商

在 CC Switch 里创建供应商时，常见字段如下：

• 供应商名称：自定义，比如 SiliconFlow

• Base URL：https://api.siliconflow.cn/v1

• API Key：填你的密钥

• API 格式：Anthropic Messages（原生）

• 主模型：deepseek-ai/DeepSeek-V4-Pro

• Haiku 默认模型：Qwen/Qwen3.6-27B

4. 常用模型推荐

• deepseek-ai/DeepSeek-V4-Pro：日常编码，性价比高

• Qwen/Qwen3.6-27B：复杂推理任务

• deepseek-ai/DeepSeek-R1：架构设计、难题分析

四、Claude Code 安装配置

1. 安装 CLI

npm install -g @anthropic-ai/claude-code
claude --version

2. 接入第三方供应商

文章给了两种方式：

• 推荐方式：通过 CC Switch 统一管理

• 手动方式：直接设置环境变量

手动方式示例：

$env:ANTHROPIC_BASE_URL="https://api.siliconflow.cn/v1"
$env:ANTHROPIC_API_KEY="sk-你的key"
$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V4-Pro"
claude

3. 重要限制

• Claude Code CLI 对模型名限制较少

• Claude Code Desktop 的 Gateway 模式只支持 Claude 系列模型名

• 如果接的是 DeepSeek、Qwen 等第三方模型，要特别注意兼容性

4. 启动与使用建议

建议在项目目录中启动：

cd C:\workspace\你的项目
claude

常用命令包括：

• /init：创建 CLAUDE.md

• /model：查看或切换模型

• /release-notes：查看更新说明

• ?：查看快捷键

5. Windows 使用技巧

• 粘贴内容可用右键或 Ctrl+Shift+V

• 可以直接传文件路径让它分析

• 也可以直接传图片绝对路径

6. 沙箱功能

Claude Code Desktop 的沙箱功能需要 Windows 的 Virtual Machine Platform 支持。

启用命令：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

CLI 模式通常不需要这一步。

五、Claude Desktop安装配置

1. 下载并安装好Claude客户端

2. 启用开发者模式

打开软件，点击菜单的「Help」-「Troubleshooting」-「Enable Developer Mode」

3. 新建或导致cli的供应商

4. 启动与使用建议

完全退出重启一次 Claude 桌面端，就可以使用了！

六、Codex CLI 安装配置

1. 安装

npm install -g @openai/codex
codex --version

2. 接入第三方供应商

Codex 的配置文件位置通常是：

%USERPROFILE%\.codex\config.toml

文章指出，Codex 新版更偏向 Responses API，不再支持旧的 chat 方式。

3. 推荐方案：OpenRouter

由于部分供应商不支持 Responses API，文章推荐使用 OpenRouter 作为中转。

示例配置思路：

[providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"
wire_api = "responses"

再设置环境变量：

$env:OPENROUTER_API_KEY="sk-or-你的key"
codex

七、工具选择建议

• 日常编码 + 省钱：Claude Code CLI + SiliconFlow

• 复杂任务 + 质量优先：Claude Code CLI + Claude 官方

• 批量任务 + 自动 PR：Codex + OpenRouter

• IDEA 内使用：Claude Code JetBrains 插件

文章最后的意思是：

• CC Switch 负责统一配置

• Claude Code 负责复杂交互和协作

• Codex 负责批量明确任务

八、常见问题

1. wire_api = chat is no longer supported

原因：

• Codex 新版强制使用 Responses API

处理思路：

• 改用 OpenRouter

• 或降级 Codex

• 或改用 Claude Code CLI

2. configured model is not an Anthropic model

原因：

• Desktop Gateway 模式只接受 claude-* 类型模型名

处理思路：

• 改用 Claude Code CLI

• 或换支持 Claude 模型的供应商

3. Failed to install Anthropic marketplace

原因：

• 国内网络可能无法访问 Anthropic 插件市场

处理思路：

• 先忽略，不一定影响正常使用

4. 一直转圈

原因：

• 供应商不支持当前 API 格式

处理思路：

• 回到 CC Switch 检查 API 格式

• 或更换支持对应协议的供应商

5. npm 安装慢

可以临时加镜像源：

--registry https://registry.npmmirror.com

九、总结

这篇文章的核心不是单讲某一个工具，而是讲一套组合思路：

• CC Switch 用来统一管理供应商和模型

• Claude Code 用来做交互式编程

• Codex 用来做批量和自动化任务

如果你想少踩坑，推荐先跑通：

1. Node.js

2. Git

3. CC Switch

4. Claude Code CLI

5. Codex