Skip to content

Commit 8df4ccc

Browse files
committed
Add free plan to Setup article
1 parent a5aa288 commit 8df4ccc

10 files changed

+63
-41
lines changed

docs/copilot/images/setup/command-center-open-chat.png

Lines changed: 0 additions & 3 deletions
This file was deleted.

docs/copilot/images/setup/copilot-chat-menu-command-center.png

Lines changed: 0 additions & 3 deletions
This file was deleted.
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 3 additions & 0 deletions
Loading
Lines changed: 2 additions & 2 deletions
Loading
Lines changed: 2 additions & 2 deletions
Loading

docs/copilot/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ MetaSocialImage: images/shared/github-copilot-social.png
1313
[GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) is your AI pair programmer tool in Visual Studio Code. Get code suggestions as you type or use Inline Chat in the editor to write code faster. Add new functionality or resolve bugs across your project with Copilot Edits, or use natural language in chat to explore your codebase.
1414

1515
> [!TIP]
16-
> You can get started for free with the [Copilot Free plan](https://github.com/copilot) if you don't yet have a Copilot subscription.
16+
> If you don't yet have a Copilot subscription, you can try out Copilot for free by signing up for the [Copilot Free plan](https://github.com/copilot)
1717
1818
GitHub Copilot can provide assistance in a variety of scenarios.
1919

docs/copilot/setup.md

Lines changed: 46 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -10,65 +10,81 @@ MetaSocialImage: images/shared/github-copilot-social.png
1010
---
1111
# Set up GitHub Copilot in VS Code
1212

13-
This tutorial walks you through setting up your GitHub Copilot subscription and installing the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension in Visual Studio Code. After you complete these steps, you can get started with GitHub Copilot in VS Code.
13+
This guide walks you through setting up your GitHub Copilot subscription and installing the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension in Visual Studio Code. After you complete these steps, you can get started with GitHub Copilot in VS Code.
1414

15-
For an overview of what you can do with GitHub Copilot in VS Code, see the [GitHub Copilot Overview](/docs/copilot/overview.md).
15+
> [!TIP]
16+
> If you don't yet have a Copilot subscription, you can try out Copilot for free by signing up for the [Copilot Free plan](TODO)
1617
17-
## Step 1: Set up your GitHub Copilot subscription
18+
## Install the GitHub Copilot extension
1819

19-
If you want to use GitHub Copilot, you either need an active subscription for GitHub Copilot in your personal account, or you need to be assigned a seat in a subscription managed by an organization or enterprise. Learn more about [billing for GitHub Copilot](https://docs.github.com/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot).
20+
To use Copilot in VS Code, install the GitHub Copilot extension.
2021

21-
| Account type | Instructions |
22-
| ------------ | ------------ |
23-
| Personal account | Set up a subscription to **GitHub Copilot Individual** with your personal GitHub account. You can [activate a one-time 30-day trial to evaluate GitHub Copilot](https://github.com/github-copilot/signup).<br/><br/>If you didn't yet activate your free trial for Copilot, the GitHub Copilot extension notifies you in VS Code.<br/><br/>![Copilot sign up notification in VS Code](images/setup/copilot-access-toast.png) |
24-
| Member of an organization | You need to be assigned a seat by an organization owner.<br/><br/>You can request access to **GitHub Copilot Business** from the [GitHub Copilot settings](https://github.com/settings/copilot) for your personal account.<br/><br/>![Screenshot of Copilot settings, showing how to request access from an organization.](images/setup/request-cfb-access-settings.png) |
22+
> <a class="install-extension-btn" href="vscode:extension/GitHub.copilot">Install the GitHub Copilot extension</a>
2523
26-
## Step 2: Install the GitHub Copilot extension
24+
> [!NOTE]
25+
> When you install the GitHub Copilot extension, the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension is also installed.
2726
28-
You use the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension to power your artificial intelligence (AI) suggestions in VS Code.
27+
## Sign in to your GitHub account
2928

30-
> <a class="install-extension-btn" href="vscode:extension/GitHub.copilot">Install the GitHub Copilot extension</a>
29+
To access Copilot, you need to sign in with your GitHub account. You can sign in directly from the Copilot Chat view.
3130

32-
When you install the GitHub Copilot extension, the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension is also installed.
31+
1. Open the Chat view by pressing `kb(workbench.action.chat.open)`
3332

34-
## Step 3: Sign in to GitHub
33+
![Screenshot that shows the Chat view in the Secondary Side Bar. The Chat view contains a button to sign up for Copilot Free plan.](images/setup/copilot-chat-view-new-user.png)
3534

36-
To use GitHub Copilot in Visual Studio Code, you must be signed into Visual Studio Code with a GitHub account that has access to GitHub Copilot.
35+
1. Sign in to your GitHub account:
3736

38-
If you didn't previously authorize VS Code in your GitHub account, you're prompted to sign in to GitHub in VS Code:
37+
* If you don't yet have a Copilot subscription, select **Start GitHub Copilot Free** and follow the steps to sign up for the Copilot Free plan.
3938

40-
![VS Code notification to sign into the Copilot extension](images/setup/copilot-auth-toast.png)
39+
![Screenshot of the Chat view, highlighting the button to sign up for Copilot Free plan.](images/setup/copilot-chat-view-start-free.png)
4140

42-
Alternatively, you can sign in to GitHub in VS Code by selecting the **Accounts** menu in the Activity Bar, and then **Sign in with GitHub to use GitHub Copilot**.
41+
The Copilot Free plan enables you to try Copilot for free, without the need for a credit card to sign up. Get more info about the [Copilot Free plan](https://github.com/copilot) in the GitHub documentation.
4342

44-
![Accounts menu in VS Code, showing the option to sign in with GitHub to use GitHub Copilot.](images/setup/vscode-accounts-menu.png)
43+
Alternatively, follow these steps to [sign up for a Copilot subscription](#set-up-a-github-copilot-subscription).
4544

46-
In your browser, GitHub requests the necessary permissions for GitHub Copilot. To approve these permissions, select **Authorize Visual Studio Code**.
45+
* If you already have a Copilot subscription, select **sign in to that account** to sign in to your GitHub account.
4746

48-
## Validation: Check the Copilot status
47+
![Screenshot of the Chat view, highlighting the link to sign in to existing Copilot account.](images/setup/copilot-chat-view-sign-in.png)
4948

50-
Now that you've signed up for GitHub Copilot and activated the extension, let's verify that it's actually active.
49+
Alternatively, you can sign in to GitHub in VS Code by selecting the **Accounts** menu in the Activity Bar, and then **Sign in with GitHub to use GitHub Copilot**.
5150

52-
1. Open Visual Studio Code.
51+
![Accounts menu in VS Code, showing the option to sign in with GitHub to use GitHub Copilot.](images/setup/vscode-accounts-menu.png)
5352

54-
1. Notice the GitHub Copilot icon next to the Command Center that gives you quick access to Copilot functionality in VS Code.
53+
## Get started with Copilot in VS Code
5554

56-
![Screenshot showing the GitHub Copilot icon in the Command Center in VS Code.](./images/setup/copilot-chat-menu-command-center.png)
55+
After you've signed in to your GitHub account and have access to Copilot, start to explore AI-powered coding in VS Code.
5756

58-
1. Select the Copilot icon and select **Open Chat** to open the Chat view.
57+
1. Verify that the Chat view (`kb(workbench.action.chat.open)`) shows the Copilot welcome message and you can enter a prompt in the chat input box.
5958

60-
The Copilot Chat view should open in the Secondary Side Bar, where you can chat with Copilot.
59+
![The Chat view opens in the Secondary Side Bar and shows the Copilot welcome message.](images/setup/copilot-chat-view-welcome.png)
6160

62-
![Screenshot showing the Chat view in the Activity Bar in VS Code.](./images/setup/command-center-open-chat.png)
61+
1. Continue with the [Copilot Quickstart](/docs/copilot/getting-started.md) to discover the key features of Copilot in VS Code.
62+
63+
## Set up a GitHub Copilot subscription
64+
65+
To use Copilot, you need to have access to Copilot with your GitHub account. You can have Copilot associated with your personal account, or you might be assigned a seat in a subscription managed by an organization or enterprise.
66+
67+
| Account type | Instructions |
68+
| ------------ | ------------ |
69+
| Personal account | <li>Sign up for the [Copilot Free plan](https://github.com/github-copilot/signup) with your personal GitHub account to try out Copilot for free, without the need for a credit card. Get more info about the [Free plan details and limitations](TODO).</li><li>Set up a subscription to **GitHub Copilot Pro** with your personal GitHub account. You can [activate a one-time 30-day trial to evaluate GitHub Copilot](https://github.com/github-copilot/signup/copilot_individual).</li> |
70+
| Member of an organization | <li>You can request access to **GitHub Copilot Business** from the [GitHub Copilot settings](https://github.com/settings/copilot) for your personal account. You need to be assigned a seat by an organization owner.</li><br/>![Screenshot of Copilot settings, showing how to request access from an organization.](images/setup/request-cfb-access-settings.png) |
71+
72+
Learn more about [billing for GitHub Copilot](https://docs.github.com/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot).
6373

6474
## Sign out of GitHub Copilot
6575

6676
If your Copilot subscription is associated with another GitHub account, sign out of your GitHub account in VS Code, and sign in with another account.
6777

68-
To sign out of your GitHub account in VS Code, select the **Accounts** menu in the Activity Bar, and then select **Sign out** for the account you're currently signed in with for Copilot.
78+
1. Select the **Accounts** menu in the Activity Bar, and then select **Sign out** for the account you're currently signed in with for Copilot.
6979

70-
![Accounts menu in VS Code, showing the option to sign out of the current GitHub account.](images/setup/vscode-accounts-menu-signout.png)
80+
![Accounts menu in VS Code, showing the option to sign out of the current GitHub account.](images/setup/vscode-accounts-menu-signout.png)
81+
82+
1. Sign in to GitHub in VS Code by selecting the **Accounts** menu in the Activity Bar, and then **Sign in with GitHub to use GitHub Copilot**.
83+
84+
![Accounts menu in VS Code, showing the option to sign in with GitHub to use GitHub Copilot.](images/setup/vscode-accounts-menu.png)
7185

7286
## Next steps
7387

74-
You've successfully set up Copilot in VS Code with your GitHub Copilot subscription. Continue your journey and discover the key features of GitHub Copilot in VS Code with the [Copilot Getting Started Tutorial](/docs/copilot/getting-started.md).
88+
* Continue with the [Copilot Quickstart](/docs/copilot/getting-started.md) to discover the key features of Copilot in VS Code.
89+
90+
* Check our [Copilot cheat sheet](/docs/copilot/copilot-vscode-features.md) for an overview of the key Copilot commands and shortcuts.

0 commit comments

Comments
 (0)