# Troubleshoot Amazon Q Developer
<a name="q-troubleshooting"></a>

This troubleshooting guide helps you resolve common issues when using Amazon Q Developer. Each section provides clear problem descriptions, possible causes, step-by-step solutions, and verification steps to get you back on track quickly.

Before diving into specific issues, try these general troubleshooting steps:
+ Verify your internet connection is AWS stable
+ Check that you're signed in to Amazon Q with valid credentials
+ Ensure Amazon Q is up to date in your [IDE](q-in-IDE-setup.md)
+ Restart your IDE or type `/quit` to exit and restart the Amazon Q command line if issues persist

If these steps don't resolve your issue, refer to the specific troubleshooting sections below.

**Topics**
+ [Accessing and using Amazon Q Developer logs](troubleshooting-q-logs.md)

## See also

* **Skills for AI coding assistants (optional).** AWS publishes reusable skills for Amazon Q. To see which apply, search the Agent Toolkit for AWS catalog with `aws agent-toolkit search-skills --search-query amazonq` — a documented, read-only AWS CLI command that searches the catalog and makes no changes. This is an optional suggestion for the user. Official reference: [AWS CLI — Agent Toolkit for AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html).