Claude Code + CC Switch 使用指南

从零开始，在 Windows 上安装 Claude Code，通过 CC Switch 接入国产模型

一、核心概念

1.1 Claude Code 是什么

Claude Code 是 Anthropic 推出的 AI 编程 Agent 框架。它可以：

• 读取项目文件

• 分析代码结构

• 生成和修改代码

• 执行命令

• 自主决定工作流程

关键理解：Claude Code 是"外壳"，需要接入"大脑"（大语言模型）才能工作。

1.2 CC Switch 是什么

CC Switch（Claude Code Switch）是给 Claude Code 换大脑的图形化工具：

• 添加任意兼容 OpenAI API 格式的模型

• 一键切换当前 Claude Code 使用的模型

• 管理多个 API Key 和模型配置

一句话：CC Switch = 给 Claude Code 换大脑的遥控器

1.3 为什么需要 CC Switch

原版 Claude Code 默认搭配官方 Claude 模型，国内用户很难直接使用。通过 CC Switch，可以给 Claude Code 换上国内能直接调用的模型（智谱 GLM、MiniMax、Kimi、DeepSeek 等），无需外国手机号、无需特殊网络、无需 Visa 卡。

二、安装 Claude Code

2.1 方式一：官方脚本安装（推荐）

# 在 PowerShell 中执行
irm https://claude.ai/install.ps1 | iex

2.2 方式二：winget 安装

winget install Anthropic.ClaudeCode

2.3 方式三：npm 安装

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

2.4 验证安装

claude --version

看到版本号即成功。如果提示「claude 不是可识别的命令」，关闭终端重新打开再试。

三、安装 CC Switch

3.1 下载安装包

访问 GitHub Releases：

https://github.com/farion1231/cc-switch/releases

下载对应平台的安装包：

3.2 安装

双击安装包，一路 Next 完成安装。

四、获取 API Key

以 DeepSeek 为例（其他平台类似）：

1. 访问 platform.deepseek.co...

2. 注册账号并登录

3. 进入「API Keys」页面

4. 点击「创建 API Key」

5. 复制生成的 Key（形如 sk-xxxxxxxxxxxxxxxx）

其他可选平台：

• 智谱 AI（GLM）：open.bigmodel.cn

• MiniMax：platform.minimaxi.co...

• Kimi（Moonshot）：platform.moonshot.cn

• 硅基流动：cloud.siliconflow.cn

五、CC Switch 配置详解

5.1 打开 CC Switch

在开始菜单找到 CC Switch 并打开。

5.2 添加 Provider

点击「添加 Provider」→ 选择「OpenAI Compatible」

5.3 填写配置

5.4 常用模型配置参考

DeepSeek：

Base URL: https://api.deepseek.com/v1
模型: deepseek-chat / deepseek-coder

智谱 GLM：

Base URL: https://open.bigmodel.cn/api/paas/v4
模型: glm-5.1 / glm-4-plus

硅基流动（多模型聚合）：

Base URL: https://api.siliconflow.cn/v1
模型: deepseek-ai/DeepSeek-V3 / Qwen/Qwen2.5-72B

5.5 激活配置

配置完成后，点击「激活」按钮，CC Switch 会自动修改 Claude Code 的配置文件，使其使用你设置的模型。

六、启动 Claude Code

6.1 在项目目录中启动

# 进入你的项目文件夹
cd D:\projects\my-project

# 启动 Claude Code
claude

⚠️ 重要：不要在电脑根目录（如 `C:`）启动，信息量太大容易导致分析变慢、误操作。为每个项目建独立文件夹，cd 进去再启动。

6.2 首次启动配置

首次启动会提示：

1. 选择主题（Dark mode / Light mode）

2. 登录验证（如果接的是国产模型，CC Switch 已处理，直接回车）

3. 进入交互界面

七、CLAUDE.md 配置（推荐）

CLAUDE.md 是 Claude Code 的配置文件，用来设定协作规则。

7.1 全局配置

文件位置：

Windows: %USERPROFILE%\.claude\CLAUDE.md
macOS/Linux: ~/.claude/CLAUDE.md

7.2 项目级配置

在项目根目录创建 CLAUDE.md：

my-project/
├── src/
├── CLAUDE.md      ← 项目级配置
└── ...

7.3 配置示例

# 协作规则

## 语言
- 所有回复使用中文
- 代码注释使用英文

## 安全
- 删除文件前必须确认
- 修改配置文件前必须确认
- 执行危险命令前必须确认

## 代码风格
- 使用 4 空格缩进
- 函数命名使用 camelCase
- 类命名使用 PascalCase

## 项目结构
- 源代码放在 src/ 目录
- 测试文件放在 tests/ 目录
- 文档放在 docs/ 目录

八、常用操作

8.1 基本命令

8.2 文件操作

@file src/main.py      # 引用特定文件
@directory src/        # 引用整个目录
@git diff              # 查看 Git 变更

8.3 常用提示词

"帮我分析一下这个项目的架构"
"给这个函数加上单元测试"
"把这段代码重构得更简洁"
"解释一下这个报错的原因"
"帮我生成一个 REST API 接口"

九、CC Switch 高级功能

9.1 多 Provider 管理

可以同时配置多个平台的 API，随时切换：

• Provider A：DeepSeek（便宜量大）

• Provider B：智谱 GLM（中文优化）

• Provider C：官方 Claude（需要时切换）

9.2 用量统计

CC Switch 提供使用量分析，帮助你监控 API 调用和费用。

9.3 会话管理

• 历史会话记录

• 会话收藏

• 消息导出

十、常见问题

十一、相关资源

提示：模型会不断迭代更新，但好的 Agent 框架是更持久的基础设施。掌握 Claude Code + CC Switch 的组合，无论底层模型如何变化，你都能快速适配。