muaco Tech Note

GitHub Copilotgithub.blog

GitHub Copilot 앱 세션을 VS Code에서 이어 가는 방법

GitHub Copilot 앱에서 에이전트가 하던 세션을 VS Code로 열어 대화와 코드 변경을 이어받고, 검토와 수정, 실행을 거쳐 푸시까지 마칩니다.

안녕하세요, muaco입니다.

앱에서 하던 작업을 VS Code에서 그대로 잇습니다

GitHub Copilot 앱에서 에이전트가 하던 작업은 버튼 하나로 VS Code에 그대로 열립니다. 대화와 계획, 코드 변경, 작업하던 폴더가 함께 넘어옵니다. 새 창에서 처음부터 다시 설명하지 않아도 됩니다.

끝까지 따라 하면 에이전트가 바꾼 코드를 검토하고, 손으로 고치고, 내 컴퓨터에서 돌려 본 뒤 푸시까지 마칩니다. 큰 줄기는 Copilot이 만들고 마무리는 사람이 맡는 방식입니다.

심부름센터에 일을 맡기면 직원이 알아서 여러 곳을 다녀옵니다. 이렇게 여러 단계를 스스로 처리하는 AI를 에이전트라고 부릅니다.

상담 창구에는 손님마다 상담 기록철이 따로 있습니다. 한 작업을 두고 주고받은 대화와 결과를 묶은 기록철, 이를 세션이라고 부릅니다.

이 글은 2026년 10월 19일에 올라온 GitHub 공식 블로그 안내와 지금의 VS Code 문서를 기준으로 합니다. 버튼과 메뉴 이름은 버전에 따라 달라질 수 있습니다.

미리 갖춰야 할 계정과 프로그램

여기서 하나라도 빠지면 아래 단계가 중간에 막힙니다. 하나씩 확인해 보세요.

  • GitHub Copilot 앱: 설치하고 GitHub 계정으로 로그인해 둡니다. macOS, Windows, Linux에서 돌아가고 Free를 포함한 모든 Copilot 요금제에서 쓸 수 있습니다. 내려받는 곳은 gh.io/app입니다.
  • 회사 계정이라면: Copilot Business나 Enterprise는 조직 관리자가 정책 설정에서 Copilot CLI를 켜 두어야 앱을 쓸 수 있습니다.
  • VS Code: 설치한 다음 Copilot 앱과 같은 GitHub 계정으로 연결해 둡니다.
  • 코드 변경이 있는 세션: 앱에서 에이전트가 이미 무언가를 고쳐 둔 세션이 하나 있어야 합니다.
  • 저장소 권한: 그 세션이 다루는 저장소에서 작업하고 푸시할 권한이 필요합니다. 마지막 단계에서 변경을 올리기 때문입니다.

VS Code 문서는 이어서 열 수 있는 대상을 "지원되는 로컬 세션"이라고 적어 둡니다. 클라우드 샌드박스(내 컴퓨터가 아니라 GitHub 서버에서 돌아가는 실행 환경)에서 돈 세션도 똑같이 열리는지는 문서에 나와 있지 않습니다.

Git 용어도 몇 개 나옵니다. 저장소는 프로젝트 파일과 변경 이력을 함께 넣어 둔 서랍입니다. 브랜치는 원본을 건드리지 않고 갈라져 나온 작업 줄기입니다.

같은 서랍을 쓰면서 작업대를 하나 더 펴 놓으면 두 일이 섞이지 않습니다. 이 작업대를 워크트리라고 부릅니다. 앱은 세션마다 따로 떨어진 작업 공간과 브랜치를 줄 수 있습니다.

풀 리퀘스트는 "이 변경을 합쳐 주세요"라고 올리는 검토 요청입니다. 블로그 예시는 풀 리퀘스트가 이미 걸린 세션을 이어받아 마지막에 그 요청을 갱신합니다.

전체 흐름은 이렇습니다.

따라 하기: 여는 데서 푸시까지

앱에서 VS Code로 넘기기

따라 하기
  1. Copilot 앱에서 이어 갈 세션을 열고 작업 내용과 계획, 대화를 훑어봅니다. 이 기록은 세션에 남아 있으니 따로 요약하거나 새 채팅에 옮겨 적지 않아도 됩니다.
  2. 세션 화면에서 Open in VS Code를 누릅니다. 편집기나 VS Code가 여러 개 뜨면 Copilot 앱과 같은 계정으로 연결해 둔 VS Code를 고르세요.
  3. VS Code가 열리면 Copilot 사이드바에 앱에서 하던 세션이 그대로 떠 있는지 확인합니다. 열린 폴더는 세션이 쓰던 워크트리 그대로라서 에이전트가 고친 파일이 이미 들어 있습니다.

바뀐 곳 검토하고 손보기

무엇이 바뀌었는지 줄 단위로 견주어 보여주는 화면을 diff라고 합니다. VS Code에서는 Source Control 보기가 이 화면을 맡습니다.

따라 하기
  1. Source Control 보기를 열고 파일을 하나씩 눌러 바뀐 줄을 봅니다. 에이전트가 고친 파일 목록이 보이면 세션의 작업 공간이 제대로 열린 상태입니다.
  2. 바뀐 줄마다 다섯 가지를 짚어 보세요. 문제를 실제로 풀었는지, 저장소 규칙을 따랐는지, 오류와 예외 상황을 다루는지, 바뀐 동작을 시험하는 테스트가 있는지, 상관없는 파일을 건드리지 않았는지입니다.
  3. 이유가 궁금한 곳은 사이드바에서 Copilot에게 묻습니다. 블로그는 "새 도우미 함수를 만들지 않고 이 함수를 고친 이유를 설명해 주세요. 이 변경이 영향을 줄 수 있는 동작도 짚어 주세요" 같은 질문을 예로 듭니다.
  4. 고칠 곳이 보이면 VS Code에서 파일을 직접 고칩니다. 화면 문구나 변수 이름을 다듬으면 같은 워크트리 안에서 에이전트 작업 위에 그대로 쌓입니다.

돌려 보고 올리기

커밋은 바뀐 내용을 이력에 한 칸 저장하는 일입니다. 푸시는 그 이력을 GitHub로 올리는 일입니다.

따라 하기
  1. VS Code의 통합 터미널(편집기 안에 붙은 명령 창)을 열고 저장소가 안내하는 검사 명령을 실행합니다. npm을 쓰는 프로젝트라면 블로그 예시처럼 npm install, npm test, npm run lint, npm run dev를 칩니다.
  2. 터미널에 localhost(내 컴퓨터 자신을 가리키는 주소)로 시작하는 주소가 찍히면 브라우저로 열어 봅니다. 화면을 바꾼 작업이라면 창 크기를 바꿔 보고, 불러오는 중인 화면과 빈 화면, 오류 화면도 살펴보세요.
  3. 남은 일은 Copilot에게 맡겨도 되고 직접 해도 됩니다. 세션이 이어져 있으니 "바뀐 문구에 대한 테스트를 추가하고 관련 테스트 파일을 실행해 주세요. 관련 없는 컴포넌트는 고치지 마세요"처럼 앞 맥락을 가리키는 요청도 알아듣습니다.
  4. 여럿이 함께 쓰는 저장소라면 푸시하기 전에 최종 변경을 한 번 더 확인합니다. 푸시하는 순간 이 작업을 추적하던 풀 리퀘스트가 바뀝니다.
  5. Source Control 보기나 터미널에서 커밋하고 푸시합니다. 터미널을 쓴다면 git status로 바뀐 파일을 보고, git add 뒤에 파일 이름을 붙여 담은 다음 git commit -m "Refine session changes"와 git push를 칩니다.
  6. GitHub에서 풀 리퀘스트 페이지를 열어 방금 올린 커밋이 보이는지 확인합니다. 세션의 워크트리와 브랜치에서 작업했으니 파일을 옮기거나 풀 리퀘스트를 다시 연결할 일은 없습니다.

무엇을 맡길지 헷갈린다면 이렇게 나눠 보세요. 저장소 전체를 훑는 분석이나 되풀이되는 수정은 Copilot에게, 고칠 곳을 정확히 아는 수정은 손으로 합니다. 둘을 번갈아 써도 됩니다.

막히기 쉬운 네 군데

자주 걸리는 곳을 증상, 원인, 해결 순서로 정리했습니다.

VS Code 목록에 앱 세션이 보이지 않습니다

  • 증상: VS Code의 Chat 보기나 Agents 창(에이전트 작업만 모아 보는 창)에 있는 세션 목록에 앱에서 하던 세션이 없습니다.
  • 원인: 다른 앱이 만든 세션은 외부 세션으로 분류되고, 처음에는 숨겨져 있습니다. 게다가 VS Code는 저장소에 연결된 세션 가운데 최근 7일 안에 갱신된 세션만 찾아옵니다.
  • 해결: 세션 목록 필터의 External에서 All이나 Last 7 Days를 고릅니다. Recent는 최근 두 개만 보여 줍니다. 설정에서는 chat.agentSessions.showExternal로 같은 필터를 바꿀 수 있습니다.

Open in VS Code를 누르면 편집기를 고르라고 합니다

  • 증상: 버튼을 눌렀는데 VS Code가 바로 열리지 않고 편집기 목록이 뜹니다.
  • 원인: 앱이 지원하는 편집기나 VS Code가 컴퓨터에 둘 이상 깔려 있으면 어느 쪽으로 열지 묻습니다.
  • 해결: Copilot 앱과 같은 GitHub 계정으로 연결해 둔 VS Code를 고릅니다. 블로그가 준비 조건으로 같은 계정 연결을 꼽고 있기 때문입니다.

회사 Copilot 계정으로는 앱을 쓸 수 없습니다

  • 증상: Copilot Business나 Enterprise 계정으로 로그인했는데 앱에서 세션을 시작하지 못합니다.
  • 원인: 이 두 요금제에서는 조직이나 엔터프라이즈 관리자가 정책 설정에서 Copilot CLI를 켜 두어야 앱이 동작합니다.
  • 해결: 사내 GitHub 관리자에게 Copilot CLI 정책을 켜 달라고 요청하세요. 정책 메뉴의 정확한 이름은 안내문에 나와 있지 않습니다.

필터를 꺼도 세션이 목록에 남아 있습니다

  • 증상: External을 None으로 돌렸는데 앱에서 가져온 세션이 계속 보입니다.
  • 원인: VS Code에서 메시지를 한 번이라도 보내면 그 세션은 더 이상 외부 세션이 아닙니다. 그래서 External 필터가 그 세션을 숨기지 않습니다.
  • 해결: 고장이 아니므로 그대로 쓰면 됩니다. 이제 VS Code에서 이어 가는 세션이 됐다는 표시입니다.

여기서 더 나아가려면

반대 방향으로도 옮길 수 있습니다. VS Code 세션 목록에서 세션을 오른쪽 클릭하고 Resume in Terminal을 고르면 Copilot CLI(터미널에 명령을 쳐서 쓰는 방식)에서 이어 갑니다.

앱에서 새 세션을 열 때는 Interactive, Plan, Autopilot 가운데 에이전트가 얼마나 스스로 움직일지 고릅니다. 처음이라면 계획을 먼저 보고 승인하는 Plan으로 시작해 보면 어떨까요?

이상으로 글 마치겠습니다.

참고한 공식 문서

#GitHub Copilot#Copilot 앱#VS Code#에이전트#세션 이어가기#워크트리#풀 리퀘스트

같은 분류의 글