如何完全免费用 Gemma 4 运行 Claude Code（新手教程）

本教程教你零订阅、无 API 密钥，免费使用 Claude Code + Gemma 4。

只需一台笔记本 + 15 分钟配置。

可在本地运行开源模型（如谷歌 Gemma），优势：

• 完全免费

• 隐私百分百安全

准备工作

确保你已安装：

• VS Code

• Node.js（18+ 版本）

• 稳定网络（仅用于一次性下载模型）

步骤 1：安装 Ollama（AI 运行引擎）

Ollama 用于在本地运行 AI 模型。

• Mac：

访问 ollama.com/download

点击 Download for Mac，打开文件正常安装即可，无需终端。

• Windows：

访问 ollama.com/download，下载并安装。

• Linux：

curl -fsSL ollama.com/install.sh | sh

验证安装：

ollama --version

步骤 2：下载 Gemma 4

根据电脑配置选择：

• 低配（8GB 内存）：

ollama pull gemma4:e2b

• 推荐（16GB 内存）：

ollama pull gemma4:e4b

• 高配（32GB 内存）：

ollama pull gemma4:26b

⚠️ 文件较大（7GB–18GB），耐心等待。

下载完成后验证：

ollama list

步骤 3：在 VS Code 安装 Claude Code

1. 打开 VS Code

2. 按 Ctrl + Shift + X

3. 搜索 Claude Code

4. 安装 Anthropic 官方插件

安装后侧边栏会出现 ⚡ 图标

步骤 4：将 Claude Code 连接到本地 Ollama

默认 Claude 连云端，我们改成本地。

1. 按 Ctrl + Shift + P

2. 搜索：Open User Settings (JSON)

3. 粘贴以下配置：

"claude-code.env": {

"ANTHROPIC_BASE_URL": "http://localhost:11434",

"ANTHROPIC_API_KEY": "",

"ANTHROPIC_AUTH_TOKEN": "ollama"

}

作用：

• 所有请求转发到本地 Ollama

• 数据完全不离开你的设备

步骤 5：启动运行

1. 终端运行（保持开启）：

ollama serve

2. VS Code 打开 Claude Code（点 ⚡）

3. 选择模型，输入你下载的版本，例如：

gemma4:e4b

完成！

你现在拥有

• 可运行的 Claude Code

• 基于本地 Gemma 4 驱动

• 完全本地、完全免费

可直接使用：

• “解释这个文件”

• “写一个函数”

• “重构这段代码”

常见问题（快速修复）

• 无法连接

运行：ollama serve

• 要求登录

JSON 配置错误，检查逗号、括号。

• 响应极慢

模型太大，换成：gemma4:e2b

• 模型未找到

运行：ollama list

你已搭建：

✅ 免费 Claude 环境

✅ 本地 AI 驱动

✅ 零 API 费用

关注获取更多 AI 干货！