❓ 6.1 FAQ & Troubleshooting (Clean Release)
If you run into issues while using Old Dog AI, check the list below first. 99% of connection failures and common errors can be solved here.
🛠️ 1. Core connection errors (HTTP status codes)
❌ 401 Unauthorized (Authentication failed)
Cause: Your API key is incorrect, or the key was deleted/disabled in the console.
Fix: Verify the token status in the console; ensure you didn’t copy extra spaces/newlines; confirm the key is a complete string starting with sk-.
❌ 404 Not Found (Wrong endpoint)
Cause: The most common error. Usually your Base URL is wrong, or the path joining does not match the client’s requirement.
Fix: Check for typos; try adding/removing /v1. Most clients require https://api.olddog.shop/v1, while some clients (such as Chatbox) auto-append it and only need https://api.olddog.shop.
❌ 429 Too Many Requests (Insufficient credits or rate too high)
Cause: Your account balance is depleted, or you sent too many concurrent requests in a short time.
Fix: Check your balance in the console. If your balance is sufficient, review whether your program is doing high‑concurrency tests; add retries or lower request rate.
💻 2. CLI tool specific issues
👾 Claude Code: config changed but not taking effect
Cause: After the first installation, Claude Code requires one-time environment initialization to recognize the config file.
Fix: Follow the “initialization command” section in the docs. Start Claude Code once with temporary ANTHROPIC_BASE_URL set; after that it will load the config automatically.
♊ Gemini CLI: GEMINI_API_KEY is not set
Cause: Environment variables not applied, or the .env path is incorrect.
Fix: Verify the variable name spelling; if using a .env file, make sure the path is ~/.gemini/.env (note the dot folders). On Windows, after setting env vars you must restart the terminal for changes to apply.
📂 Codex: cannot find config.toml directory
Cause: The config directory was not created automatically.
Fix: Create the .codex directory manually. On Windows: mkdir "$env:USERPROFILE\.codex". On macOS/Linux: mkdir -p ~/.codex.
🤖 3. Model calling issues
❌ “Model not found”
Cause: The model name is wrong (for example claude-sonnet-4-6 typed as claude-sonnet-4.6), or your API key does not have access to that model.
Fix: Fill in the model name strictly according to the docs; sign in to the console and ensure your token is allowed to use “all models”.
📬 4. Still stuck?
If none of the above solves your issue, contact us via:
- Ticket system: submit a ticket in the console; we’ll reply within 24 hours.
- Official group: [Click to join our developer community]
- Email support: support@olddog.shop