侧边栏壁纸
博主头像
硅基核心 (Silicon Core)

行动起来,活在当下

  • 累计撰写 50 篇文章
  • 累计创建 1 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录

【开源白嫖】Claude Code + Ollama 终极本地化教程:零成本打造最强 AI 程序员!

jackyezhang
2026-05-18 / 0 评论 / 0 点赞 / 97 阅读 / 0 字
温馨提示:
部分素材来自网络,若不小心影响到您的利益,请联系我们删除。

前言:打破 Token 焦虑,迎来完全免费的 AI 程序员

最近,Anthropic 推出的命令行 AI 助手 Claude Code 在开发圈彻底火了。它不同于传统的“你问我答”式聊天机器人,而是一个真正的 AI Agent。它能直接读取你的项目结构、自动修改文件、运行终端命令,甚至在报错时自己分析日志并把 Bug 修复。

但硬伤也很明显:官方 API 实在太贵了!在长上下文的大型项目里,多轮 Agent 自动迭代几次,钱包就缩水一大圈。

今天教大家一个全网刚出炉的“白嫖”新玩法: 利用开源桥接工具 CC Switch,将 Claude Code 的大脑直接替换为本地运行的 Ollama(支持 Qwen、DeepSeek、Gemma 4、GLM 等)。100% 运行在本地、0 成本、无 Token 焦虑、隐私绝对安全!


一、 环境准备(磨刀不误砍柴工)

在开始前,请确保你的系统已安装以下基础环境:

  1. Git:用于克隆项目与管理版本。

  2. Node.js (v18+):因为 Claude Code 基于 Node 环境运行。


二、 核心组件下载与安装

步骤 1:安装 Claude Code 官方命令行版

打开你的终端(Terminal 或 PowerShell),运行官方安装命令:

Bash

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

(注:若遇到权限问题,Mac/Linux 用户请在前面加上 sudo,Windows 用户请使用管理员身份打开 PowerShell。)

步骤 2:下载并运行最新版 Ollama

官方下载:【点击官网下载

  1. 安装完成后,在终端中拉取你心仪的本地大模型。推荐根据显存选择:

    • 8G 显存:推荐 Qwen2.5-Coder:7bGemma2:9b

    • 12G-16G 显存:推荐 Qwen2.5-Coder:14bGLM-4:9b

    • 24G 显存及以上:强烈推荐 DeepSeek-R1 蒸馏版或 Qwen2.5-Coder:32b

    Bash

    # 以安装 Qwen 编程专版模型为例
    ollama run qwen2.5-coder:7b
    

步骤 3:下载并配置 CC Switch 开源桥接工具

由于 Claude Code 默认只能调用 Anthropic 的官方 API,我们需要 CC Switch 作为一个“欺骗层”(API 转发),让 Claude 以为自己连的是官方,实际上请求都被转发到了本地的 Ollama。


三、 关键配置:手把手带你接通链路

下载并打开 CC Switch 后,按照以下参数进行设置:

1. CC Switch 软件端设置

  • 请求地址(Base URL)http://127.0.0.1:11434/v1 (这是 Ollama 的本地默认接口)

  • API 格式:选择 OpenAI Chat Completions

  • 认证字段(Header):选择 ANTHROPIC_API_KEY(随便填一串字符即可,如 sk-local-test,用于绕过客户端检测)


2. 修改 Claude Code 配置文件(核心避坑)

我们需要强行注入模型名称,让 Claude Code 能够顺利读取。

  1. 找到 Claude Code 在本地的配置文件 config.json

    • Windows 路径%USERPROFILE%\.claude\config.json

    • Mac/Linux 路径~/.claude/config.json

  2. 用文本编辑器打开它,在配置文件的花括号末尾,加入以下注册表修改命令:

    JSON

    "inferenceModels": "[\"haiku\",\"sonnet\",\"opus\"]"
    

    ⚠️ 注意:添加前记得在上一行末尾加上逗号(,),确保 JSON 格式正确。这一步是利用 CC Switch 强行将本地模型映射为官方模型名称进行显示。


四、 实测体验:AI 自动疯狂打工

配置完成后,在你的项目根目录下输入命令启动它:

Bash

claude

此时你将进入一个由本地大模型驱动的 Agent 终端。你可以直接对它下达复杂的复合指令:

实测指令:“帮我生成一个赛博朋克风格的个人主页网站。”

本地模型的自动化执行过程:

[AI 正在思考...] 
-> 自动创建 src/ 目录及 index.html
-> 自动编写 CSS 动画与特效代码
-> 自动在终端运行 npm install 安装依赖
-> 自动执行本地预览命令

整个过程一气呵成!你不再需要复制粘贴代码,AI 自己在 IDE 和 Terminal 之间无缝切换,真正的 AI + IDE + Terminal 三合一体验。


五、 本地平替的优缺点客观分析(不吹不黑)

虽然“Claude Code + Ollama”的玩法非常惊艳,但在实际体验了几天后,我也发现了它的一些局限性:

优势 🌟

  • 完全免费:没有任何 API 费用,有多少显卡性能就压榨多少。

  • 隐私安全:代码资产 100% 留在本地,非常适合企业内部代码或敏感项目。

  • 无 Token 焦虑:哪怕项目再大、上下文字数再多,也不用担心钱包大出血。

缺点与局限 ⚠️

  1. 长上下文架构能力稍逊:面对复杂的大型重构时,本地模型(如 Qwen/DeepSeek 蒸馏版)偶尔会出现死循环修 Bug、逻辑混乱的情况,在多步骤推理上与原生的 Claude 3.5 Sonnet 仍有差距。

  2. 多模态 Vision 兼容性不佳:目前通过 CC Switch 转发后,图片和 OCR 的多模态支持并不完美,经常出现“无法识别上传图片”的报错。它目前更适合纯粹的代码编写、自动化运维、脚本生成和 VPS 部署


六、 总结

尽管本地模型在极限性能上距离行业天花板还有一段路要走,但 Claude Code + Ollama 的组合,已经让我们看到了“完全本地化 AI 程序员”的曙光。对于日常编写中小型项目、自动化脚本和运维的开发者来说,这套方案的生产力已经完全溢出。

赶紧去配置一套属于你的免费 AI 编程助手吧!

0
  1. 支付宝打赏

    qrcode alipay
  2. 微信打赏

    qrcode weixin

评论区