사전 안내 · 수업 전에 준비

Claude Code 자동화 에이전트 개발 교육 — 사전 안내문 (Windows)

대상: 한양대학교 기계공학부 대학원 수강생 25명
일정: 1회차 2026-11-02(월) 14:00–18:00 · 2회차 2026-11-09(월) 14:00–18:00
장소: 한양대학교 서울캠퍼스 구자겸 기계공학관 4층 407호
환경체크 마감: 2026-11-01(일)11:00까지
문의: 김재우 · jaewoo@ilhae.ai

교육 당일에는 설치에 시간을 쓰지 않습니다. 이 안내문의 순서대로 준비해 오시면 교육 시작 20분 안에 실습 데이터로 들어갑니다. 사전설문 응답자 전원이 Windows 노트북을 가져온다고 답해서 이 안내문은 Windows 기준으로만 작성했습니다. Python을 써 본 적이 없어도 화면 순서대로 따라 하면 됩니다. 전체 소요 시간은 30~40분입니다.

0. 준비물 확인

항목	기준
노트북	Windows 10 (1809 이후) 또는 Windows 11, 메모리 4GB 이상
계정	Claude 계정 (아래 1번)
인터넷	교내 Wi-Fi 접속 가능 (아래 8번의 주소에 접속되어야 합니다)
관리자 권한	필요 없습니다. 단, 회사·연구실 관리 PC라 설치가 막혀 있으면 연구실 관리자에게 먼저 문의하고 강사에게도 미리 알려 주십시오
전원	4시간 실습이므로 충전기를 꼭 가져옵니다

1. Claude 계정

이 과정은 각자의 Claude Pro 계정으로 진행합니다. Max도 됩니다. 무료(Free) 플랜은 Claude Code를 쓸 수 없습니다.
구독 비용은 학교가 부담합니다. 결제·정산 방법은 학과 안내를 따릅니다.
가입 뒤 브라우저에서 https://claude.ai 에 로그인되는지 확인합니다.
모델 개선 설정을 끕니다. https://claude.ai/settings/data-privacy-controls 에서 대화를 모델 개선에 쓰는 설정을 끕니다. Pro는 개인 약관이라, 이 설정이 켜져 있으면 대화와 코딩 세션이 학습에 쓰이고 5년 보관됩니다. 꺼져 있으면 학습에 쓰이지 않고 30일 보관됩니다. 실습 데이터는 가상 데이터지만 과제에서 연구실 데이터를 다룰 수 있으니 미리 끄십시오. 자세한 내용은 1회차 A0에서 설명합니다.
사용량 한도가 있습니다. Pro는 5시간 단위 한도와 주간 한도가 있습니다. 수업(11/2·11/9 14:00–18:00) 당일 오전에는 Claude를 오래 쓰지 마십시오. 수업 중에 한도에 닿을 수 있습니다. 남은 양은 Claude Code에서 /usage로 봅니다. 수업 중에는 한도를 아끼기 위해 Sonnet 모델로 진행합니다.

참고 — 학교가 Team 플랜으로 계정을 주는 경우 이 안내는 Pro 기준입니다. 학교가 Team 플랜 좌석을 배정하면 아래만 바뀝니다.

개인 Pro를 따로 구독하지 않습니다. 학교 메일로 온 초대 메일에서 가입합니다.

이미 개인 계정으로 Claude Code에 로그인했다면 터미널에서 claude를 실행해 /logout을 입력한 뒤 /login으로 다시 로그인하고, 로그인 화면에서 학교 조직(Team) 을 고릅니다. VS Code 패널도 Sign out 후 다시 Sign in 합니다.

모델 개선 설정은 확인하지 않아도 됩니다. Team은 상업 약관이라 대화가 기본적으로 학습에 쓰이지 않고, 표준 보존 기간은 30일입니다.

사용량 한도는 Pro보다 넉넉합니다. 그래도 수업 중에는 Sonnet으로 진행합니다.

2. Git for Windows 설치

Git for Windows를 설치하면 Claude Code가 Bash 도구도 쓸 수 있습니다(공식 권장). Git을 설치하면 Claude Code가 Bash 도구(Git Bash)와 PowerShell 도구를 함께 쓸 수 있습니다. 공식적으로는 권장 사항이지만, 실습 환경을 모두 같게 맞추기 위해 이 과정에서는 꼭 설치합니다.

https://git-scm.com/downloads/win 에서 Click here to download (64-bit) 를 받습니다.
설치 파일을 실행하고 모든 화면에서 기본값 그대로 Next를 누릅니다.
설치가 끝나면 시작 메뉴에서 PowerShell을 열고 다음을 입력합니다.

git --version

git version 2.xx.x.windows.x처럼 나오면 성공입니다.

3. Python 3.11 설치

https://www.python.org/downloads/windows/ 에서 Python 3.11.x — Windows installer (64-bit) 를 받습니다. (3.12 이상이 아니라 3.11입니다)
설치 파일 첫 화면에서 반드시 아래 두 가지를 체크합니다.
- ☐ Use admin privileges when installing py.exe — 관리자 권한이 있으면 체크하고, 없거나 회색이면 체크하지 않습니다(py 런처가 사용자 계정에 설치됩니다)
- ☑ Add python.exe to PATH
Install Now를 누릅니다.

화면 안내 · Python 설치 첫 화면 — 아래쪽 "Add python.exe to PATH" 체크박스에 빨간 테두리

설치가 끝나면 PowerShell을 새로 열고 다음을 입력합니다.

py -3.11 --version

Python 3.11.x가 나오면 성공입니다.

실습 패키지 설치

같은 PowerShell 창에 그대로 붙여 넣습니다. 1~3분 걸립니다.

py -3.11 -m pip install pandas numpy matplotlib scipy CoolProp

마지막 줄에 Successfully installed …가 나오면 성공입니다. 설치 확인:

py -3.11 -c "import pandas, numpy, matplotlib, scipy, CoolProp; print('OK')"

OK가 나오면 끝입니다.

실습 때 쓰는 `py`가 3.11을 가리키게 하기

실습 중에는 버전 번호 없이 py로 실행합니다. 이미 다른 버전(3.12, 3.13 등)이 깔려 있는 PC에서는 py가 가장 최신 버전을 골라서 "패키지가 없다"는 오류가 납니다. 아래로 확인합니다.

py --version

Python 3.11.x가 아니면 다음 한 줄을 실행한 뒤 PowerShell과 VS Code를 모두 닫았다가 다시 엽니다. 이후 py는 3.11을 씁니다.

setx PY_PYTHON 3.11

CoolProp은 냉매·물 물성을 계산하는 라이브러리입니다. 실습에서 CO2 엔탈피 계산에 씁니다. 코드를 직접 짤 일은 없습니다. 이 라이브러리를 쓰는 코드는 Claude가 씁니다.

4. Claude Code 설치

시작 메뉴에서 Windows PowerShell을 엽니다. 프롬프트가 PS C:\Users\이름>으로 시작하는지 확인합니다.
다음 한 줄을 붙여 넣고 Enter를 누릅니다. 진행 표시 없이 1~2분 걸립니다.

irm https://claude.ai/install.ps1 | iex

끝나면 PowerShell 창을 닫고 새로 연 뒤 확인합니다.

claude --version

2.1.314 (Claude Code) 또는 그보다 높은 숫자가 나오면 성공입니다. 자동 업데이트되므로 교육일에는 숫자가 더 올라가 있을 수 있습니다.

설치 상태를 한 번 더 점검합니다.

claude doctor

경고가 있으면 화면에 나온 해결 방법을 따릅니다.

처음 한 번 로그인합니다.

claude

브라우저가 열리면 1번의 교육용 계정으로 로그인하고 터미널로 돌아옵니다. 대화 화면이 나오면 /exit를 입력해 나갑니다.

위 명령이 회사 보안 정책 등으로 실패하면 대신 winget install Anthropic.ClaudeCode를 실행합니다. 이 방법은 자동 업데이트가 되지 않으므로 교육 전날 winget upgrade Anthropic.ClaudeCode를 한 번 실행합니다.

5. VS Code와 Claude Code 확장 설치

https://code.visualstudio.com 에서 Download for Windows를 받아 기본값으로 설치합니다. (VS Code 1.94 이상이 필요합니다. 이미 설치돼 있으면 도움말 → 업데이트 확인)
VS Code를 열고 Ctrl+Shift+X로 확장 화면을 엽니다.
검색창에 Claude Code를 입력하고 게시자가 Anthropic인 확장을 Install 합니다.
확장 버전을 확인합니다. 확장 화면(Ctrl+Shift+X)에서 설치한 Claude Code 확장을 눌러 버전이 2.1.314 이상인지 봅니다. 낮으면 Update 버튼을 누르거나, 버전 옆 톱니바퀴에서 업데이트한 뒤 VS Code를 다시 시작합니다.
- Claude 패널은 확장 안에 들어 있는 별도의 Claude Code로 돌아갑니다. 위 4번(Claude Code 설치)에서 확인한 claude --version이 최신이어도 확장이 오래되면 패널 화면이 교안과 다르게 보입니다. 그래서 두 버전을 모두 확인합니다.
아무 파일이나 하나 연 상태에서, 편집기 오른쪽 위의 Spark 아이콘(별 모양)을 누르면 오른쪽에 Claude 패널이 열립니다.
처음이면 Sign in을 누르고 브라우저에서 로그인한 뒤 VS Code로 돌아옵니다.
패널 아래 입력창 밑에 모델 이름이 보이면 성공입니다.

6. 실습 폴더 준비

https://hthp.ilhae.ai 의 '자료' 칸에서 hthp-lab.zip을 받습니다.
zip 안에 hthp-lab 폴더가 통째로 들어 있으므로 C:\ 에 풉니다. 받은 파일이 다운로드 폴더에 있으면 PowerShell에 아래 한 줄을 붙여 넣습니다.
```
Expand-Archive -Path "$HOME\Downloads\hthp-lab.zip" -DestinationPath C:\
```
그러면 C:\hthp-lab\data, C:\hthp-lab\tools 폴더가 보여야 합니다. 탐색기의 "압축 풀기"로 대상을 C:\hthp-lab으로 지정하면 C:\hthp-lab\hthp-lab처럼 한 번 더 들어가니 주의합니다.
다음 위치는 피합니다. 실습 중 경로 오류가 자주 납니다.
- 한글이 들어간 경로 (예: 바탕 화면, 문서\교육)
- 공백이 들어간 경로
- OneDrive 동기화 폴더 (C:\Users\이름\OneDrive\…)
VS Code에서 파일 → 폴더 열기 → C:\hthp-lab을 엽니다. "이 폴더의 작성자를 신뢰합니까?"가 나오면 신뢰를 누릅니다.

7. 환경 점검 스크립트 실행과 제출

VS Code에서 Ctrl+\``(백틱)으로 아래쪽 터미널을 엽니다. 터미널이 PS C:\hthp-lab>`에 있는지 확인하고 다음을 붙여 넣습니다.

powershell -ExecutionPolicy Bypass -File .\tools\check_env.ps1

표의 모든 줄이 OK면 준비 끝입니다. Windows, Claude Code, Git, Python, 패키지, VS Code, VS Code의 Claude Code 확장 버전, 실습 폴더 경로, 실습 데이터를 차례로 점검합니다. C:\hthp-lab\check_result.txt 파일도 함께 만들어집니다.

제출 (11월 1일 일요일 11:00까지): 점검 결과 표가 보이는 화면 캡처 1장 + check_result.txt 파일 + claude.ai/settings/data-privacy-controls 에서 모델 개선이 꺼진 화면 캡처 1장 → hthp.ilhae.ai → 제출

FAIL이 있으면 아래 9번 표를 먼저 보고 해결이 안 되면 캡처를 첨부해 메일로 문의합니다. 교육 당일 13:30부터 강의실에서 세팅 클리닉을 운영합니다. FAIL이 남은 분은 13:30까지 와 주십시오.

8. 교내망 접속 확인 (연구실 PC·교내 Wi-Fi 사용자)

다음 주소에 접속되어야 합니다. 브라우저에서 열어 보고 차단되면 미리 알려 주십시오.

주소	용도
claude.ai	로그인, 설치 스크립트
claude.com	브라우저 로그인 페이지 (로그인하면 claude.ai로 넘어갑니다)
platform.claude.com	로그인 토큰 발급·갱신 (claude.ai 계정으로 로그인해도 필요합니다)
downloads.claude.ai	Claude Code 설치 파일
api.anthropic.com	Claude Code가 모델과 통신
pypi.org, files.pythonhosted.org	Python 패키지 설치
github.com, git-scm.com	Git 설치
marketplace.visualstudio.com	VS Code 확장 설치

9. 자주 나는 오류

증상	해결
`'claude'은(는) … 인식되지 않습니다`	PowerShell 창을 닫고 새로 엽니다. VS Code 터미널이라면 VS Code를 완전히 닫았다가 다시 엽니다(설치 전부터 켜져 있던 VS Code는 바뀐 설정을 모릅니다). 그래도 안 되면 `%USERPROFILE%\.local\bin`이 PATH에 있는지 보거나 4번 설치를 다시 실행합니다. 이 상태에서는 `claude doctor`도 실행되지 않습니다
`irm`이 인식되지 않음	CMD 창에서 실행한 것입니다. 시작 메뉴에서 PowerShell을 열어 다시 실행합니다
`The token '&&' is not a valid statement separator`	반대로 CMD용 명령을 PowerShell에 넣은 경우입니다. 4번의 PowerShell 명령을 씁니다
`'py'은(는) … 인식되지 않습니다`	Python을 제거하고 3번을 다시 하며 "Add python.exe to PATH"를 체크합니다
pip 설치 중 `Microsoft Visual C++` 관련 오류	Python 버전이 3.11인지 확인합니다 (`py -3.11 --version`)
VS Code에 Spark 아이콘이 없음	파일을 하나 연 뒤 다시 봅니다. 또는 `Ctrl+Shift+P` → "Claude Code" 검색
점검 결과 `Claude Code 확장 (2.1.314 이상)`이 FAIL	VS Code 확장 화면(`Ctrl+Shift+X`)에서 Claude Code 확장을 설치하거나 업데이트한 뒤 VS Code를 다시 시작하고 7번을 다시 실행합니다
브라우저 로그인 후 "인증 실패"가 나거나 다시 로그인하라고 함	교내망에서 `platform.claude.com`·`claude.com`이 막혔을 수 있습니다. 8번 표의 주소를 브라우저로 열어 보고, 막혔으면 휴대폰 핫스팟으로 로그인한 뒤 알려 주십시오
로그인 후 VS Code로 안 돌아옴	브라우저 창을 닫고 VS Code 패널에서 Sign in을 다시 누릅니다
스크립트 실행이 보안 정책으로 막힘	7번 명령 그대로(`-ExecutionPolicy Bypass` 포함) 실행합니다. 정책 자체를 바꿀 필요는 없습니다

10. 데이터 보안 사전 공지

교육 실습 데이터는 전부 교육용 가상 데이터입니다.
1회차 뒤 과제로 "본인 연구 데이터에 한 번 돌려 보기"가 있습니다. 본인 데이터를 쓰려면 지도교수·과제 책임자에게 외부 AI 서비스 사용이 허용되는지 먼저 확인해 주십시오. 산학과제 데이터는 협약서의 보안 조항이 기준입니다.
규정상 어렵거나 쓸 데이터가 없으면 대체 데이터로 과제를 할 수 있습니다. 불이익은 없습니다.
무엇이 외부로 전송되는지, 어떻게 막는지는 1회차 첫 모듈(A0)에서 자세히 다룹니다.

11. 당일 체크리스트

노트북과 충전기
claude --version 2.1.314 이상
VS Code의 Claude Code 확장 2.1.314 이상 (Ctrl+Shift+X에서 확인)
VS Code에서 C:\hthp-lab 열고 Claude 패널 로그인 완료
check_env.ps1 결과 전부 OK, 스크린샷 제출 완료
(선택) 과제에 쓸 본인 데이터의 사용 가능 여부 확인