Skip to main content

Integrate GitHub Classroom with an IDE

You can preconfigure a supported integrated development environment (IDE) for assignments you create in GitHub Classroom.

Who can use this feature?

Organization owners who are admins for a classroom can integrate GitHub Classroom with an IDE. For more information on classroom admins, see "Manage classrooms."

About integration with an IDE

You can optionally configure an assignment to use an integrated development environment (IDE). IDEs allow your students to write code, run programs, and collaborate without installing Git and a full development toolchain on the student's computer. If you choose an IDE for an assignment, students can still check out and run code locally on a computer with the necessary software.

After a student accepts an assignment with an IDE, the README file in the student's assignment repository will contain a button to open the assignment in the IDE. The student can begin working immediately, and no additional configuration is necessary.

Supported IDEs

GitHub Classroom supports the following IDEs. You can learn more about the student experience for each IDE.

IDEMore information
GitHub Codespaces"Using GitHub Codespaces with GitHub Classroom"
Microsoft MakeCode Arcade"About using MakeCode Arcade with GitHub Classroom"
Visual Studio CodeGitHub Classroom extension in the Visual Studio Marketplace

We know cloud IDE integrations are important to your classroom and are working to bring more options.

Configuring an IDE for an assignment

You can choose the IDE you'd like to use for an assignment when you create an assignment. To learn how to create a new assignment that uses an IDE, see "Create an individual assignment" or "Create a group assignment."

Setting up an assignment in a new IDE

The first time you configure an assignment using a different IDE, you must ensure that it is set up correctly.

Unless you use GitHub Codespaces, you must authorize the OAuth app for the IDE for your organization. For all repositories, grant the app read access to metadata, administration, and code, and write access to administration and code. For more information, see "Authorizing OAuth apps."

GitHub Codespaces does not require an OAuth app, but you need to enable GitHub Codespaces for your organization to be able to configure an assignment with GitHub Codespaces. For more information, see "Using GitHub Codespaces with GitHub Classroom."

Further reading