Código aberto, licença MIT

Instale o código livre, o agente de codificação IA gratuito para o seu terminal

free-code lê o seu projeto, edita arquivos com um diff que você aprova, executa seus testes e corrige o que falha. Uma linha instala-o no macOS, Linux ou Windows.

macOS / Linux / WSL
curl -fsSL https://free.ai/install.sh | sh
Windows (PowerShell)
irm https://free.ai/install.ps1 | iex

Não precisava primeiro de direitos de Python, pip ou administrador. Executar a mesma linha novamente para atualizar.

Gratuito para começar: 6,000 tokens por dia sem conta, 30,000 por dia com uma conta gratuita confirmada.

Outras maneiras de instalar

The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:

uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code

O pacote npm precisa de Python 3.9 ou mais recente na máquina.

Instalar uma versão específica

# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh

# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex

Para forçar um método de instalação, configure o GRATUITO_CODE_INSTALLER para uv, pipx ou venv da mesma forma.

Verificar que funcionou

free-code --version

Primeira corrida

Abra um terminal na pasta do projeto e inicie uma sessão. Funciona imediatamente sem conta.

cd your-project
free-code

# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"

O modo seguro está ligado por padrão: você vê um diff e aprova cada edição e comando de arquivo antes de ele executar. A primeira vez, código livre pergunta uma vez se enviar relatórios anônimos de falha. A resposta padrão é não.

Entre e as chaves API

Signing in raises your daily free allowance and lets you use paid models from your token balance. Your browser opens at Free.ai, you press Approve, and the CLI receives a key automatically.

free-code login               # opens your browser
free-code login --no-browser  # over SSH: approve from any device with a short code
free-code login --manual      # paste a key or choose your own provider
free-code logout              # forget the key on this machine

Você também pode criar uma chave em sua conta e definir, que é útil para servidores e IC:

free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...

Criar uma conta gratuita

Use a sua própria chave do fornecedor

o código livre também funciona com a sua própria chave OpenAI, Anthropic, Google ou OpenRouter. Pedidos então ir para esse fornecedor com a sua chave.

free-code config set provider anthropic
free-code config set api_key sk-ant-...

Escolha um modelo

free-code lists every model Free.ai serves, free tier models first. Free tier models cost no tokens within your daily allowance; paid models are billed in tokens.

free-code models               # chat models, free tier first
free-code models --free        # only models that cost no tokens
free-code models --type image  # image, video, tts, stt, ocr, music ...
free-code config set model <id>  # default model for new sessions

Dentro de uma sessão, digite /modelo para mudar. Procurar todos os modelos

Comandos comuns

ComandoO que faz
free-codeIniciar uma sessão interativa nesta pasta
free-code -cContinuar a última sessão para este projeto
free-code ask "..."Faça uma pergunta sobre a base de códigos
free-code run "..."Realizar uma tarefa de codificação
free-code -p "..."Imprimir a resposta e saída, para scripts e IC
free-code sessionsListar as sessões guardadas você pode retomar
free-code toolsMostrar as ferramentas que o agente pode usar e que precisam de aprovação
free-code cloud "..." --repo URLExecutar uma tarefa na nuvem Free.ai e obter um relatório
free-code tasksListar suas tarefas recentes em nuvem
free-code rcAssista e dirija a sessão do aplicativo Free.ai
free-code mcp addConectar um servidor MCP
free-code updateAtualizar para a versão mais recente
free-code configMostra as suas configurações

Além de editar arquivos e comandos de execução, o agente pode gerar imagens, fala, música e vídeo no seu projeto, transcriba áudio, leia texto de imagens e PDFs, procure na web com citações e traduzir arquivos locais.

Cada comando e opção está no README no GitHub

Actualizar e desinstalar

atualizações de código livre através de qualquer instalação. Para removê-lo, use a mesma ferramenta:

free-code update

uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code

Se o instalador criar seu próprio ambiente, exclua a pasta.free-code em seu diretório home e o arquivo free-code em.local/bin. Suas configurações e sessões salvas também vivem em código.free.

Resolução de problemas

free-code: comando não encontrado

A pasta de instalação ainda não está na sua PATH. No Windows, abra um novo terminal. No macOS ou Linux, adicione-o ao seu perfil de shell e abra um novo terminal:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc

O limite anônimo gratuito para hoje é usado

Run free-code login to sign in and get the larger daily allowance of a free account, or add tokens to use paid models. Ver preços

O instalador não pode baixar uv

Algumas redes bloqueiam astral.sh. Instale com pipx ou pip em vez disso, ou configure GRATUITO_CODE_INSTALLER=venv para usar o seu próprio Python 3.9 ou mais recente.

python3 -m venv falhou no Debian ou Ubuntu

Instale o pacote python3-venv com apt, depois execute a linha de instalação novamente.

Ainda está preso? Digite /feedback dentro do código livre, ou abra um problema no GitHub. GitHub issues

FAQ

o código livre é o agente de codificação Free.ai para o seu terminal. Lê o seu projeto, edita arquivos com uma visualização de diff, executa comandos e testes, e usa modelos Free.ai. É fonte aberta sob a licença MIT.

Yes. It works without an account on a free daily allowance. Sign in with free-code login for a larger daily allowance. Paid models are billed in tokens and need a balance on your account.

MacOS, Linux e Windows. Use a linha de curvas no macOS, Linux e WSL, e a linha PowerShell no Windows. O instalador usa uv, que recupera um Python adequado para você, então não há nada para configurar primeiro.

Não. O instalador coloca código livre na pasta.local/bin no seu diretório de casa e nunca pede direitos de administrador.

Executar o login de código livre. Seu navegador abre em Free.ai, você se connecte e pressione Approve e o CLI recebe uma chave automaticamente. Em um servidor sobre SSH, use o login free-code --no-browser e aprova de qualquer dispositivo com o código curto que imprime.

Sim. Execute o login de código livre --manual para colar uma chave Free.ai ou escolha o seu próprio fornecedor (OpenAI, Anthropic, Google ou OpenRouter). Pedidos então ir para esse fornecedor com a sua chave.

Execute modelos de código livre para listar todos os modelos Free.ai serve, com modelos de nível livre primeiro. Adicionar --free ou --pago para filtrar. Mude dentro de uma sessão com /modelo, ou configure um padrão com o modelo de configuração do código livre seguido pelo modelo id.

Edições de arquivos e comandos executam na sua máquina. O modelo recebe as partes do seu projeto que precisa responder. Os relatórios anônimos de falha estão desligados a menos que você os activeles nunca incluem o seu código, avisos ou caminhos de arquivo.

Executar a atualização do código livre. Ele atualiza através de qualquer coisa que o instalou: uv, pipx, pip ou npm. Executar a linha de instalação novamente também atualizações. Uma vez que um dia código livre diz que quando existe uma versão mais recente; nunca se instala por si só.

Use the tool that installed it: uv tool uninstall freeai-code, pipx uninstall freeai-code, pip uninstall freeai-code or npm uninstall -g freeai-code. If the installer used its own private environment, delete the .free-code folder in your home directory and the free-code file in .local/bin.

Sim. free-code -p seguido de uma tarefa imprime a resposta e as saídas. Adicione --json para um resultado JSON e --yes para permitir edições de arquivos. Comandos perigosos permanecem bloqueados mesmo com --sim, e o código de saída diz-lhe se a tarefa foi bem sucedida.

Usa a mesma conta Free.ai. o free-code rc permite assistir e dirigir uma sessão de terminal do aplicativo Free.ai ou da página de sessões, e a nuvem de código livre executa uma tarefa na nuvem e reporta Free.ai de volta.

Comece a codificar com IA no seu terminal

curl -fsSL https://free.ai/install.sh | sh

Windows e outras opções de instalação · Sobre Free.ai Coder

Adoro Free.ai? Diga aos seus amigos!

Queres mais? Inscreva-se grátis: 30.000 tokens/dia Inscreva-se livre

Avalie esta página