一款 Rust 编写的命令行与终端工具,检测 CPU、内存和显卡,按硬件适配度推荐可运行的开源大模型。
nicedreamzapp/claude-code-local
在 Apple Silicon Mac 上用 MLX 本地运行开源模型,并以 Anthropic API 兼容服务让 Claude Code 离线使用。
可替代:Claude Code
- Star
- 3,372
- Fork
- 652
- 未关闭 Issue
- 3
- 最近提交
- 4天前
这是什么?
Claude Code Local 是一个小型 Python 服务(proxy/server.py),它用苹果的 MLX 框架在 Mac 芯片上运行开源模型,并以 Anthropic Messages API 的格式响应 Claude Code。Claude Code 直接与本地服务通信,无需云端模型或 API Key,提示词和代码都留在本机。
服务端会把各模型自己的工具调用格式(如 Gemma 4、Qwen、Llama JSON)转换为 Claude Code 的工具调用,修复损坏的工具 JSON,并在多轮对话之间复用提示词缓存。安装脚本会检测 Mac 的内存并选择合适的模型,从 8 GB 机器上的 Gemma 4 E4B 到 96 GB 及以上机器上的 Qwen 3.8 27B 不等。
项目还包含编码启动器、轻量终端代理、浏览器代理、语音模式,以及在 Claude 额度用完时继续对话的 keep going 功能,可切换到免费云端模型。项目采用 MIT 许可,需要 Apple Silicon 芯片和 Python 3.12。
核心功能
- 01为本地 MLX 模型提供支持流式输出的 Anthropic Messages API 服务。
- 02将各模型特有的工具调用格式转换为 Claude Code 的工具调用。
- 03在多轮对话之间复用提示词缓存,加快长会话速度。
- 04根据 Mac 的可用内存自动选择本地模型。
- 05提供 keep going 功能,可切换到免费云端或本地模型继续对话。
适用场景
- 在 Claude 用量达到上限后,继续使用 Claude Code 工作。
- 在 Mac 上离线或隔离网络环境中处理源代码。
- 在法律、医疗等敏感场景中,避免代码和提示词发送到第三方服务器。
- 在 Apple Silicon 上结合 Claude Code 工作流试用各类开源模型。
快速上手
- 1
用一条命令安装
curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash - 2
或者克隆仓库并运行安装脚本
git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh - 3
双击桌面上的 Claude Local.command 即可开始本地编码
使用前须知
- 需要搭载 Apple Silicon(M1 或更新)芯片的 Mac,不支持其他平台。
- 较大的模型需要大量统一内存,8 GB 的 Mac 只能运行工具调用存在已知问题的模型。
标签
常见问题
- claude-code-local 是什么?
- 在 Apple Silicon Mac 上用 MLX 本地运行开源模型,并以 Anthropic API 兼容服务让 Claude Code 离线使用。 Claude Code Local 是一个小型 Python 服务(proxy/server.py),它用苹果的 MLX 框架在 Mac 芯片上运行开源模型,并以 Anthropic Messages API 的格式响应 Claude Code。Claude Code 直接与本地服务通信,无需云端模型或 API Key,提示词和代码都留在本机。
- claude-code-local 可以免费使用吗?用的什么许可证?
- claude-code-local 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- claude-code-local 还在维护吗?
- 活跃维护中。claude-code-local 最近一次提交是在 2026年10月15日。
- claude-code-local 适合用来做什么?
- 在 Claude 用量达到上限后,继续使用 Claude Code 工作。 在 Mac 上离线或隔离网络环境中处理源代码。 在法律、医疗等敏感场景中,避免代码和提示词发送到第三方服务器。 在 Apple Silicon 上结合 Claude Code 工作流试用各类开源模型。
- claude-code-local 怎么安装和运行?
- 用一条命令安装: curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash 或者克隆仓库并运行安装脚本: git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh 双击桌面上的 Claude Local.command 即可开始本地编码
- 在哪里获取 claude-code-local?
- 源代码和安装说明在 GitHub 上:https://github.com/nicedreamzapp/claude-code-local
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
开源推理引擎,针对你的硬件自动调优内核,让开源模型在 Apple Silicon、NVIDIA、AMD 或纯 CPU 上运行更快。
基于 Swift 和 Metal 的运行时,在约 2 GB 内存的 Apple Silicon Mac 上运行 Gemma 4 26B-A4B 模型。
通过 USB-C 连接 iPhone 与 Mac,借助手机 GPU 协同本地运行 Qwen 27B 模型,加快提示词读取并扩展上下文。
一个面向 Apple Silicon 的教学项目,用 MLX 运行视觉语言模型,对同一张图片的候选答案直接打分。
一个 Claude Code 技能,读取本机会话日志,分析 token 用量去向及触发限额的原因。