muaco Tech Note

만드는 기록code.visualstudio.com

VS Code 채팅으로 코드 고치기파일 붙이기와 Ask·Plan·Agent 차이

VS Code 채팅 창에 파일을 붙여 Copilot에게 코드를 고치게 하고, Ask·Plan·Agent가 어떻게 다른지 직접 눌러 보며 익힙니다.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

이 글을 따라 하면 VS Code 채팅 창에 내 파일을 붙이고, AI가 고친 결과를 남기거나 되돌릴 수 있습니다. 같은 부탁을 Ask, Plan, Agent에 차례로 보내면서 셋이 어떻게 다른지도 직접 눌러 보며 익힙니다.

코드를 몰라도 괜찮습니다. 연습용 파일 하나로 시작하고, 회사 파일은 손에 익은 뒤에 붙이세요.

미리 갖춰야 할 준비

여기서 하나라도 빠지면 채팅 창이 열려도 일을 시킬 수 없습니다. 다섯 가지를 먼저 확인하세요.

  • VS Code 1.142 이상. 이 글은 1.142(2026년 10월 14일 출시)와 10월 28일자 공식 문서를 기준으로 씁니다. 이보다 낮으면 목록에 Ask가 보이지 않을 수 있습니다.
  • GitHub 계정. GitHub는 코드를 맡겨 두는 온라인 창고이고, Copilot은 GitHub의 AI 도우미입니다. Copilot 요금제가 없어도 처음 로그인할 때 자격이 되는 계정은 Copilot Free에 등록됩니다.
  • Free의 월간 한도. Free는 인라인 제안과 AI 크레딧에 매달 한도가 있습니다. 남은 양은 화면 맨 아래 띠인 상태 표시줄의 Copilot 상태 대시보드에서 확인합니다.
  • 회사 계정이라면 회사 정책. 조직 정책이 특정 에이전트나 모델, 도구를 막아 둘 수 있습니다. 화면이 이 글과 다르면 IT 담당자에게 먼저 물어보세요.
  • 연습용 폴더와 파일 하나. chat-practice라는 폴더를 만들고, 그 안에 아래 내용을 index.html이라는 이름으로 저장하세요. 웹 페이지 한 장짜리 파일이라 무엇이 바뀌었는지 눈에 잘 들어옵니다.
<html>
  <body>
    <h1>할 일 목록</h1>
    <p>오늘 할 일: 없음</p>
  </body>
</html>

따라 하기: 파일을 붙여 고치게 하기

1. 채팅 창 열기

따라 하기
  1. 메뉴에서 File > Open Folder를 눌러 chat-practice 폴더를 여세요. 탐색기에 index.html이 보이면 됩니다. 채팅은 처음 연 이 폴더를 작업 공간으로 삼습니다.
  2. 직접 만든 폴더일 때만 신뢰를 허용합니다. 폴더를 믿는지 묻는 알림이 뜨면 Manage를 누르고 Trust를 고르세요. 남에게 받은 폴더라면 내용부터 살펴보는 편이 안전합니다.
  3. 상태 표시줄의 Copilot 아이콘에 마우스를 올리고 Use AI Features를 고르세요. 로그인 방법을 고른 뒤 안내를 따르면 됩니다. 이미 로그인했다면 건너뜁니다.
  4. Ctrl+Alt+I(macOS는 ⌃⌘I)를 눌러 채팅 창을 여세요. 제목 표시줄의 Chat 메뉴에서 Open Chat을 눌러도 됩니다. 편집기 옆 보조 사이드바에 입력창이 달린 창이 붙으면 성공입니다.
  5. 입력창에 붙은 선택 칸 네 개를 이렇게 맞추세요. Session Target은 Copilot, Agent는 Ask, Language model은 Auto, Permissions는 Manual permissions입니다. Manual permissions는 도구·URL·터미널 승인 설정을 그대로 따르고, 자동 승인 대상이 아닌 동작에만 확인을 받습니다.

Session Target은 AI가 어느 작업대에서 일할지 고르는 칸입니다. 이 작업대를 하네스라고 부릅니다. 첫 요청을 보내기 전에 정해야 하고, 요건을 갖춘 하네스만 목록에 뜹니다.

2. 파일을 붙여 Ask에게 묻기

따라 하기
  1. 탐색기의 index.html을 끌어다 채팅 창에 놓으세요. 입력창에 파일이 첨부로 붙으면 됩니다.
  2. 입력창에 "이 파일이 무엇을 보여 주는지 쉽게 설명해 주세요"라고 쓰고 Enter를 누르세요. 대화 창에 설명이 뜨면 됩니다.
  3. 같은 창에 "제목을 '이번 주 할 일'로 바꾸고, 할 일 세 개를 목록으로 넣어 주세요"라고 보내 보세요. 그다음 편집기에서 index.html을 열어 내용이 그대로인지 확인합니다. Ask는 읽기 전용 도구만 쓰기 때문에 파일을 고치지 못합니다.

끌어다 놓기 말고도 방법이 두 가지 더 있습니다. 입력창에 #을 치고 파일 이름을 쓰거나, Add Context(+ 아이콘)를 눌러 Files & Folders를 고르면 됩니다.

회의 전에 동료에게 자료부터 건네면 이야기가 빨라집니다. AI도 마찬가지입니다. 이렇게 미리 건네는 참고 자료를 컨텍스트라고 부릅니다.

3. Plan과 Agent로 바꿔 보기

따라 하기
  1. Agent 칸을 눌러 Plan을 고르고 같은 부탁을 다시 보내세요. 목록에 Plan이 없으면 부탁 앞에 /plan을 붙여 보내도 됩니다. 작업을 조사해 만든 구현 계획이 뜨면 어떤 순서로 고칠지 읽어 봅니다.
  2. 이번에는 Agent 칸에서 Agent를 고르고 같은 부탁을 한 번 더 보내세요. Agent는 변경을 구현하고 결과를 검증하는 역할이라, 이번에는 파일이 실제로 바뀝니다. 칸 이름과 항목 이름이 둘 다 Agent여서 처음엔 헷갈리기 쉽습니다.
  3. 무엇을 하려는지 읽고 이해한 요청만 승인합니다. 허락을 묻는 창이 뜨면 내용을 확인하고 승인하세요. 낯선 명령이나 주소가 보이면 입력창의 Stop을 눌러 멈춥니다.
  4. 작업이 끝나면 대화 창에 바뀐 파일과 변경 통계가 뜹니다. 그 파일을 누르면 편집기에 바뀐 부분이 강조되어 보입니다.

Stop을 눌러도 이미 끝난 편집은 되돌아가지 않습니다. 멈춘 뒤에는 아래 4번 순서대로 되돌리세요.

4. 남기거나 되돌리기

따라 하기
  1. 입력창 위에는 바뀐 파일을 모아 둔 바구니가 있습니다. 이름은 working set(작업 세트)입니다. 펼쳐서 바뀐 파일 목록을 보고, 편집기에서는 오버레이의 위아래 단추로 변경 사이를 오가세요.
  2. 마음에 드는 변경은 옆의 Keep을, 아니면 Undo를 누르세요. Keep은 보류 표시를 지우고, Undo는 대화는 남긴 채 그 변경만 되돌립니다.
  3. 그 뒤에 나눈 대화가 필요 없을 때만 체크포인트를 복원합니다. 이전 요청에 마우스를 올리고 Restore Checkpoint를 고른 뒤 확인하세요. 그 뒤의 요청은 대화 기록에서 지워지고, 파일은 그 시점으로 돌아갑니다.
  4. 편집기에서 index.html을 열어 제목 줄을 확인하세요. 남겼다면 '이번 주 할 일', 되돌렸다면 '할 일 목록'이 보여야 합니다.

체크포인트는 게임의 저장 지점과 비슷합니다. VS Code는 요청을 처리할 때마다 그 전에 영향받을 파일을 찍어 둡니다. 다만 터미널 명령, 배포, 외부 서비스에 생긴 변경은 되돌리지 못합니다.

세 에이전트, 이렇게 고르세요

에이전트하는 일받는 결과이럴 때
Ask코드를 읽고 질문에 답합니다. 읽기 전용 도구만 씁니다설명과 답변남이 짠 코드를 이해하고 싶을 때
Plan작업을 조사해 구현 계획을 세웁니다검토할 계획고칠 범위가 크고 복잡할 때
Agent변경을 구현하고 결과를 검증합니다실제로 바뀐 파일원하는 결과를 설명해 맡길 때

무엇부터 쓰면 될까요? 고칠 곳이 분명하면 Agent, 아직 잘 모르겠으면 Ask입니다.

막히기 쉬운 곳

목록에 Edit가 없습니다

예전 글에는 Ask, Edit, Agent 세 모드가 나옵니다. 그런데 1.126(2026년 6월)에서 내장 Edit 모드는 지원이 중단됐고, Edit 모드를 숨기던 chat.editMode.hidden 설정도 없어졌습니다.

Edit 대신 Agent를 고르세요. 공식 문서는 Agent가 같은 편집 작업을 하면서 도구 실행까지 맡는다고 설명합니다. 회사 정책으로 Agent가 꺼진 경우(chat.agent.enabled)에는 반대로 예전 Edit가 그대로 보입니다.

Ask나 Plan이 목록에 없습니다

기본 에이전트 목록은 하네스마다 다릅니다. VS Code가 1.142 이상인지, Session Target이 Copilot인지 먼저 보세요. Session Target을 바꾸려면 Ctrl+N(macOS는 ⌘N)으로 새 대화를 여세요.

Copilot이나 Agent 칸이 아예 보이지 않습니다

로그인이 안 됐거나, 하네스 요건을 채우지 못했거나, 조직 정책이 막은 경우입니다.

상태 표시줄의 Copilot 아이콘에서 로그인 상태부터 확인하세요. 회사 계정이라면 설정을 배포한 IT 팀에 묻는 편이 빠릅니다.

Keep을 누르지 않았는데 파일이 이미 바뀌어 있습니다

Agent가 고친 내용은 보류 중으로 보여도 이미 디스크에 저장돼 있습니다. Keep은 저장 단추가 아닙니다. 보류 표시를 지우는 단추입니다.

원하지 않는 변경이라면 Undo를 누르거나 체크포인트를 복원하세요. 터미널 명령으로 바뀐 내용은 작업 세트 목록에 나오지 않으니 따로 확인해야 합니다.

여기서 더 나아가려면

한두 줄만 고칠 때는 편집기 안에서 Ctrl+I(macOS는 ⌘I)로 여는 인라인 채팅이 더 가볍습니다. 폴더 전체에서 관련 코드를 찾게 하려면 입력창에 #codebase를 붙여 보세요.

손에 익으면 회사 파일 하나를 골라 Ask로 묻는 데서 시작하시면 됩니다.

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

출처

#VS Code#Copilot#GitHub Copilot#채팅#코드 수정#Agent#Ask#체크포인트

같은 분류의 글