Pular para o conteúdo
omni

Chaves de API

Além das assinaturas, cada ferramenta aceita uma chave de API. A assinatura vem primeiro; a chave só entra quando a assinatura falha ou bate no limite, porque chave é cobrada por uso. O OpenRouter funciona só com chave.

Ferramenta Comando Variável que o CLI recebe Onde criar
Claude /key claude ANTHROPIC_API_KEY console.anthropic.com/settings/keys
Codex /key codex CODEX_API_KEY platform.openai.com/api-keys
Antigravity /key agy GEMINI_API_KEY aistudio.google.com/apikey
OpenRouter /key openrouter OPENROUTER_API_KEY openrouter.ai/keys
Cursor /key cursor CURSOR_API_KEY cursor.com/dashboard → Integrations
Grok /key grok XAI_API_KEY console.x.ai
DeepSeek /key deepseek DEEPSEEK_API_KEY platform.deepseek.com/api_keys
Groq (classificador) /key groq GROQ_API_KEY console.groq.com/keys
Cerebras (classificador) /key cerebras CEREBRAS_API_KEY cloud.cerebras.ai

O Cursor usa primeiro o login da conta (cursor-agent login) e só depois as chaves. O DeepSeek, como o OpenRouter, funciona só com chave e mascara dados pessoais antes do envio. Groq e Cerebras não respondem perguntas: só classificam cada pedido (grátis) e checam se um pedido da fila já foi resolvido.

ai [auto] › /key claude
Chave de claude (console.anthropic.com/settings/keys). Cole e tecle Enter; ela não aparece na tela.
>
✓ Chave de claude salva em ~/.config/smart-ai/keys/claude (permissão 600).

As chaves ficam em ~/.config/smart-ai/keys/, uma por arquivo, com permissão 600, e são passadas só ao processo da ferramenta, nunca ao histórico nem ao log. Se a variável já estiver definida no ambiente, ela tem precedência. /key lista o que está configurado, mostrando só o início e o fim de cada chave.

No Claude, a chave funciona como uma conta extra depois de todas as assinaturas: se ela também bater no limite, entra em cooldown como as outras.

Nunca cole uma chave como comando no shell. Ela fica gravada no histórico do zsh. Se isso acontecer, revogue a chave no site da ferramenta e apague a linha de ~/.zsh_history.

No OpenRouter, o padrão é usar só modelos gratuitos: o cliente escolhe até três variantes :free do catálogo e usa openrouter/free como última alternativa. Modelos pagos ficam bloqueados até você autorizar:

/model openrouter_paid on            # autoriza; avisa que será cobrado na sua conta
/model openrouter anthropic/claude-opus-5.5
/model openrouter_paid off           # bloqueia de novo e volta ao gratuito

Com a autorização ligada, o modelo escolhido vem primeiro e os gratuitos ficam como reserva. Desligada, o limite de preço zero é enviado em toda chamada, então nenhum modelo pago responde.

Este texto vem do README do projeto. Ver o original no GitHub