AI 도구 연동 매뉴얼

바이브 코딩의 핵심 — IDE·터미널·GitHub에서 AI 보조 도구를 연결하는 레퍼런스  |  공식 문서: docs.github.com/copilot

바이브 코딩 도구 지형도

AI 보조 도구는 작업하는 자리(IDE 안 · 터미널 · GitHub 위)에 따라 역할이 갈린다. 아래 트리로 전체 지형을 먼저 잡고, 각 항목은 해당 섹션에서 자세히 다룬다.

바이브 코딩 AI 도구
├── IDE 안                                  # 코드 편집기 통합
│   ├── Copilot 자동완성                       # 인라인 제안, Tab 수락
│   ├── Copilot Chat                          # 대화형, /explain·/fix·/tests
│   └── Copilot 코드 리뷰                      # PR/변경분 자동 피드백(Comment)
├── 터미널                                  # 명령줄 에이전트
│   ├── copilot (신규 Copilot CLI)            # npm @github/copilot
│   ├── gh copilot (레거시 · 아카이브)         # 2025-10-30 아카이브
│   └── claude (Claude Code)                  # 코드베이스 읽기·편집·git
└── GitHub 위                               # 클라우드 자동화
    ├── Actions @claude                       # 이슈/PR 멘션으로 작업
    └── MCP 서버                              # 외부 데이터/도구 연결 표준

1. GitHub Copilot (IDE)

Copilot은 코드 편집기 안에서 자동완성·대화·코드 리뷰 세 가지 형태로 동작한다. VS Code·Visual Studio·JetBrains·Xcode에 통합되며, 플랜은 Free/Pro/Pro+/Max/Business/Enterprise로 나뉘고 학생·교사·인기 오픈소스 메인테이너에게는 무료가 제공된다.

Copilot 자동완성 — 작성 중인 코드의 다음 줄/블록을 인라인 제안

코드를 입력하는 동안 다음 줄이나 블록을 회색 고스트 텍스트로 제안한다. Tab으로 수락하고, 무시하면 그대로 사라진다. 함수 시그니처나 주석으로 의도를 적으면 더 정확한 제안이 나온다.

# 주석으로 의도를 적으면 구현을 인라인 제안 → Tab 수락
# 이메일 형식을 검증하는 함수
def validate_email(value):
    ...   # ← Copilot이 정규식 검증 본문을 제안

Copilot Chat — 대화형 AI 어시스턴트

IDE·GitHub.com·모바일·터미널에서 자연어로 코드를 묻고 고친다. 슬래시 명령으로 자주 쓰는 작업을 빠르게 호출하고, 참가자와 변수로 문맥을 지정한다.

• 슬래시 명령: /explain(설명), /fix(수정), /tests(테스트 생성), /doc(문서화)
• 참가자: @workspace(작업공간 전체), @github, @terminal, @vscode
• 변수: #file(파일), #selection(선택 영역), #function(함수)

/tests
@workspace 인증 흐름 설명

Copilot 코드 리뷰 — PR/변경분에 자동 피드백

GitHub.com의 PR Reviewers에서 Copilot을 선택하면 변경분에 대한 피드백 코멘트를 단다(보통 30초). 저장소 설정으로 자동 리뷰를 켤 수도 있다. 단, 결과는 "Comment" 형태라 승인·머지 차단에는 영향이 없으며 사람 리뷰를 대체하지 않는다.

# GitHub.com PR 화면 → Reviewers → Copilot 선택
# 또는 저장소 설정에서 자동 코드 리뷰 활성화

2. 터미널 CLI 도구 (Copilot CLI)

터미널에서 AI 보조를 쓰는 길은 두 가지지만, 둘은 세대가 다르다. 레거시 gh-copilot 확장은 2025-10-30에 아카이브되었고, GitHub는 별도 설치형 신규 Copilot CLI(copilot)로 이전을 권장한다.

copilot — 신규 Copilot CLI (설치형 에이전트)

터미널용 에이전트형 도구로, 명령 추천을 넘어 코드 변경·PR 생성·이슈/워크플로 관리까지 수행한다. Node 22+와 Copilot 구독이 필요하며, npm으로 전역 설치한 뒤 copilot으로 대화형 세션을 연다. 첫 실행 시 /login으로 인증하고, Shift+Tab으로 플랜 모드를 전환한다.

npm install -g @github/copilot     # Node 22+, Copilot 구독 필요
copilot                            # 대화형 세션 시작
# 첫 실행: /login 으로 인증
copilot -p "Show me this week's commits" --allow-tool='shell(git)'

신규 위 copilot이 현재 권장되는 터미널 도구다.

gh copilot suggest / gh copilot explain — 레거시 확장 (아카이브됨)

레거시 github/gh-copilot 확장은 2025-10-30에 아카이브되었다. gh copilot suggest는 작업 설명을 명령으로 추천하고 gh copilot explain은 명령을 설명한다. ghcs·ghce 별칭이 있으나, 신규 copilot CLI로 이전이 권장된다. 기존 환경 호환을 위해 병기 참고용으로만 둔다.

gh extension install github/gh-copilot   # (레거시) 확장 설치
gh copilot suggest "압축 파일을 풀어라"        # 명령 추천
gh copilot explain 'tar -xzf archive.tar.gz' # 명령 설명

copilot 권한/플랜 모드 — 도구 실행 통제

에이전트형이므로 셸 명령 실행 권한을 명시적으로 통제한다. --allow-tool로 허용 도구를 한정하고, Shift+Tab 플랜 모드로 실제 실행 전 계획을 먼저 검토한다.

copilot -p "최근 커밋 요약" --allow-tool='shell(git)'
# 세션 안에서 Shift+Tab → 플랜 모드(실행 전 계획 확인)

3. Claude Code

Claude Code는 코드베이스를 읽고 직접 편집·명령 실행하는 에이전트형 CLI다. git과 연동되어 스테이징·커밋 메시지·브랜치 작업을 자연어로 수행하며, PR은 gh pr create를 사용한다. 비대화 헤드리스 모드와 GitHub Actions 통합으로 자동화까지 확장된다.

claude — 대화형 코드 에이전트

설치 후 claude로 세션을 열고 자연어로 작업을 지시한다. 변경 스테이징·커밋·브랜치·PR 같은 git 작업을 그대로 말로 시킬 수 있다.

curl -fsSL https://claude.ai/install.sh | bash   # 또는 brew / winget
claude                                            # 대화형 세션
claude "commit my changes with a descriptive message"
# 세션 안에서: create a pr

AI 생성 커밋에 공동저자를 표기하는 Co-Authored-By 트레일러는 널리 알려진 관례다. 자동 부착 여부는 환경·버전에 따르므로, 일반 모범사례로만 참고한다.

claude -p — 헤드리스(비대화) 모드

Unix 파이프로 입력을 받아 비대화로 한 번 실행하는 모드다. CI나 스크립트에서 로그 요약·변경분 점검 같은 작업을 파이프라인에 끼워 넣을 때 쓴다.

git log --oneline -20 | claude -p "summarize these recent commits"
git diff main --name-only | claude -p "review these changed files for security issues"

@claude (GitHub Actions) — 멘션으로 이슈/PR 자동 처리

PR이나 이슈 코멘트에서 @claude를 멘션하면 분석·구현·버그 수정·PR 생성을 수행한다. claude 세션에서 /install-github-app(저장소 admin 권한 필요)으로 App을 설치하고 ANTHROPIC_API_KEY 시크릿을 등록한 뒤, 액션 anthropics/claude-code-action@v1을 워크플로에 추가한다.

name: Claude Code
on:
  issue_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

코멘트 예: @claude implement this feature based on the issue description. v1.0의 breaking change로 태그는 @beta→@v1, direct_prompt→prompt로 바뀌었고, model·max-turns는 claude_args로 전달한다.

4. MCP · GitHub MCP 서버 · Claude 모델

MCP(Model Context Protocol)는 AI 도구를 외부 데이터·도구에 잇는 개방 표준이다. GitHub MCP 서버를 붙이면 저장소·이슈·PR·워크플로를 자연어로 다룰 수 있고, Claude Code에서는 작업에 맞춰 모델을 골라 쓴다.

GitHub MCP Server — 저장소를 자연어로 다루는 서버

원격 URL https://api.githubcopilot.com/mcp/를 쓰면 Docker 없이 연결되고, 로컬 실행이 필요하면 컨테이너 이미지 ghcr.io/github/github-mcp-server를 쓴다. 툴셋은 context·repos·issues·pull_requests·actions 등으로 나뉜다.

# 원격(Docker 불필요)
https://api.githubcopilot.com/mcp/
# 로컬 컨테이너
ghcr.io/github/github-mcp-server

--model (claude_args) — 작업에 맞는 Claude 모델 선택

Actions나 CLI에서 작업 성격에 맞춰 모델을 지정한다. 깊은 추론은 Opus, 일상 작업은 Sonnet, 빠른 처리는 Haiku를 고르는 식이다. 액션에서는 claude_args로 넘긴다.

# GitHub Actions에서 모델 지정
claude_args: "--model claude-sonnet-4-6"

2026-06-16 기준 Claude 모델은 다음과 같다(모델 ID는 원형 유지).

MCP 툴셋 — 작업 범위를 도구 그룹으로 한정

GitHub MCP 서버는 기능을 툴셋 단위로 묶어 제공한다. 필요한 툴셋만 켜서 노출 범위와 권한을 좁히는 것이 안전하다.

• context: 현재 사용자·저장소 문맥
• repos: 저장소 파일·내용 조회
• issues / pull_requests: 이슈·PR 조회·생성·코멘트
• actions: 워크플로 실행·상태 조회

참고 링크

• 📖 GitHub Copilot 공식 문서 (docs.github.com/copilot)
• ⚙️ GitHub MCP Server (github.com/github/github-mcp-server)
• 📦 gh-copilot 확장 (레거시 · 아카이브)
• 🤖 Claude Code 문서 (code.claude.com/docs)
• 🔧 claude-code-action (GitHub Actions)

최신 버전 기준 | 2026년 6월