403 Authorization failed
Cause
API key expired or was leaked
Fix
Generate a new key at build.nvidia.com → API Keys. Update it in your shell config and restart Docker with the new key.
Troubleshooting
Fast fixes for the most common setup and runtime issues across Claude Code, Docker, LiteLLM, and NVIDIA NIM.
Authentication & API
Docker & Container
Container not found / Cannot connect to Docker
Cause
Docker Desktop is not running
Fix
Open Docker Desktop and wait 10 seconds, then run: docker start litellm-nim
Installation & PATH
command not found: claude
Cause
Claude Code not in PATH after install
Fix
Close terminal and open a new one. If still broken, run: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Windows: command not found after restart
Cause
PATH not updated in PowerShell profile
Fix
Run: . $PROFILE to reload your PowerShell profile. If the function is missing, re-add it to $PROFILE.
Windows Specific
Windows: The token '&&' is not a valid statement separator
Cause
Running CMD command in PowerShell
Fix
Use the PowerShell version of the command (irm ... | iex) instead of the curl version.
Windows: command not found after restart
Cause
PATH not updated in PowerShell profile
Fix
Run: . $PROFILE to reload your PowerShell profile. If the function is missing, re-add it to $PROFILE.
Port & Network
Port 4000 already in use
Cause
Another service is using port 4000
Fix
Change -p 4000:4000 to -p 4002:4000 in the Docker command, and update ANTHROPIC_BASE_URL to http://localhost:4002 in your alias.
Model Issues
DEGRADED function cannot be invoked
Cause
NVIDIA model endpoint is overloaded
Fix
Edit config.yaml and change the model to a different one (e.g. swap qwen for gemma-4-31b-it). Run: docker restart litellm-nim