ClaudeCode 通过 CC Switch 配置 Ollama 本地大模型

让 Claude Code 使用本地免费模型（qwen3.5:9b），无需 Anthropic API Key

目录

1. 环境概述
2. 安装步骤
3. 配置步骤
4. 配置清单
5. 原理说明
6. 测试方法
7. 常见问题

1. 环境概述

最终效果

用户运行: claude ↓ Claude Code 发送请求 ↓ CC Switch Gateway (127.0.0.1:15721) 拦截并转发 ↓ Ollama (localhost:11434) 运行本地模型 ↓ 返回 qwen3.5:9b 的回复给用户

组件关系

2. 安装步骤

2.1 安装 Claude Code

# 方法一：npm 安装npminstall-g@anthropic-ai/claude-code# 方法二：brew 安装brewinstallclaude-code# 验证安装claude--version# 输出: Claude Code v2.1.100

2.2 安装 CC Switch

# 添加 tapbrew tap farion1231/ccswitch# 安装 CC Switchbrewinstall--caskcc-switch# 启动 CC Switchopen-a"CC Switch"# 验证安装open-a"CC Switch"2>/dev/null&&echo"✅ CC Switch 已启动"

2.3 安装 Ollama

# macOS 安装curl-fsSLhttps://ollama.com/install.sh|sh# 或者 brew 安装brewinstallollama# 启动 Ollamaollama serve# 验证安装ollama--version

2.4 下载模型

# 下载 qwen3.5:9b（推荐，免费开源，支持工具调用）ollama pull qwen3.5:9b# 查看已下载的模型ollama list# 输出示例:# NAME ID SIZE MODIFIED# qwen3.5:9b a642... 5.6GB 2 hours ago

3. 配置步骤

3.1 配置环境变量 (~/.zshrc)

# 打开配置文件vim~/.zshrc# 添加以下内容（在文件末尾）:

# ============================================================================