2026 最新 Claude Code 本地部署教程（CC Switch + Ollama）

🚀 2026 最新 Claude Code 本地部署教程（CC Switch + Ollama）

⚡ 完全免费
⚡ 无需 Claude API
⚡ 本地运行 AI 编程助手
⚡ 支持 Windows / macOS / Linux
⚡ 支持 DeepSeek / Qwen / Gemma / GLM

🌟 什么是 Claude Code？

Claude Code 是 Anthropic 推出的 AI 编程 Agent。

它和普通 AI 最大区别：

✅ 能读取整个项目
✅ 能自动修改代码
✅ 能执行终端命令
✅ 能自动修复报错
✅ 能安装依赖
✅ 能理解大型工程

它更像：

1
AI + IDE + Terminal

而不是普通聊天机器人。

🧠 本地部署原理

整个链路：

1
2
3
4
5
6
7
Claude Code
      ↓
CC Switch（中间转发层）
      ↓
Ollama（本地模型）
      ↓
DeepSeek / Qwen / Gemma 等模型

简单理解：

  • Claude Code 负责 AI Agent 工作流
  • CC Switch 负责“骗过” Claude
  • Ollama 负责本地运行大模型

最终效果：

1
2
3
不用 Claude API
不用持续花钱
全部本地运行

⚡ 这套方案的优势

功能 支持
本地运行 ✅
无 API ✅
免费 ✅
AI 编程 ✅
自动修 Bug ✅
文件修改 ✅
终端执行 ✅

💻 系统要求

Windows

推荐：

1
Windows 10 / 11

macOS

推荐：

1
macOS 13+

Linux

推荐：

1
Ubuntu 22+

🖥️ 推荐配置

配置 最低
内存 8GB
推荐 16GB
显卡 RTX 2060+
硬盘 20GB+

📦 第一步：安装 Node.js

官网：

1
https://nodejs.org

下载安装：

1
LTS 版本

安装完成后验证：

1
2
node -v
npm -v

出现版本号即可。

📦 第二步：安装 Git

官网：

1
https://git-scm.com

安装完成验证：

1
git --version

🤖 第三步：安装 Ollama

Ollama 是本地模型运行器。

官网：

1
https://ollama.com

下载安装即可。

⚡ 第四步：测试 Ollama

打开终端：

1
ollama --version

如果显示版本号：

1
安装成功

🧠 第五步：下载本地模型

推荐模型：

模型 推荐指数
Qwen3 ⭐⭐⭐⭐⭐
DeepSeek R1 ⭐⭐⭐⭐⭐
Gemma 4 ⭐⭐⭐⭐
GLM ⭐⭐⭐⭐

下载 Qwen3

1
ollama run qwen3

下载 DeepSeek

1
ollama run deepseek-r1

⚡ 第六步：安装 Claude Code

管理员终端执行：

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

安装完成后：

1
claude --version

如果显示版本：

1
Claude Code 安装成功

🔥 第七步：首次运行 Claude Code

输入：

1
claude

会弹出：

1
登录验证

这里先不用登录。

🧩 第八步：修改配置文件

进入：

1
C:\Users\你的用户名\

找到：

1
.claude.json

如果没有：

1
自己创建

⚡ 添加以下内容

1
2
3
{
  "hasCompletedOnboarding": true
}

保存即可。

🚀 第九步：安装 CC Switch

CC Switch 是核心中间件。

GitHub：

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

下载最新版：

1
cc-switch-setup.exe

安装即可。

🧠 第十步：启动 Ollama 服务

打开终端：

1
ollama serve

默认地址：

1
http://127.0.0.1:11434

⚡ 第十一步：配置 CC Switch

打开：

1
CC Switch

点击：

1
+

添加模型。

🔧 配置如下

API 地址

1
http://127.0.0.1:11434/v1

API 类型

1
OpenAI Chat Completions

API KEY

随便填写：

1
sk-local

模型名称

例如：

1
qwen3

或者：

1
deepseek-r1

⚡ 第十二步：Claude Code 接入本地模型

继续编辑：

1
.claude.json

添加：

1
2
3
4
{
  "hasCompletedOnboarding": true,
  "inferenceModels": "[\"haiku\",\"sonnet\",\"opus\"]"
}

🚀 第十三步：重新启动 Claude Code

输入：

1
claude

现在：

Claude Code 会认为：

1
自己正在调用 Claude

但实际上：

1
请求已经被 CC Switch 转发到本地 Ollama

🎉 部署完成

现在你已经拥有：

✅ 本地 AI 编程 Agent
✅ 免费无限使用
✅ 自动修改代码
✅ 自动分析项目
✅ 自动修复 Bug

⚡ Claude Code 能做什么？

💻 自动写代码

例如：

1
帮我写一个响应式登录页面

🛠️ 自动修 Bug

例如：

1
修复这个 React 报错

🌐 自动搭网站

例如：

1
帮我生成一个博客首页

📦 自动安装依赖

Claude Code 可以：

1
2
3
npm install
pnpm install
pip install

自动执行。

🧠 推荐模型

🔥 最推荐：Qwen3

优点：

  • 中文强
  • 编程强
  • 占用低
  • 速度快

⚡ DeepSeek R1

优点：

  • 推理能力强
  • 数学强
  • 代码能力强

🌟 Gemma 4

优点：

  • Google 模型
  • 响应速度快

📊 显卡推荐

显卡 推荐模型
8GB Qwen 7B
12GB DeepSeek 14B
24GB Qwen 32B

⚠️ 常见问题

问题1：ollama command not found

解决：

重新安装 Ollama。

问题2：显存爆炸

解决：

换小模型：

1
2
7B
8B

不要直接跑：

1
70B

问题3：Claude 无法连接

检查：

1
2
3
CC Switch 是否启动
Ollama 是否运行
11434 端口是否正常

🌟 推荐工作流

推荐组合：

1
2
3
4
VSCode
+ Claude Code
+ Ollama
+ Qwen3

效果非常强。

⚡ 进阶玩法

🌐 接入 VSCode

安装：

1
Claude Code Extension

即可直接在 VSCode 使用。

🔥 接入 DeepSeek API

CC Switch 支持：

  • OpenRouter
  • DeepSeek
  • SiliconFlow
  • OpenAI

🧠 本地隐私模式

优势：

1
代码永不上传云端

非常适合：

  • 私有项目
  • 企业代码
  • 本地开发

📚 推荐学习方向

部署完成后推荐学习：

  • Ollama
  • LangChain
  • MCP
  • AI Agent
  • RAG
  • AutoGen

🌌 总结

Claude Code + CC Switch + Ollama：

已经是 2026 年最火的：

1
本地 AI 编程方案

它最大的意义：

不是“免费 Claude”。

而是：

1
真正把 AI 编程 Agent 搬到本地。

🚀 最后一句

未来最强的程序员，
一定是会使用 AI Agent 的程序员。 ⚡

📖 参考资料

  • :contentReference[oaicite:0]{index=0}
  • :contentReference[oaicite:1]{index=1}
  • :contentReference[oaicite:2]{index=2}

教程参考资料与实测来源： :contentReference[oaicite:3]{index=3}