Docs/IDE Integration & API/IDE Integration Troubleshooting

IDE Integration Troubleshooting

Sign-in fails

SymptomFix
Browser didn't openCommand palette → CodePus: Copy Device Code URL; open manually device_code expiredRe-trigger sign-in 401 UnauthorizedSign out & in; if unresolved, revoke device in Device Authorization and re-pair

5xx / 429

  • 429: follow the structured reason shown by the IDE. Check Quota & Rate Limits only when CodePus explicitly reports exhausted Credits or plan quota. Ordinary rate limiting does not mean the plan is exhausted; wait for Retry-After or switch to an available model
  • 502/503/504: provider commit state may be uncertain, so the IDE does not auto-replay the same request. It preserves progress and offers Continue, which starts a new continuation from the current state instead of resending the original request. Check usage only when the service explicitly reports a quota or reconciliation reason
  • TLS / certificates

  • Corporate proxy: export root CA, set NODE_EXTRA_CA_CERTS
  • Wrong system clock: sync time
  • Logs

  • Command palette → CodePus: Open Logs
  • Always include x-request-id when filing tickets
  • Still stuck

  • File a ticket: Customer Support
  • Provide: client version, OS, request_id, reproduction steps