claude-code-local开发实战：从零开始构建本地AI代码助手

claude-code-local是一款基于Apple Silicon芯片的本地AI代码助手，能够让你100%在设备上运行Claude Code，实现完全私密、离线、可断网使用的AI开发体验。它专为NDA、法律和医疗保健等对数据安全有严格要求的工作流程而构建，支持MLX原生Anthropic-API服务器，以及Qwen 3.5 122B、Llama 3.3 70B、Gemma 4 31B等大语言模

gitblog_00072

1057人浏览 · 2026-05-11 10:21:34

gitblog_00072 · 2026-05-11 10:21:34 发布

claude-code-local开发实战：从零开始构建本地AI代码助手

【免费下载链接】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

一、环境准备：快速搭建开发环境

1.1 硬件要求

要流畅运行claude-code-local，建议使用搭载Apple Silicon芯片的Mac设备，如M1、M2或M3系列处理器，以充分发挥MLX框架的性能优势。

1.2 软件依赖

确保你的系统已安装以下软件：

macOS操作系统
Git工具
终端应用程序

1.3 获取项目代码

打开终端，执行以下命令克隆项目仓库：

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

二、安装部署：简单几步完成配置

2.1 运行安装脚本

进入项目目录，执行setup.sh脚本进行自动安装：

cd claude-code-local
./setup.sh

该脚本会自动处理依赖项安装、环境配置等步骤，让你无需手动操作复杂的配置过程。

2.2 配置本地设置

安装完成后，你可以通过修改launchers/lib/local-settings.json文件来调整个性化设置，如模型选择、性能参数等。

2.3 验证安装结果

运行诊断脚本检查系统环境是否满足要求：

./scripts/doctor.sh

如果一切正常，你将看到"System check passed"的提示信息。

三、启动使用：体验本地AI代码助手

3.1 启动不同模型

项目提供了多种启动器，你可以根据需求选择不同的AI模型：

Claude Local：launchers/Claude Local.command
Gemma 4 Code：launchers/Gemma 4 Code.command
Llama 70B：launchers/Llama 70B.command
Narrative Gemma：launchers/Narrative Gemma.command

只需双击相应的.command文件或在终端中执行即可启动对应的AI模型。

3.2 与本地AI代码助手交互

启动后，你可以通过终端或集成的聊天界面与AI代码助手进行交互，提出代码问题、请求代码示例或获取开发建议。所有交互都在本地进行，确保你的代码和数据安全。

四、高级配置：优化本地AI性能

4.1 调整模型参数

你可以通过修改启动脚本或配置文件来调整模型的参数，如上下文窗口大小、生成速度等，以获得更符合个人需求的使用体验。

4.2 管理模型文件

项目提供了脚本帮助你下载和管理模型文件：

scripts/download-and-import.sh：下载并导入模型
scripts/persistent-download.sh：持续下载大模型文件
scripts/upload-mlx-quant.sh：上传量化后的模型

4.3 启动MLX服务器

如果需要通过API与本地AI模型交互，可以启动MLX服务器：

./scripts/start-mlx-server.sh

然后通过proxy/server.py文件配置代理服务，实现与其他应用的集成。

五、常见问题解决

5.1 安装过程中遇到问题

如果在安装过程中遇到困难，可以参考官方文档docs/MAC-BASE-SETUP.md获取详细的安装指南。

5.2 模型运行缓慢

如果模型运行速度不理想，可以尝试关闭其他占用资源的应用，或调整模型的量化级别以平衡性能和速度。

5.3 卸载claude-code-local

如果需要卸载项目，只需执行卸载脚本：

./uninstall.sh

通过以上步骤，你已经成功搭建并开始使用claude-code-local本地AI代码助手。它不仅能为你提供高效的代码辅助功能，还能确保你的数据安全和隐私保护，是开发过程中的得力助手。无论是学习编程、快速原型开发还是处理敏感项目，claude-code-local都能满足你的需求，让AI开发变得更加简单、安全和高效。