VS Code에서 AI와 함께 일할 작업 공간 익히기

1. 오늘은 내 작업 지침 한 장을 만든다

1편에서 AI에게 맡기고 싶은 일을 생각해 보았다. 이번에는 그 생각을 컴퓨터에 파일로 남긴다. 오늘 만들 결과물은 AI의 역할·자료·목표를 적은 작업 지침 한 장이다. 앱을 만들거나 AI 서비스에 가입하는 단계는 아니다.

Visual Studio Code, 줄여서 VS Code는 파일을 열고 고치는 편집 도구다. 한글에서 문서를 작성하듯 사용할 수 있지만, 문서 하나뿐 아니라 관련 파일이 들어 있는 폴더 전체를 열어 관리한다는 점이 다르다. 앞으로 AI가 만든 파일을 살펴보고 지침을 수정할 때도 같은 화면을 사용한다.

오늘의 동선은 다음과 같다.

폴더 열기 → 지침 파일 만들기 → 내용 작성 → 저장 → 미리 보기

AGENTS.md는 이번 연수에서 사용하는 작업 지침 파일 이름이다. OpenCode는 프로젝트 루트의 AGENTS.md를 작업 지침으로 자동으로 읽는다. 다른 AI 도구는 규칙이 다를 수 있다. 실습에서는 파일이 적용되었는지 확인할 수 있도록 AI에게도 이 지침을 다시 확인하게 한다.

이 파일은 myproject01의 최상위 기준 문서다. 무엇을 도울지, 어떤 자료를 참고할지, 어떤 결과면 성공인지 정한다. 나중에 계획이나 설계 문서를 만들더라도 이 기준에서 도출해야 하며, 서로 어긋나면 AI가 임의로 선택하지 않고 교사에게 질문해야 한다. 오늘은 docs/나 설계 문서 세 개를 만들지 않는다. 먼저 이 지침으로 활동지 업무 하나를 끝내는 것이 다음 실습이다.

명령어를 외울 필요는 없다. 화면 시연을 먼저 보고, 내 컴퓨터에서 같은 작업을 한 다음, 결과가 남았는지 확인하자.

2. VS Code와 빈 폴더 준비하기

설치하고 실행하기

이미 설치되어 있다면 VS Code를 실행하고 다음 단계로 넘어간다.

1. VS Code 공식 다운로드 페이지에서 Windows 또는 macOS 버전을 받는다.
2. Windows에서는 설치 파일을 실행한다. macOS에서는 압축을 풀고 Visual Studio Code 앱을 응용 프로그램 폴더로 옮긴다.
3. 시작 메뉴 또는 응용 프로그램에서 Visual Studio Code를 실행한다.

학교 관리 컴퓨터에서 설치가 차단되면 담당자에게 요청한다. 제한을 우회하지 않는다.

시연은 Windows의 한국어 메뉴와 Dark+ 테마를 기준으로 재현했다. 내 화면의 색이 달라도 설정을 바꿀 필요는 없다. macOS에서는 파일 메뉴가 화면 맨 위 메뉴 막대에 있고, 창 버튼 모양도 다르다. 위치보다 메뉴 이름과 파일 이름을 기준으로 따라가면 된다.

한국어 메뉴를 원하면 왼쪽의 블록 모양 확장(Extensions) 아이콘에서 Korean Language Pack for Visual Studio Code를 검색한다. 게시자가 Microsoft인지 확인해 설치하고 언어 변경 안내를 따른다. 영어 화면에서도 따라 할 수 있도록 본문에는 영문 메뉴 이름을 함께 적었다.

VS Code에서 폴더를 만들고 열기

별도로 파일 탐색기나 Finder를 열거나 OpenCode에 요청하지 않는다. VS Code의 파일 → 폴더 열기…에서 원하는 위치로 이동한 뒤, 그 창 안에서 새 폴더를 만든다. 아래 첫 시연에서 이 과정을 볼 수 있다.

Windows: 폴더 열기 창에서 문서를 선택한다. 새 폴더를 누르고 myproject01을 입력한 뒤 Enter를 누른다. 만든 폴더를 선택하고 폴더 선택을 누른다. 기존 폴더가 있다면 새로 만들지 않고 선택한다. OneDrive 사용 여부에 따라 문서의 실제 위치는 다를 수 있다.

macOS: 폴더 열기 창에서 Cmd+Shift+G를 누르고 ~/project/로 이동한다. 새로운 폴더 버튼 또는 Cmd+Shift+N으로 myproject01을 만든 뒤 열기를 누른다. project가 없다면 먼저 ~로 이동해 같은 방식으로 project를 만들고 그 안에서 진행한다. ~는 사용자 홈 폴더를 뜻한다.

이번 실습에서는 이 폴더만 사용한다. 학생 이름, 성적, 상담 기록, 비밀번호는 넣지 않는다. 빈 양식과 공개 자료, 가상의 사례로 연습한다.

3. 시연을 보고 내 화면에서 따라 하기

아래는 실제 VS Code를 실행한 창이 아니라 주요 화면을 재현한 학습용 시연이다. 화면 안의 파일 메뉴를 누르는 대신, 아래의 단계 버튼을 사용한다. 여기에서 보이는 파일이 내 컴퓨터에 생성되거나 저장되지는 않는다.

각 설명 바로 아래에 해당 장면의 시연을 배치했다. 화면에 들어오면 그 장면만 자동 재생하고 멈춘다. 이 장면 다시 보기로 반복하거나 일시 정지하고 내 VS Code에서 따라 하자. 동작 줄이기 설정을 사용하면 자동 재생하지 않는다. 작은 화면에서는 시연 안을 좌우로 스크롤할 수 있다. 첫 시연은 Windows 폴더 선택 창을 재현한다. macOS는 위의 메뉴 안내를 따른다.

① 폴더 열기 — 왼쪽에 폴더 이름이 있는가

화면에서 보기: 아래 장면을 본다. 재생하면 위쪽 파일 메뉴가 열리고 커서가 폴더 열기…로 이동한다. 이것이 작업을 시작하는 메뉴다.

내 컴퓨터에서 하기:

1. VS Code에서 파일(File) → 폴더 열기(Open Folder...)를 선택한다.
2. Windows는 문서, macOS는 ~/project/로 이동해 그 창에서 myproject01을 만든다.
3. 만든 폴더를 선택하고 폴더 선택 또는 열기를 눌러 VS Code로 돌아온다.

확인하기: 왼쪽 탐색기(Explorer)에 myproject01가 보이면 성공이다. 탐색기는 현재 연 폴더의 파일 목록을 보여주는 곳이다. 폴더 이름은 화면에서 대문자로 표시될 수도 있다.

탐색기가 안 보이면 보기(View) → 탐색기(Explorer)를 선택한다. 가운데 문서 탭만 열려 있다면 파일 하나만 연 것은 아닌지 확인하고, 폴더 열기를 다시 선택한다.

폴더를 신뢰하는지 묻는 창이 나올 수도 있다. 내가 만든 빈 실습 폴더인지 위치를 확인한 뒤 판단한다. 인터넷에서 받은 프로젝트는 내용을 확인하기 전까지 제한 모드를 유지한다. 신뢰 설정은 작업과 확장 기능의 실행 범위에 영향을 준다.

② 새 파일 만들기 — 이름 끝에 .md가 붙었는가

화면에서 보기: 아래 장면을 본다. 왼쪽 탐색기에 파일 이름을 입력하는 칸이 나타난다. 아직 본문을 쓰는 자리가 아니라 파일 이름을 정하는 자리다.

내 컴퓨터에서 하기:

1. 탐색기의 myproject01 폴더 이름 위에서 마우스 오른쪽 버튼을 누른다.
2. 새 파일(New File)을 선택한다.
3. AGENTS.md를 입력하고 Enter를 누른다.

확인하기: 왼쪽 목록에 AGENTS.md가 생기고, 가운데에 같은 이름의 편집 탭이 열리면 성공이다. 왼쪽은 파일을 찾는 곳, 가운데는 선택한 파일의 내용을 고치는 곳이다.

파일 이름 끝의 .md는 Markdown 문서라는 표시다. Markdown은 글에 간단한 기호를 붙여 제목이나 목록을 나타내는 문서 형식이다. #는 큰 제목, ##는 그 아래 단계의 제목이다. 오늘 예시에서는 ## 역할, ## 자료, ## 목표 세 제목과 1., 2. 같은 번호 목록만 사용한다. 제목 기호나 번호 뒤에는 한 칸을 띄운다.

③ 작업 지침 작성 — 이름 칸이 아니라 편집기에 썼는가

화면에서 보기: 아래 장면을 본다. 가운데 편집기에 줄 번호와 글이 보인다. 파란색으로 표시된 줄은 ##로 시작하는 제목이다. 왼쪽 줄 번호는 VS Code가 보여주는 안내이므로 직접 입력하지 않는다. 본문 안의 1., 2.는 목록 번호이므로 함께 입력한다.

내 컴퓨터에서 하기: 가운데 AGENTS.md 편집 영역을 클릭하고 다음 내용을 붙여 넣는다. 코드 상자의 내용만 사용하고, 감싸는 백틱 기호는 입력하지 않는다.

## 역할
1. 교사의 활동지 초안 작성을 돕는다.
2. 대상 학년과 단원, 학습 목표를 먼저 확인한다.

## 자료
1. 교사가 제공한 공개 교육과정과 빈 활동지 양식을 참고한다.
2. 자료가 부족하거나 판단이 애매하면 추측하지 말고 교사에게 질문한다.

## 목표
1. 한 차시에 사용할 활동지와 교사용 해설 초안을 만든다.
2. 작성 계획을 먼저 제안하고 교사의 승인을 받은 뒤 초안을 작성한다.
3. 학습 목표와 문항·해설이 맞는지 확인하고, 검토가 필요한 부분을 표시한다.

확인하기: 역할, 자료, 목표 세 제목 아래에 번호가 붙은 문장들이 있으면 된다. 글자 색이나 줄 번호가 시연과 완전히 같을 필요는 없다. 창이 좁으면 긴 문장이 다음 줄로 보이거나 오른쪽으로 이어질 수 있다.

이제 같은 활동지 예시 안에서 역할의 두 번째 항목을 내 수업에 맞게 바꿔 보자. 예를 들어 중학교 1학년 정수의 덧셈에서 수직선으로 계산 과정을 설명하도록 돕는다.로 구체화할 수 있다. 자료도 내가 제공할 공개 자료와 빈 양식에 맞게 고친다. 내 바람만 적는 대신 AI가 참고할 자료와 완성 기준, 질문·승인 순서를 함께 적는 것이 이번 실습의 목적이다. 다른 업무에도 같은 세 제목을 사용할 수 있지만, 다음 글은 이 활동지 작업을 이어 간다.

④ 저장하기 — 닫았다가 열어도 문장이 남는가

화면에서 보기: 아래 장면을 본다. 재생하면 파일 메뉴의 저장 위치와 Ctrl+S가 보인다. 재생 중에는 저장 명령을 선택한 뒤 메뉴가 닫히고 미저장 표시가 사라진다. 이것은 시연 속 변화이며, 내 파일은 직접 저장해야 한다.

내 컴퓨터에서 하기:

1. 파일(File) → 저장(Save)을 선택한다. Windows는 Ctrl+S, macOS는 Cmd+S도 사용할 수 있다.
2. AGENTS.md 편집 탭을 닫는다. 저장 여부를 다시 묻는다면 저장을 선택한다.
3. 왼쪽 탐색기에서 AGENTS.md를 다시 연다.

확인하기: 내가 바꾼 문장이 그대로 남아 있으면 성공이다. 기본 설정에서는 수정 후 저장하지 않은 탭에 점 표시가 나타날 수 있다. 자동 저장을 켰다면 표시가 빨리 사라질 수 있으므로, 점의 유무보다 다시 열었을 때의 내용으로 확인한다.

VS Code의 저장은 현재 파일에 변경을 기록하는 동작이다. Git에 버전을 남기거나 다른 컴퓨터에 백업하는 것과는 다르다. 변경 기록은 이후 장에서 다룬다.

⑤ 미리 보기 — 제목 기호가 제목 모양으로 바뀌었는가

화면에서 보기: 아래 장면을 본다. #와 줄 번호 대신 제목과 문단이 보인다. 다른 내용을 만든 것이 아니라 같은 Markdown 문서를 읽기 좋은 모양으로 표시한 것이다.

내 컴퓨터에서 하기:

1. AGENTS.md가 열린 상태에서 Windows는 Ctrl+Shift+V, macOS는 Cmd+Shift+V를 누른다.
2. 또는 편집기 위쪽의 AGENTS.md 파일 탭을 오른쪽 클릭하고 미리 보기 열기(Open Preview)를 선택한다.
3. 역할·자료·목표 세 제목과 번호 목록, 내가 수정한 문장이 나타나는지 확인한다.

확인하기: ## 기호가 제목 모양으로 바뀌고 목록 번호가 보이면 성공이다. 메뉴가 없거나 예상과 다르면 파일 이름이 AGENTS.md인지, AGENTS.md.txt처럼 다른 확장자가 붙지는 않았는지 살핀다.

내용을 고칠 때는 탐색기에서 AGENTS.md를 다시 선택해 원문 편집기로 돌아온다. 문장을 한 번 더 수정하고 저장한 뒤 미리 보기를 다시 연다. 바뀐 문장이 보이면 파일 수정 → 저장 → 결과 확인을 한 바퀴 완료한 것이다.

미리 보기는 문서의 모양을 보여줄 뿐, 내용이 정확한지 판단하거나 앱을 실행해 주지는 않는다. 보기 좋게 나온 글도 내용은 직접 읽고 검토해야 한다.

4. 막혔다면 이 순서로 확인한다

지금 보이는 상황	먼저 확인할 것
왼쪽에 연습 파일이 없다	탐색기 맨 위 폴더가 myproject01인지 확인한다. 다른 폴더라면 폴더 열기를 다시 한다.
파일 이름을 적었는데 문서를 못 쓰겠다	Enter로 이름을 확정한 뒤 가운데 편집 영역을 클릭한다.
수정한 문장이 다시 열었을 때 없다	같은 위치의 파일을 열었는지 확인하고, 원문을 수정한 뒤 저장한다.
미리 보기에 제목 대신 기호가 그대로 보인다	.md 파일인지, 제목 앞에 # 처럼 기호와 공백을 넣었는지 확인한다.
시연에는 파일이 있는데 내 컴퓨터에는 없다	시연은 내 컴퓨터를 조작하지 않는다. 내 VS Code에서 같은 작업을 직접 한다.

문제가 생겼다고 처음부터 전부 다시 설치할 필요는 없다. 어느 폴더를 열었는지 → 어느 파일을 보고 있는지 → 저장했는지부터 확인한다. 이후 AI가 파일을 만들거나 수정할 때도 같은 순서가 도움이 된다.

5. 이 동선을 AI 작업에 연결하기

오늘은 직접 파일을 만들었지만, 나중에는 AI에게 초안을 만들도록 요청할 수 있다. 그때도 만들었습니다라는 대답만 읽고 끝내지 않는다. 탐색기에서 파일을 찾고 → 편집기나 미리 보기로 내용을 읽고 → 고칠 부분을 정한다. 오늘 연습한 동선이 그대로 검토 과정이 된다.

AI와 대화하는 화면은 사용하는 서비스와 확장에 따라 달라진다. VS Code 설치와 AI 서비스 로그인은 별개의 준비다. 이번 실습에서는 AI 채팅창이나 계정이 없어도 된다.

프로그램을 실행할 때 쓰는 터미널(Terminal)은 문자로 명령을 입력하고 실행 결과를 보는 화면이다. VS Code 안에서도 열 수 있지만, 오늘 만든 지침을 작성하고 확인하는 데는 필요하지 않다. 실행이 필요한 실습에서 작업 위치와 명령의 의미를 함께 다룬다.

연습용 폴더를 따로 만들었다고 AI의 접근 권한이 그 안으로 자동 제한되는 것은 아니다. AI 도구를 연결할 때는 파일 접근, 명령 실행, 외부 전송과 승인 설정도 확인해야 한다.

6. 오늘의 결과물 확인하기

시연을 다 봤는지가 아니라 내 컴퓨터에 무엇이 남았는지로 마무리한다.

• myproject01 폴더에 AGENTS.md가 있다.
• 지침에 역할·자료·목표 세 제목과 번호가 붙은 작업 기준이 적혀 있다.
• 파일을 닫고 다시 열어도 내가 고친 문장이 남는다.
• 미리 보기로 내용을 읽고, 원문 편집기로 돌아올 수 있다.

네 가지를 해냈다면 오늘의 준비는 끝났다. 모든 메뉴나 단축키를 외우지 않아도 된다. 파일을 어디서 찾고, 어디서 고치고, 어떻게 결과를 확인하는지 알면 된다.

다음 글에서는 오늘 사용한 myproject01을 그대로 이어 쓴다. AI에게 AGENTS.md와 자료를 명시적으로 읽도록 요청하고, 평소 쓰던 학습지의 구성과 의도를 분석해 Markdown으로 정리한다. 새 원고 작성과 출력물 제작은 그다음 장에서 이어 간다.

참고 자료

• VS Code 다운로드
• VS Code 화면 구성과 탐색기
• VS Code Markdown 편집과 미리 보기