Appendix B: Common Pitfalls

When configuration fails, work through this checklist:

1. Including or omitting /v1: most OpenAI-compatible base URLs require it; clients that append it do not. Claude Code uses the root URL. See the tool configuration reference.
2. Missing space after Bearer: use Authorization: Bearer sk-xxx with a space between the scheme and key.
3. Wrong credential type: sk- keys call model APIs; management access tokens call /api/ endpoints.
4. Model and group mismatch: the token's group may not provide the selected model.
5. Model ID case: IDs are case-sensitive. The source platform lists GLM-5.3 and glm-5.3 as separate entries; always copy the exact ID.
6. Old terminal environment: reopen the terminal after changing persistent environment variables, especially on Windows.
7. Wrong Claude Code variable: this configuration uses ANTHROPIC_AUTH_TOKEN; check that you have not accidentally set a different variable instead.
8. Key committed to Git: revoke the exposed key in the console and create a replacement.
9. Cached client configuration: restart the application after changes; closing its window may leave it running in the tray.
10. Different key for task queries: asynchronous tasks are tied to the API key used when submitting them.