GitHub Copilot 완벽 설치 가이드 2026 - VS Code, JetBrains, Neovim 멀티 에디터 설정 및 Copilot Business 조직 구성
GitHub Copilot 완벽 설치 가이드: VS Code부터 기업용 조직 설정까지
GitHub Copilot은 AI 기반 코드 자동 완성 도구로, 개발 생산성을 획기적으로 향상시킵니다. 이 가이드에서는 VS Code 확장 설치, JetBrains IDE 플러그인, Neovim 연동, 그리고 기업용 Copilot Business 조직 설정까지 전 과정을 단계별로 안내합니다.
1단계: GitHub Copilot 구독 활성화
Copilot을 사용하려면 먼저 GitHub 계정에서 구독을 활성화해야 합니다.
- GitHub.com에 로그인합니다.- 우측 상단 프로필 아이콘 → Settings를 클릭합니다.- 좌측 메뉴에서 Copilot을 선택합니다.- Enable GitHub Copilot 버튼을 클릭하고 플랜을 선택합니다.- 결제 정보를 입력하고 구독을 완료합니다.개인 사용자는 Copilot Individual(월 $10 또는 연 $100), 기업은 Copilot Business(사용자당 월 $19)를 선택할 수 있습니다. 학생과 오픈소스 메인테이너는 무료로 사용 가능합니다.
2단계: VS Code에서 GitHub Copilot 설치
VS Code는 Copilot을 가장 완벽하게 지원하는 에디터입니다.
확장 프로그램 설치
- VS Code를 실행합니다.- Ctrl+Shift+X로 확장 마켓플레이스를 엽니다.- 검색창에
GitHub Copilot을 입력합니다.- GitHub Copilot과 GitHub Copilot Chat 두 확장을 모두 설치합니다.- 설치 후 VS Code 우측 하단의 GitHub 아이콘을 클릭하여 로그인합니다.CLI를 통한 설치도 가능합니다:code —install-extension GitHub.copilot code —install-extension GitHub.copilot-chat
VS Code 설정 최적화
settings.json 파일에 다음 설정을 추가하여 Copilot을 최적화하세요:
{
"github.copilot.enable": {
"*": true,
"plaintext": false,
"markdown": true,
"yaml": true
},
"github.copilot.advanced": {
"length": 500,
"inlineSuggestCount": 3,
"listCount": 10
},
"editor.inlineSuggest.enabled": true,
"github.copilot.chat.localeOverride": "ko"
}
## 3단계: JetBrains IDE에서 Copilot 설치
IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains 계열 IDE에서도 Copilot을 사용할 수 있습니다.
- IDE를 실행하고 **File → Settings → Plugins**로 이동합니다.- **Marketplace** 탭에서 GitHub Copilot을 검색합니다.- **Install** 버튼을 클릭하고 IDE를 재시작합니다.- **Tools → GitHub Copilot → Login to GitHub**에서 인증합니다.CLI를 통한 확인:
# JetBrains 플러그인 디렉토리 확인 (Windows)
dir "%APPDATA%\JetBrains\IntelliJIdea*\plugins\github-copilot"
macOS / Linux
ls ~/Library/Application\ Support/JetBrains/IntelliJIdea*/plugins/github-copilot
4단계: Neovim에서 Copilot 설치
Neovim 0.6 이상에서 공식 Copilot 플러그인을 사용할 수 있습니다.
플러그인 매니저를 통한 설치
lazy.nvim을 사용하는 경우 init.lua에 다음을 추가합니다:
— lazy.nvim 설정
require(“lazy”).setup({
{
“github/copilot.vim”,
lazy = false,
config = function()
vim.g.copilot_no_tab_map = true
vim.api.nvim_set_keymap(“i”, "
설치 후 Neovim에서 다음 명령으로 인증합니다:
:Copilot setup
:Copilot enable
:Copilot status
5단계: Copilot Business 조직 설정 (기업용)
기업 환경에서는 Copilot Business를 통해 조직 단위로 관리할 수 있습니다. - GitHub 조직 페이지 → **Settings → Copilot**으로 이동합니다.- **Enable Copilot Business**를 클릭합니다.- 라이선스 할당 정책을 선택합니다: 전체 멤버 또는 선택적 할당.- 조직 정책을 구성합니다. ### 조직 정책 설정
| 정책 항목 | 설명 | 권장 설정 |
|---|---|---|
| Suggestions matching public code | 공개 코드와 일치하는 제안 차단 | Block (기업 권장) |
| Copilot Chat in IDE | IDE 내 채팅 기능 허용 | Enabled |
| Copilot Chat in GitHub.com | 웹 채팅 기능 허용 | Enabled |
| Copilot in CLI | 터미널 CLI 기능 허용 | Enabled |
# GitHub CLI 설치 확인
gh --version
조직 Copilot 상태 확인
gh api /orgs/YOUR_ORG_NAME/copilot/billing
특정 사용자에게 라이선스 할당
gh api —method POST /orgs/YOUR_ORG_NAME/copilot/billing/selected_users
-f selected_usernames[]=“developer1”
-f selected_usernames[]=“developer2”
라이선스 사용 현황 확인
gh api /orgs/YOUR_ORG_NAME/copilot/billing/seats
핵심 단축키 및 워크플로우
| 기능 | VS Code | JetBrains | Neovim |
|---|---|---|---|
| 제안 수락 | Tab | Tab | Ctrl+J (커스텀) |
| 제안 거부 | Esc | Esc | Ctrl+] |
| 다음 제안 | Alt+] | Alt+] | Alt+] |
| 이전 제안 | Alt+[ | Alt+[ | Alt+[ |
| 채팅 열기 | Ctrl+Shift+I | Ctrl+Shift+C | N/A |
// 사용자 이메일을 검증하고 도메인별로 그룹핑하는 함수- **파일 컨텍스트 활용**: 관련 파일을 에디터에서 열어두면 Copilot이 프로젝트 컨텍스트를 더 잘 이해합니다.- **Copilot Chat 슬래시 명령어**: /explain, /fix, /tests 명령을 사용하여 코드 설명, 버그 수정, 테스트 생성을 요청하세요.- **.github/copilot-instructions.md**: 프로젝트 루트에 이 파일을 생성하면 조직 코딩 컨벤션을 Copilot에 전달할 수 있습니다.- **멀티 에디터 동기화**: 동일 GitHub 계정으로 모든 에디터에서 로그인하면 사용 패턴이 자동으로 공유됩니다.
## Troubleshooting: 자주 발생하는 오류 해결
”GitHub Copilot could not connect to server” 오류
프록시 또는 방화벽 환경에서 자주 발생합니다. VS Code 설정에 프록시를 지정하세요:
{
"http.proxy": "http://proxy.company.com:8080",
"http.proxyStrictSSL": false,
"github.copilot.advanced": {
"debug.overrideProxyUrl": "http://proxy.company.com:8080"
}
}
### "You don't have access to GitHub Copilot" 오류
구독 상태와 조직 라이선스 할당을 확인하세요:
# 구독 상태 확인
gh api /user/copilot_billing/subscriptions
인증 갱신
gh auth refresh -s copilot
제안이 표시되지 않는 경우
- VS Code 우측 하단의 Copilot 아이콘 상태를 확인합니다.-
:Copilot status(Neovim) 또는 로그 출력을 확인합니다.- 해당 언어가 비활성화되어 있지 않은지settings.json의github.copilot.enable항목을 점검합니다.- 네트워크 연결 상태와 GitHub 서비스 상태(githubstatus.com)를 확인합니다.
자주 묻는 질문 (FAQ)
Q1: GitHub Copilot Individual과 Business의 차이점은 무엇인가요?
Copilot Individual은 개인 개발자를 위한 플랜으로 월 $10입니다. Copilot Business는 사용자당 월 $19로 조직 단위 관리, 공개 코드 매칭 차단 정책, 조직 전체 정책 설정, 감사 로그, IP 보상 등 기업에 필요한 보안 및 관리 기능을 제공합니다. 기업 코드의 보안이 중요하다면 Business 플랜이 권장됩니다.
Q2: 여러 에디터에서 동시에 Copilot을 사용할 수 있나요?
네, 하나의 GitHub 구독으로 VS Code, JetBrains IDE, Neovim 등 여러 에디터에서 동시에 사용 가능합니다. 각 에디터에 해당 플러그인을 설치하고 동일한 GitHub 계정으로 인증하면 됩니다. 동시 세션 수에 제한은 없으며 추가 비용도 발생하지 않습니다.
Q3: Copilot이 제안하는 코드의 저작권은 누구에게 있나요?
GitHub의 정책에 따르면 Copilot이 생성한 코드의 저작권은 사용자에게 있습니다. 다만 공개 코드와 유사한 제안이 나올 수 있으므로, 기업 환경에서는 Copilot Business의 “공개 코드 매칭 차단” 정책을 활성화하고, 중요 코드는 라이선스 검토를 수행하는 것을 권장합니다. Copilot Business 플랜에는 IP 보상 조항이 포함되어 있어 추가적인 법적 보호를 받을 수 있습니다.