Por que não no próprio projeto?
Um .env no projeto é o caminho mais curto para a chave ir parar no GitHub. Fora de qualquer projeto, nenhum git add alcança.
Um arquivo para as chaves de API dos agentes de IA, fora de qualquer projeto e com permissão só do dono, carregado em cada terminal.
ia/chaves-de-api
Risco baixo
Pede a senha de administrador
Testada em máquina virtual no Ubuntu e no Debian
Em resumo
~/.config/chaves-de-api, que só a sua conta abre.Passo a passo
As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.
Confere se a pasta e o arquivo existem, com as permissões 700 e 600 e a sua conta como dona, e se o .bashrc tem o bloco do bora.
.bashrc o bloco que carrega o arquivo.Confere as permissões, que outra conta não lê o arquivo, que ele não tem erro de sintaxe e, com uma chave de teste num arquivo temporário, que a chave chega ao terminal.
Tira o bloco do .bashrc. O arquivo só sai se continuar sem nenhuma chave.
No terminal
A saída de um teste no Ubuntu 24.04, com o OpenRouter escolhido.
Os porquês
Um .env no projeto é o caminho mais curto para a chave ir parar no GitHub. Fora de qualquer projeto, nenhum git add alcança.
O plano do bora é um arquivo que pode ir para o Git, ser mostrado a uma IA ou aplicado em outra máquina. Uma chave ali vazaria. Você cola a chave direto no arquivo, num editor.
O OpenRouter dá acesso a vários modelos com uma chave só, alguns gratuitos. A DeepSeek costuma ser das mais baratas. Os planos mudam o tempo todo; confira na página de cada um.
Como
Parâmetros
| Parâmetro | Padrão | O que é |
|---|---|---|
provedor | nenhum | Vai usar chave de API de algum provedor?
|
usuario | auto | A conta que vai programar. "auto" é quem rodou o bora com sudo. |
No menu, o bora pergunta o que precisa. Num script ou num agente, passe os parâmetros na linha de comando:bora plano --receitas ia/chaves-de-api -p ia/chaves-de-api.provedor=openrouter
Confira você mesmo
ls -l ~/.config/chaves-de-apiMostra que só você lê o arquivo (-rw-------).printenv OPENROUTER_API_KEYNum terminal novo, mostra se a chave chegou.Onde funciona
| Distro | Onde | Data | Resultado |
|---|---|---|---|
| Debian 13 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Ubuntu 24.04 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Ubuntu 26.04 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Debian 13 | Máquina virtual | 09/11/2026 | Passou |
| Ubuntu 24.04 | Máquina virtual | 09/11/2026 | Passou |
| Ubuntu 26.04 | Máquina virtual | 09/11/2026 | Passou |
Testada em contêiner: passou nos testes automáticos dessa família, que rodam num contêiner a cada pull request, sem kernel, disco nem tela de login de verdade. Testada em VM: além disso, foi aplicada, conferida e desfeita numa máquina virtual (VM) de verdade, o que o CI faz toda semana. O registro acima mostra a última vez de cada distro. Enquanto uma receita só tem o teste em contêiner, o bora avisa quando monta o plano. Testar numa máquina sua é uma das ajudas mais valiosas.
Onde ela entra
Fontes
Bora melhorar
Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.
Uma opção nova, um comportamento diferente ou algo que esta receita ainda não faz.
Fazer um pedidoUsa Fedora, Arch ou outra família? Diga qual, e conte se puder testar.
Pedir outra distroUma mudança que o bora ainda não sabe fazer, dentro deste rolê ou fora dele.
Pedir uma receitaAlgo não funcionou como esta página diz? O formulário já vem com o roteiro.
RelatarFicou confuso? Sugira um jeito melhor de dizer, direto no arquivo.
Ver no GitHub