Debug a Network Issue
Workflow for troubleshooting API call and network failures
CLAUDE.md
When debugging a network issue:
- Check the HTTP status code and response body of the failed request.
- Verify the request URL, method, headers, and body are correct. Log the outgoing request.
- Test the endpoint independently with curl or a REST client to isolate whether the issue is in your code or the server.
- Check for CORS errors in the browser console.
- Check for SSL/TLS certificate issues.
- Check if the server is reachable: DNS resolution, firewall rules, VPN requirements.
- Check for timeout issues: is the server responding slowly? Is the timeout configured correctly?
- Check auth: is the token expired, missing, or malformed?
Copy this workflow into your CLAUDE.md or agent config file so your agent follows this process automatically.