未来已来：claude-code-local引领的本地优先计算革命

**claude-code-local** 是一个革命性的开源项目，它让你能在苹果芯片（Apple Silicon）设备上100%本地运行Claude Code AI助手，无需联网、无需订阅费、数据完全私密。这是**本地优先计算**的真正实现，将强大的AI能力完全置于你的掌控之中。🚀## 🔒 为什么需要本地AI计算？在云计算主导的AI时代，我们的代码、文档和隐私数据不断被发送到远程服务

卓华茵Doyle

916人浏览 · 2026-05-11 10:23:28

卓华茵Doyle · 2026-05-11 10:23:28 发布

未来已来：claude-code-local引领的本地优先计算革命

【免费下载链接】claude-code-local Run Claude Code 100% on-device with local AI on Apple Silicon. MLX-native Anthropic-API server, 65 tok/s Qwen 3.5 122B, Llama 3.3 70B, Gemma 4 31B. Private, offline, airgap-ready. Built for NDA / legal / healthcare workflows. 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-local

claude-code-local 是一个革命性的开源项目，它让你能在苹果芯片（Apple Silicon）设备上100%本地运行Claude Code AI助手，无需联网、无需订阅费、数据完全私密。这是本地优先计算的真正实现，将强大的AI能力完全置于你的掌控之中。🚀

🔒 为什么需要本地AI计算？

在云计算主导的AI时代，我们的代码、文档和隐私数据不断被发送到远程服务器。但对于律师、医生、会计师或处理敏感信息的专业人士来说，数据安全是首要考虑。

claude-code-local 解决了这一痛点：

🚫 无需网络：完全离线运行
💰 零订阅费：一次部署，永久使用
🔒 数据私密：你的代码和文档永远不会离开你的设备
✅ 完整体验：保留Claude Code的所有功能，包括代码编写、文件编辑、项目管理

🥊 三大AI模型阵容

项目支持三种强大的本地AI模型，你可以根据需求选择：

模型	核心特点	速度	内存需求	适用场景
Gemma 4 31B	快速响应，轻量级	~15 token/秒	约18GB	日常编程任务
Qwen 3.5 122B	性能怪兽，混合专家	65 token/秒	约75GB	高吞吐量工作
DeepSeek V4 Flash	百万token上下文	~32 token/秒	约81GB	长文档处理

🎯 核心技术架构

claude-code-local的核心是一个智能的MLX原生服务器，它巧妙地将Claude Code的API请求转发到本地运行的AI模型：

📱 你的设备（Mac或iPhone）
    │
🤖 Claude Code（你熟悉的AI编程工具）
    │
⚡ MLX原生服务器（约1000行Python代码）
    │
🥊 选择的AI模型（Gemma/Qwen/DeepSeek）
    │
🖥️ Apple Silicon GPU（M系列芯片完成所有计算）

🔌 完整的MCP插件生态系统

Claude Code通过MCP（模型上下文协议）服务器与世界交互。claude-code-local是唯一支持在苹果芯片上100%本地运行完整MCP插件生态系统的解决方案：

📁 文件系统MCP：本地文件读写
🐙 GitHub MCP：代码仓库管理
🌐 浏览器MCP：网页控制
🗄️ 数据库MCP：数据查询

这意味着你的本地AI可以：

读取和分析你的项目文件
管理GitHub问题和PR
控制浏览器进行网页搜索
查询本地数据库

🎤 免提语音模式：真正的环境计算

claude-code-local支持完整的免提语音交互：

🎤 语音输入：通过本地语音识别
🧠 本地处理：AI在设备上思考
🔊 语音输出：使用克隆的语音回复

整个循环都在设备上完成，无需云端处理，保护你的隐私。

🚀 三分钟快速开始指南

开始使用claude-code-local非常简单：

1️⃣ 克隆仓库

git clone https://gitcode.com/gh_mirrors/cl/claude-code-local
cd claude-code-local

2️⃣ 设置MLX虚拟环境

python -m venv mlx_venv
source mlx_venv/bin/activate
pip install -r requirements.txt

3️⃣ 选择并下载模型（一次性操作）

# 选择Gemma 4 31B（约18GB）
MLX_MODEL=google/gemma-2-9b-it ./scripts/download-and-import.sh

# 或选择Qwen 3.5 122B（约75GB）
MLX_MODEL=Qwen/Qwen2.5-32B-Instruct ./scripts/download-and-import.sh

4️⃣ 启动服务器

./scripts/start-mlx-server.sh

5️⃣ 启动Claude Code

使用项目中的启动器文件，如 launchers/Claude Local.command

📊 性能表现对比

在实际测试中，本地AI模型的表现令人印象深刻：

任务类型	云端Claude	本地Gemma 4	本地Qwen 3.5
HTML物理模拟	22秒	56秒	17.6秒
代码生成	中等延迟	快速响应	极速响应
隐私保护	❌ 数据出站	✅ 100%本地	✅ 100%本地

💡 适用场景

claude-code-local特别适合以下用户：

👨‍⚖️ 法律专业人士

处理保密协议（NDA）
分析法律文档
起草合同条款

👨‍⚕️ 医疗工作者

处理患者记录
医学文献分析
研究数据处理

💼 企业用户

内部代码审查
敏感数据查询
离线开发环境

🎓 教育工作者

离线教学工具
学生作业评估
研究论文分析

🛠️ 项目文件结构

了解项目结构有助于更好地使用：

claude-code-local/
├── launchers/          # 各种启动器脚本
│   ├── Claude Local.command
│   ├── Gemma 4 Code.command
│   └── Browser Agent.command
├── scripts/            # 实用脚本
│   ├── start-mlx-server.sh
│   ├── download-and-import.sh
│   └── doctor.sh
├── proxy/              # 核心代理服务器
│   └── server.py       # MLX服务器实现
├── docs/               # 文档
│   ├── BENCHMARKS.md   # 性能基准测试
│   └── MAC-BASE-SETUP.md
└── setup.sh            # 一键安装脚本