Ollama + Claude Code 接入本地大模型，零成本API让AI Agent 帮你干活！

🚀 免费！Ollama + Claude Code 接入本地大模型，AI Agent 全自动干活！

零成本 · 零依赖云端 · 代码不离本地

从环境搭建到 AI Agent 自动化实战，一篇搞定

一、为什么要把 AI 跑在本地？

你是不是早就受够了用 GPT、Claude 云服务时的两大痛点：要么担心核心代码泄露，要么看着 API 账单越滚越高？

2026 年初，Ollama v0.14.0 的一次更新彻底改变了游戏规则——它主动实现了对 Anthropic Messages API 的兼容。这意味着什么？意味着 Claude Code 终于能直接对接本地 Ollama 模型，不用再耗费一分钱 API 费，代码全程留在自己电脑里。

本文将手把手带你从零搭建一套"零成本、高隐私"的 AI Agent 编码方案，让你的本地大模型真正"全自动干活"。

💡 核心价值

代码全程不离开本地，零 API 成本，无调用次数限制，支持离线使用。对接 NDA 合同、GDPR 合规的项目也不怕。

二、核心原理：Ollama + Claude Code 如何协同工作？

在正式动手之前，先理解这套方案的工作原理，这样后面配置时才能心中有数。

2.1 整体架构

这套方案的核心思路很简单：

  • Claude Code：Anthropic 出品的命令行 AI Agent 工具，负责理解指令、规划任务、调用工具
  • Ollama：本地大模型运行框架，一条命令即可拉取并运行主流开源模型
  • 桥梁：Ollama v0.14.0+ 内置了对 Anthropic Messages API 的兼容层，让 Claude Code "以为"自己在和 Claude 云端通信

简单来说，就是把 Claude Code 的"大脑"从云端 Claude 模型换成了本地跑的开源模型。Claude Code 本身的 Agent 工具链、Prompt 规划、Tool 调用逻辑完整保留，只是模型后端发生了替换。

2.2 关键技术节点

  1. Ollama v0.14.0+ 已支持 POST /v1/messages 接口，兼容 Anthropic Messages API 结构
  2. Claude Code 通过环境变量 ANTHROPIC_BASE_URL 指定自定义 API 地址
  3. ANTHROPIC_API_KEY 可填任意非空字符串，本地不会校验
  4. 对用户完全透明，无感知后端模型变化

📝 补充说明

这不是 Anthropic 官方做的，而是 Ollama 社区主动实现的兼容。Anthropic 官方的态度是——既不认可，也不阻止。

三、环境准备与安装

3.1 硬件要求

本地跑大模型，硬件是基础。不同配置适配不同需求：

硬件类型核心配置适配模型参考价格
桌面独显 (24GB)RTX 4090 / RX 7900 XTX全量模型6500-13000元
笔记本 (128GB)64GB 共享显存全量模型20000-22000元
笔记本 (64GB)32GB 共享显存中小模型14500-18000元
迷你主机 (96GB)64GB 共享显存全量模型10500元

⚠️ 关键提醒

统一内存架构的笔记本，任务管理器显示内存占满 80%-100% 是正常的，这是 KV 缓存预分配，不是真的"用完了"，别慌！

3.2 软件依赖

  • 操作系统：Windows 11 (22H2+)、macOS 或 Linux
  • Node.js 18+（Claude Code 运行依赖）
  • Git（版本管理）
  • 推荐使用 Windows Terminal 或 iTerm2

3.3 安装 Ollama

Windows 系统

# 下载安装包
Invoke-WebRequest -Uri https://ollama.com/download/OllamaSetup.exe -OutFile OllamaSetup.exe

# 运行安装
.\OllamaSetup.exe

# 验证安装
ollama --version

# 启动 Ollama 服务
ollama serve

macOS / Linux

# 一键安装
curl -fsSL https://ollama.com/install.sh | sh

# 验证
ollama --version

# 确认服务已启动
curl http://localhost:11434

安装完成后，Ollama 会在 http://localhost:11434 运行。建议使用 v0.14.0 及以上版本，以确保 Anthropic Messages API 兼容性。

3.4 安装 Claude Code

# 方法 1：WinGet 安装（推荐，Windows）
winget install Anthropic.Claude

# 方法 2：NPM 全局安装（跨平台）
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

四、模型选择与部署

4.1 推荐模型

建议优先选择 Coder 类模型，在 Claude Code 场景下表现更稳定：

模型响应速度质量评分显存占用最佳场景
GPT-OSS 20B30-45 秒8.5/10~25GB通用编码、代码重构
QWEN3-Coder15-30 秒8.5-9/10~22GB快速迭代、代码补全
GLM-4.7-Flash3-7 分钟9.5/10~57GB复杂重构、架构决策

4.2 拉取模型

# 日常主力模型
ollama pull qwen3-coder

# 开源编码模型
ollama pull gpt-oss:20b

# 高质量模型（需 Ollama 0.14.3+）
ollama pull glm-4.7:flash

# 查看已下载的模型
ollama list

4.3 本地测试模型

# 启动模型进行交互测试
ollama run qwen3-coder

# 输入一个简单问题测试响应
> 请用 Python 写一个快速排序算法

确认模型可以正常响应后，再进入下一步配置 Claude Code 对接。

五、配置 Claude Code 对接 Ollama

5.1 方式一：环境变量（临时生效）

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "http://localhost:11434"
$env:ANTHROPIC_AUTH_TOKEN = "ollama"
$env:ANTHROPIC_API_KEY = "ollama"

# 验证配置
echo $env:ANTHROPIC_BASE_URL

macOS / Linux (zsh / bash)

export ANTHROPIC_BASE_URL="http://localhost:11434"
export ANTHROPIC_API_KEY="ollama"

# 写入配置文件实现永久生效
echo 'export ANTHROPIC_BASE_URL="http://localhost:11434"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="ollama"' >> ~/.zshrc
source ~/.zshrc

5.2 方式二：配置文件（永久生效，推荐）

创建或编辑配置文件：

# Windows 路径
C:\Users\<你的用户名>\.claude\settings.json

# macOS / Linux 路径
~/.claude/settings.json

写入以下内容：

{
  "api": {
    "baseURL": "http://localhost:11434",
    "authToken": "ollama"
  },
  "model": "qwen3-coder"
}

💡 说明

model 字段可根据需要切换，如 gpt-oss:20b、glm-4.7:flash 等。

5.3 启动并测试

# 启动 Claude Code，指定模型
claude --model qwen3-coder

# 测试指令：让它写一个简单的 Express.js 服务
> Create a simple Express.js server with a /hello endpoint

# 断网测试（验证是否真正走本地模型）
> Write a Python function to calculate Fibonacci numbers

如果断网后仍能正常输出，说明已完全本地化，配置成功！

六、AI Agent 全自动干活实战

配置完成后，Claude Code 就变成了一个完全本地化的 AI Agent。下面展示几个典型的自动化场景。

6.1 场景一：自动创建项目脚手架

# 在空目录中启动 Claude Code
claude --model qwen3-coder

# 输入指令
> 创建一个 React + TypeScript 项目，包含登录页面、用户管理和仪表盘，
  使用 Tailwind CSS 做样式，并配置 ESLint 和 Prettier

Claude Code 会自动：规划任务→创建目录结构→生成配置文件→编写组件代码→安装依赖。整个过程无需人工干预。

6.2 场景二：自动代码审查

# 对指定文件进行全面审查
> 对 src/api/user.ts 进行全面代码审查，
  检查安全漏洞、性能问题和代码质量，
  给出带代码示例的修复建议

6.3 场景三：自动 Bug 修复

# 让 AI 自动定位和修复问题
> 运行 npm test ，分析失败的测试用例，
  找到根因并修复所有错误

6.4 场景四：自定义技能（进阶）

可以通过创建自定义技能文件，让 AI Agent 更适配你的工作流：

# 保存为 .claude/skills/code-review/SKILL.md
---
name: code-review
description: 全面审查代码，含安全、性能检查
user-invocable: true
---

# 代码审查规则
1. 安全漏洞：SQL注入、XSS、认证问题
2. 性能问题：N+1查询、无效循环、内存泄漏
3. 代码质量：命名规范、函数复杂度、错误处理

# 输出要求
- 标注问题优先级 (Critical/High/Medium/Low)
- 指明行号
- 给出带代码示例的修复建议

使用时输入 /code-review path/to/file.js 就能自动审查，效率翻倍。

七、优缺点分析：本地部署到底值不值？

7.1 核心优势

  1. 隐私拉满：代码全程不离开本地，对接 NDA 合同、GDPR 合规的项目也不怕
  2. 零成本使用：对比云服务每年省 5600+ 元（Claude Pro 年付 4700 元 + 超额 API 费）
  3. 无限制：没有调用次数、速率限制，想怎么用就怎么用
  4. 离线可用：出差、坐飞机没网也能写代码

7.2 必须接受的短板

  1. 硬件门槛高：低配电脑跑不动高质量模型，前期投入比云服务高
  2. 速度有取舍：大参数模型响应要几分钟，急活等不及
  3. 功能有差距：云版 Claude 的最新功能（多模态、Opus 模型），本地暂时跟不上
  4. 模型质量：本地开源模型整体质量与 Claude Sonnet 等顶级云端模型仍有差距

7.3 适合什么人？

  • 接外包、做咨询的开发者：客户代码不能外传，云服务根本用不了
  • 对数据主权敏感的企业开发者：要符合合规要求，代码不能出内网
  • 高频次使用 AI 编码的人：云服务的 API 超额费会越积越多
  • 经常离线工作的人：没网也得干活

八、进阶玩法与总结

8.1 混合使用策略

不用死磕"全本地"或"全云端"，按场景切换才最香：

使用场景推荐方案说明
80% 日常工作本地 GPT-OSS / QWEN3-Coder快且够用
复杂任务本地 GLM-4.7-Flash慢但质量高
移动办公云版 Claude应急、分享对话更方便

8.2 常见问题排查

问题现象可能原因解决方案
Claude Code 报连接错误Ollama 服务未启动执行 ollama serve
响应极慢或卡死模型大于显存容量换小参数模型
输出内容乱码字体配置问题检查终端编码
断网后无法使用环境变量未生效检查配置文件

8.3 总结

本地部署 Claude Code + Ollama 的核心价值是隐私和无限制使用，而非单纯省钱。它适合有 NDA 合规、离线办公需求的开发者。

  • 硬件优先选 24GB 以上独显桌面机（性价比高）或 128GB 笔记本（便携）
  • 实操时按"装工具 → 拉模型 → 配对接 → 测离线"四步走
  • 三款模型按场景切换，混合使用效率最高

这套方案不是取代云服务，而是给开发者多了一个"安全选项"——当代码是核心资产时，把控制权握在自己手里，才是最稳妥的选择。


此博客中的热门博文

4个超好用的AI配音工具，自媒体短视频必备！免费！

图片
做自媒体声音不好听怎么办？不会配音，普通话不标准，这都没关系！分享超好用的AI配音工具，让枯燥的文字转成生动有趣的语音。影视解说、游戏解说、 纪录片解说 、美食解说、体育解说、旅游解说、知识科普、娱乐综艺、情感文案、企业宣传等博主都在用的免费配音软件，声音接近真人。 4个超好用的AI配音工具，自媒体短视频必备！ 1、Microsoft Azure Azure是微软旗下的一款 文本转语音 工具，140 种语言和变体的 400 种神经网络语音，通过简单地调整语速、音调、发音和停顿等，可实现与人声的语调和情感匹配的流畅、发音逼真自然的AI语音生成器。 截至目前为止，中文配音员一共32个，女配音员：晓萱、晓辰、晓涵、晓墨、晓秋、晓辰、晓睿、晓双、晓颜、晓悠、晓梦、晓伊、晓甄；男配音员： 云杨、云希、云野 、云枫、云皓、云健、云夏、云泽。 最近新增方言版的 云希(男，西南，云贵川桂 )、 云翔 (男，吉鲁) 、 云登 (男，河南) 、晓北 (女，东北) 、 晓妮 (女，陕西)。 曉臻 (女，台湾普通话) 、曉雨 (女，台湾普通话)、 雲哲 ( 男 ，台湾普通话) 、 曉曼 (女，粤语)、 曉佳 (女，粤语)、 雲龍 (男 ，粤语 ) 。 在西瓜、抖音、快手等视频平台里，我们所听到最多的就是 云希 的声音。 Azure链接： https://azure.microsoft.com/zh-cn/services/cognitive-services/text-to-speech/#features  ( 官方改版无法使用 ) 使用心得： 无需注册登录即可免费使用，不会存储你的数据，也无法导出音频文件。可以使用录屏或录音软件，录制已生成的音频。 2、Clipchamp Clipchamp是微软旗下公司，一个快捷简便而且免费的在线视频编辑器。 所有人都能轻松在浏览器中编辑视频，让任何人都能讲述值得分享的故事。 免费版的可以无限无水印导出，高达1080p (HD) 的导出分辨率，免费的音频、图像和视频素材、滤镜、效果、模板等，可免费使用于YouTube、Facebook、Instagram、Pinterest等社交媒体平台。 使用心得： 网页版本 需注册登录方可使用(直接用微软账号)，免费使用文字转语音工具！可导出视频和音频文件。虽然是基于Azure，但没有说话风格和音调的调节...
阅读全文

如何将文案快速制作成视频，这个方法太高效了

图片
 在之前的《 不露脸不出镜也能月入过万，零投入人人可操作的自媒体视频赚钱项目 》文章中，我简单的介绍了视频自媒体赚钱方法，而文案在自媒体中的重要性不言而喻。 每天制作视频，我会先 写文案 ，再查找素材，然后把写好的文案进行配音，再将视频素材和配音导入到视频编辑软件中剪辑。 其实这个过程，每天真的要花费很多时间去做，如 写文案 ，快的时候一个小时能写好，但是慢的时候几个小时也写不出来一篇。 在配音时，如果是自己配音，虽然对录音设备要求不高，但是要有安静的录音场地，而且还要带有感情色彩的。以1500字为例，录好一个音频可能要花上至少1个小时甚至更多时间。 如果没有合适的录音场地，那只好找一些录音软件替代， 省时省力 。 剪辑视频虽然没有写文案那么头疼，但是我们经常要事先准备好素材，才能快速完成剪辑。如果都是临时查找、下载，这些都要花费不少时间。 接下来，我会分享自己常用的解说视频创作方法， 简单高效 。 1、用到一个网站：票圈视频。免费好用的（建议电脑端使用） 它有很多常用的模版类型和案例视频，方便创作者使用。 知识讲解，情感，生活，教育演示，古风&影视，游戏，人文历史，健康养生。 比如：知识讲解，就是我最常用的。 2、选择一个模板，然后点“立即使用模板”进行创作。我在这选用“动物世界模板”。 进入创作页面后，我们能看到界面很直观地列出全部功能，文本输入框、视频图片素材、配音、背景音乐等。 3、按照自己的需求分别填充内容。 分段式的创作，在段落输入文案，选择相应的视频或者图片画面，也可以自定义上传素材，选择自己喜欢的配音员，选择语气等。 文章转视频，就这么简单的操作。 合成好的视频就可以在创作主页【我的视频】中找到。 最后，如果你是文章创作者，想要将文案快速制作成视频，这是不错的免费工具网站。 有这方面需求的网友可以试试。 如果想要增加收入，还可以开通自己的 Blogger 博客，赚取谷歌广告佣金。
阅读全文

国内如何干净下载谷歌 Chrome 浏览器，包含Windows + Mac + Linux + Android 正版离线安装包下载

图片
最近谷歌翻译突然用不了了，很多同学以为谷歌再没有适合我们使用的产品了。而作为一个开发者，常用的浏览器就是Chrome，简洁、快速，插件丰富，也是很多上网者的首选。 其实直接访问谷歌中国官网下载安装就行了。 国内可以访问的谷歌中国官网（三个都一样）： https://www.google.cn/chrome/ https://www.google.cn/chrome/ index.html https://www.google.cn/intl/zh-CN/chrome/ index.html是网站首页的网页文件。 注意：在这里，你直接点击下载按钮，下载下来的“ChromeSetup.exe”是一个在线安装包，如下图，1.36MB。 它在安装时，必须网络环境保持畅通，对于有些无网络和网速慢的朋友们来说非常不方便。 Chrome 浏览器离线安装包下载 在原官方网址后加了个“?standalone=1”，standalone(独立)，即独立安装包。 https://www.google.cn/chrome/?standalone=1 https://www.google.cn/chrome/index.html?standalone=1 网页会根据你访问的设备进行识别，然后提供相应的版本。比如，你的电脑系统是Windows，直接给你下载“ChromeStandaloneSetup64.exe”文件，大小88.89MB，这就是一个离线安装包。 你也可以使用以下链接下载相应的版本： Windows ： https://www.google.cn/intl/zh-CN/chrome/?standalone=1&platform=win64 Mac： https://www.google.cn/intl/zh-CN/chrome/?standalone=1&platform=mac64 如果你想下载更多的或适用于其他电子设备的版本，比如Linux、Mac、Android。 访问以上网址，通过 Ctrl+f 输入“其他平台”或者下拉到最底部也可以找到。 在这里你会发现，想要下载Android版的Chrome，就会跳转到Google play，网页无法访问！！ Android版 目前国内很多手机应用商店都已经下架Android版的Chrome浏览器了。有些可以下载的网...
阅读全文