Pular para o conteúdo
Linux para todos os rolês
  1. Rolês e receitas
  2. Receitas
  3. Chaves de API guardadas

Chaves de API guardadas

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
O arquivo de chaves fica em ~/.config, fora dos projetos, com permissão só da dona. Cada terminal novo carrega as chaves, e os agentes as encontram nas variáveis de ambiente. ~/.config/chaves-de-api/chaves.env -rw------- dani OPENROUTER_API_KEY=sk-or-… cada terminal novo carrega as chaves (~/.bashrc) os agentes acham fora do Git e de outras contas
Ilustração. A chave fica num lugar só, longe dos projetos.

Em resumo

O que faz e o que não faz

O que faz

  • Cria um arquivo para as chaves de API em ~/.config/chaves-de-api, que só a sua conta abre.
  • Carrega as chaves em cada terminal novo, onde os agentes as procuram.
  • Diz onde criar cada chave, com o provedor que você escolheu no topo do arquivo.

O que não faz

  • Não recebe a sua chave pelo bora: o plano pode ir para o Git ou para uma IA, então você cola a chave no arquivo, depois.
  • Não manda as chaves para lugar nenhum.
  • Não apaga o arquivo no desfazer se você já colou alguma chave.

Passo a passo

Como o bora aplica esta receita

As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.

  1. Verificar já está aplicada?

    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.

  2. Aplicar faz a mudança

    • Cria a pasta e o arquivo, se não existirem, já com a permissão só da pessoa.
    • Acrescenta ao .bashrc o bloco que carrega o arquivo.
  3. Testar funcionou?

    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.

  4. Desfazer quando você pedir

    Tira o bloco do .bashrc. O arquivo só sai se continuar sem nenhuma chave.

No terminal

Uma aplicação de verdade

A saída de um teste no Ubuntu 24.04, com o OpenRouter escolhido.

Os porquês

Por que assim

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.

Por que o bora não pergunta a chave?

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.

Qual provedor escolher?

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

O que muda no sistema

Parâmetros

O que dá para escolher

ParâmetroPadrãoO que é
provedornenhumVai usar chave de API de algum provedor?
  • nenhum: Não vou usar chave de API por enquanto.
  • openrouter: OpenRouter, que dá acesso a vários modelos, alguns gratuitos.
  • deepseek: DeepSeek, com a API dos modelos da DeepSeek.
  • outro: Outro provedor, como Anthropic, OpenAI, Google ou Mistral.
usuarioautoA 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

Os comandos para conferir

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

Distros e testes

UbuntuTestada em VMUbuntu, Mint, Pop!_OS, Zorin
DebianTestada em VMDebian 13
FedoraPlanejadaFedora, Nobara
ArchPlanejadaArch, CachyOS, EndeavourOS, Manjaro
Fedora imutávelPlanejadaBazzite, Silverblue, Kinoite
openSUSEPlanejadaTumbleweed, Leap

Registro de testes

DistroOndeDataResultado
Debian 13Contêiner (teste automático)09/11/2026Passou
Ubuntu 24.04Contêiner (teste automático)09/11/2026Passou
Ubuntu 26.04Contêiner (teste automático)09/11/2026Passou
Debian 13Máquina virtual09/11/2026Passou
Ubuntu 24.04Máquina virtual09/11/2026Passou
Ubuntu 26.04Máquina virtual09/11/2026Passou

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

Rolês que usam esta receita

Fontes

Para ler mais

Bora melhorar

Falta alguma coisa?

Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.