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.
curl -fsSL https://free.ai/install.sh | sh
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-...
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
| Comando | O que faz |
|---|---|
free-code | Iniciar uma sessão interativa nesta pasta |
free-code -c | Continuar 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 sessions | Listar as sessões guardadas você pode retomar |
free-code tools | Mostrar as ferramentas que o agente pode usar e que precisam de aprovação |
free-code cloud "..." --repo URL | Executar uma tarefa na nuvem Free.ai e obter um relatório |
free-code tasks | Listar suas tarefas recentes em nuvem |
free-code rc | Assista e dirija a sessão do aplicativo Free.ai |
free-code mcp add | Conectar um servidor MCP |
free-code update | Atualizar para a versão mais recente |
free-code config | Mostra 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.
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
Comece a codificar com IA no seu terminal
curl -fsSL https://free.ai/install.sh | sh