Troubleshooting Codespaces clients

You can use Codespaces in your browser or through Visual Studio Code. This article provides troubleshooting steps for common client issues.

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. For more information, see "GitHub's products."

Visual Studio Code troubleshooting

When you connect a desktop version of Visual Studio Code to a codespace, you will notice few differences compared with working in a normal workspace but the experience will be fairly similar.

When you open a codespace in your browser using Visual Studio Code in the web, you will notice more differences. For example, some key bindings will be different or missing, and some extensions may behave differently. For a summary, see: "Known limitations and adaptions" in the Visual Studio Code docs.

You can check for known issues and log new issues with the Visual Studio Code experience in the microsoft/vscode repository.

Browser troubleshooting

If you encounter issues using codespaces in a browser that is not Chromium-based, try switching to a Chromium-based browser, or check for known issues with your browser in the microsoft/vscode repository by searching for issues labeled with the name of your browser, such as firefox or safari.

If you encounter issues using codespaces in a Chromium-based browser, you can check if you're experiencing another known issue with Visual Studio Code in the microsoft/vscode repository.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.