Repolode
nicedreamzapp

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. 1

    用一条命令安装

    curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash
  2. 2

    或者克隆仓库并运行安装脚本

    git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh
  3. 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 数据每日更新。

相关项目