# A CLI da LevelFour: custos de cloud e economia no seu terminal > O l4 leva custos, economia, commitments e estimativas de Terraform para o terminal e para o CI, com saída feita para scripts. Source: https://levelfour.ai/blog/cli-da-levelfour Updated: 2026-10-20 23 de setembro de 2026. Por Gabriel Nielsen. Engenheiro acompanha deploy, log e pull request pelo terminal. O `l4`, a CLI da LevelFour, coloca o custo de cloud no mesmo lugar: quanto você gastou, quanto pode economizar e quanto uma mudança no Terraform vai custar antes do apply. ## Instale e faça login ```bash brew install LevelFourAI/tap/levelfour l4 auth login l4 whoami ``` O [`l4 auth login`](https://docs.levelfour.ai/cli/authentication) abre o navegador e faz o seu login, e o `l4 whoami` mostra a identidade e a organização da credencial em uso. Esse login gera uma chave só de leitura. Os comandos que registram uma decisão pedem uma API key de leitura e escrita, que você cria no dashboard em [Settings > API Keys](https://docs.levelfour.ai/account/api-keys). No CI, passe `LEVELFOUR_TOKEN` a partir de um secret. A instalação traz também um binário com o nome longo, `levelfour`, para as máquinas onde `l4` já é o nome de outra ferramenta, e a [documentação de instalação](https://docs.levelfour.ai/cli/installation) cobre o `go install` e os pacotes pré-compilados para Linux e Windows. ## O que ele faz - Custos: o [`l4 costs summary`](https://docs.levelfour.ai/cli/commands/costs) dá a visão geral, e o `l4 costs breakdown --tui` abre uma tela interativa no terminal, onde você detalha uma linha e muda o agrupamento na hora. - Economia: o [`l4 recommendations list`](https://docs.levelfour.ai/cli/commands/recommendations) mostra o que a LevelFour encontrou, e, com uma API key de leitura e escrita, `rec accept` e `rec reject` registram a decisão e [`rec execute`](https://docs.levelfour.ai/cli/commands/recommendations/execute) inicia o rollout. - Commitments: cobertura, utilização, renovações e os prazos que vencem em breve, na AWS e no Google Cloud. Todo comando do [`l4 commitments`](https://docs.levelfour.ai/cli/commands/commitments) é só de leitura. - Tags: tags dos provedores e virtual tags, com a cobertura e o custo de cada uma, e o [`l4 tags preview`](https://docs.levelfour.ai/cli/commands/tags/preview), um dry run que mostra quanto do gasto cada valor levaria antes de você criar ou substituir uma virtual tag a partir de um arquivo YAML. - Estimativas: o [`l4 estimate`](https://docs.levelfour.ai/cli/commands/estimate) precifica o Terraform de um diretório, e o [`l4 diff`](https://docs.levelfour.ai/cli/commands/diff), o que uma mudança acrescenta. - Agentes de IA: o [`l4 mcp install`](https://docs.levelfour.ai/cli/commands/mcp/install) configura o servidor MCP da LevelFour no Claude Code, no Claude Desktop, no Cursor, no VS Code e no Windsurf com um comando só. ## Feita para scripts Todo comando aceita as mesmas [flags de saída](https://docs.levelfour.ai/cli/output-formats): `--json`, `--jq` para filtrar dentro do próprio processo e `--template` para templates em Go. Os caminhos do JSON e os exit codes ficam estáveis de uma versão para outra: `2` quer dizer que um check encontrou alguma coisa, e `4`, que o `l4` não achou nenhuma credencial. Esta [receita](https://docs.levelfour.ai/cli/recipes) lista as dez maiores economias: ```bash l4 recommendations list \ --sort-by monthly_savings --sort-order desc \ --page-size 10 \ --jq '.data.data.items[] | {id: .recommendation_id, service, savings: .monthly_savings}' ``` ## Uma trava de custo no CI Rode o `l4 estimate` no pipeline com um limite. Quando o total mensal passa desse limite, o job sai com código `2`, e o pipeline consegue parar antes de qualquer deploy. Um job sem token sai com `4`, então faça o pipeline reagir só ao `2`. Com `--format github-comment`, a estimativa sai no formato de um comentário de pull request, e o [guia de CI/CD](https://docs.levelfour.ai/guides/ci-cd) traz os jobs prontos de GitHub Actions e GitLab CI. ```bash l4 estimate --fail-above 500 -q ./infra/ ``` ## Como começar A [documentação da CLI](https://docs.levelfour.ai/cli) cobre instalação, autenticação, todos os comandos e receitas testadas contra a API em produção. A CLI tem código aberto no [GitHub](https://github.com/LevelFourAI/levelfour-cli), onde você pode abrir issues. [Comece com a LevelFour](https://levelfour.ai/sign-up) e rode o seu primeiro `l4 costs summary` em poucos minutos. ## Perguntas frequentes ### Como instalo a CLI da LevelFour? Com Homebrew, rode `brew install LevelFourAI/tap/levelfour`. A documentação também explica o `go install` e os pacotes pré-compilados, inclusive para Windows. ### A CLI mexe nos recursos da minha cloud? Nenhum comando mexe sozinho na sua conta de cloud. Com uma API key de leitura e escrita, `rec accept` e `rec reject` registram uma decisão na LevelFour, e `rec execute` inicia o rollout lá dentro. ### Dá para usar a CLI como trava de custo no CI? Sim. O `l4 estimate --fail-above` sai com código `2` quando a estimativa mensal do Terraform passa do seu limite, e o `l4 diff` faz a mesma trava sobre o que uma mudança acrescenta. [O que é Shift-Left FinOps?](https://levelfour.ai/glossary/shift-left-finops.md). ## See what LevelFour can save you [Start free trial](https://levelfour.ai/sign-up) · [Get in touch](https://levelfour.cal.com/) ## About LevelFour The FinOps platform that actually cuts costs. One system of record for Cloud, SaaS, and AI spend. LevelFour applies each saving, or your engineers merge it as code. - **Cloud Savings**: 30% success fee on savings found and applied. No hidden charges, only pay on what you actually save. - **Pro**: $30 per month · Up to $2,500 spend/mo - **Scale**: $200 per month · Up to $7,500 spend/mo - **Enterprise**: Custom · Unlimited spend [Pricing](https://levelfour.ai/pricing.md) · [Guide for agents (llms.txt)](https://levelfour.ai/llms.txt) · [Documentation](https://docs.levelfour.ai) · MCP server: `https://mcp.levelfour.ai/mcp`