Repolode
Enviar
nicedreamzapp

nicedreamzapp/claude-code-local

Executa modelos de IA abertos localmente em Macs com Apple Silicon usando MLX e os disponibiliza por um servidor compatível com a API da Anthropic, para usar o Claude Code offline.

Alternativa open source a:Claude Code

Ver no GitHubSite
Estrelas
3,372
Forks
652
Issues abertas
3
Último commit
há 4 dias

O que é?

Claude Code Local é um servidor Python compacto (proxy/server.py) que executa modelos abertos no chip do Mac usando o framework MLX da Apple e responde ao Claude Code no formato da Messages API da Anthropic. Como o Claude Code se comunica diretamente com o servidor local, não é necessário usar um modelo na nuvem nem uma API key, e os prompts e o código permanecem na máquina.

O servidor converte o formato de chamada de ferramentas de cada modelo compatível — incluindo Gemma 4, Qwen e JSON do Llama — em chamadas de ferramentas do Claude Code, corrige JSON inválido de ferramentas e reutiliza o cache de prompts entre turnos. A configuração verifica a memória do Mac e seleciona um modelo que caiba nela, desde o Gemma 4 E4B em máquinas com 8 GB até o Qwen 3.8 27B em máquinas com 96 GB ou mais.

O projeto também inclui iniciadores para programação, um agente leve de terminal, um agente de navegador, modo de voz e uma alternativa gratuita na nuvem chamada keep going, para continuar uma conversa quando o limite de uso do Claude acabar. O projeto tem licença MIT e requer Apple Silicon com Python 3.12.

Recursos principais

  • 01Disponibiliza a Messages API da Anthropic com streaming para usar o Claude Code com um modelo MLX local.
  • 02Converte os formatos de chamada de ferramentas específicos de cada modelo em chamadas de ferramentas do Claude Code.
  • 03Reutiliza o cache de prompts entre turnos para acelerar sessões longas.
  • 04Seleciona um modelo local com base na memória disponível no Mac.
  • 05Oferece a opção keep going para continuar uma conversa com um modelo gratuito na nuvem ou local.

Casos de uso

  • Continuar usando o Claude Code quando o limite de uso do Claude for atingido.
  • Trabalhar com código-fonte offline ou em um ambiente isolado de rede em um Mac.
  • Manter prompts e código fora de servidores de terceiros em trabalhos sensíveis, como projetos jurídicos ou da área da saúde.
  • Experimentar modelos abertos no fluxo de trabalho do Claude Code em Apple Silicon.

Início rápido

  1. 1

    Instale com um único comando

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

    Ou clone o repositório e execute a configuração

    git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh
  3. 3

    Clique duas vezes em Claude Local.command na mesa para começar a programar localmente

Antes de usar

  • É necessário ter um Mac com Apple Silicon (M1 ou mais recente); o app não funciona em outras plataformas.
  • Modelos maiores precisam de bastante memória unificada, e Macs com 8 GB recebem um modelo com problemas conhecidos no uso de ferramentas.

Tópicos

#local-llm#apple-silicon#mlx#claude-code#anthropic-api#offline-ai#on-device-ai#privacy#abliterated#ai-privacy

Perguntas frequentes

O que é claude-code-local?
Executa modelos de IA abertos localmente em Macs com Apple Silicon usando MLX e os disponibiliza por um servidor compatível com a API da Anthropic, para usar o Claude Code offline. Claude Code Local é um servidor Python compacto (proxy/server.py) que executa modelos abertos no chip do Mac usando o framework MLX da Apple e responde ao Claude Code no formato da Messages API da Anthropic. Como o Claude Code se comunica diretamente com o servidor local, não é necessário usar um modelo na nuvem nem uma API key, e os prompts e o código permanecem na máquina.
claude-code-local é gratuito? Qual é a licença?
claude-code-local é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-code-local ainda é mantido?
Manutenção ativa. O último commit de claude-code-local foi em 15 de out. de 2026.
Para que posso usar claude-code-local?
Continuar usando o Claude Code quando o limite de uso do Claude for atingido. Trabalhar com código-fonte offline ou em um ambiente isolado de rede em um Mac. Manter prompts e código fora de servidores de terceiros em trabalhos sensíveis, como projetos jurídicos ou da área da saúde. Experimentar modelos abertos no fluxo de trabalho do Claude Code em Apple Silicon.
Como instalar claude-code-local?
Instale com um único comando: curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash Ou clone o repositório e execute a configuração: git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh Clique duas vezes em Claude Local.command na mesa para começar a programar localmente
Onde consigo claude-code-local?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nicedreamzapp/claude-code-local

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados