Troubleshooting
| Problem | Solution |
|---|---|
OPENROUTER_API_KEY não configurada |
/key openrouter in the chat or ai --key openrouter. |
Arquivo de credenciais não encontrado or Conta 'X' sem login |
/account login X. |
You've hit your session limit |
Account quota. ai moves to the next one; add another with /account add or a key with /key claude. |
Individual quota reached (Antigravity) |
Antigravity quota; it is skipped until it renews. |
Not inside a trusted directory (Codex) |
Old install. Run the installer again. |
Claude Code não instalado |
./scripts/install.sh (or scripts\install.ps1 on Windows) installs it with the official installer. |
| Windows: skill links fail | Turn on Developer Mode or run as administrator; otherwise ai uses folder junctions. |
Windows: este pedido não pode ser passado com segurança |
The tool was installed through a .cmd shim ai does not recognize. Install it with npm or set <TOOL>_BIN to its executable. |
/model changes nothing |
A SMART_AI_*_MODEL variable is set and takes precedence. |
/key changes nothing |
The tool's variable (ANTHROPIC_API_KEY etc.) is set and takes precedence. |
Sessão já aberta em outro terminal |
Close the other terminal or use /new. |
ai: command not found |
Add ~/.local/bin to the PATH. |
This text comes from the project README. See the original on GitHub