AI 활용 교육 — 사전 준비 가이드

클로드 데스크탑 · 코워크(협업) 실습

설치 → 테스트 → 자체 트러블슈팅 · 소요 약 40분 · Windows 기준

교육 당일 실습이 지연되지 않도록, 교육 전에 직접 설치와 테스트를 마치기 위한 안내입니다. 순서대로 따라 하시고, 문제가 생기면 트러블슈팅에서 같은 증상을 찾아 보세요.

준비물

회사 또는 개인 노트북 (Windows 10 이상, 관리자 권한)
Claude 유료 계정 (Pro 이상 권장)
안정적인 인터넷
Git (3장에서 설치)

⚠ 가장 자주 발생하는 사고 — Git을 안 깔고 오시는 경우입니다

Git이 없어도 앞부분 실습은 문제없이 진행됩니다. 그래서 안 깔고 오셔도 모르고 계시다가, 실습 마지막 단계(작업 되돌리기·버전 관리·배포)에서 갑자기 멈춥니다. 그 자리에서 설치하면 회사 PC 권한 문제까지 겹쳐 시간이 크게 지연됩니다. 3장을 반드시 교육 전에 끝내 주십시오.

1💻 클로드 데스크탑 설치

다운로드 및 설치

브라우저에서 claude.com/download 접속 → Windows 버전 다운로드
다운로드된 설치 파일 실행 → 설치 완료
시작 메뉴에서 Claude 실행 → 계정으로 로그인

클로드 데스크탑 내려받기 ↗

코워크(협업) 사전 요구사항

코워크(협업) 사전 요구사항
항목	요구사항	확인 방법
운영체제	Windows 10 이상 (코워크는 Windows 11 Pro 권장)	설정 → 시스템 → 정보
에디션	Pro / Enterprise / Education (Home은 코워크 로컬 실행 불가)	설정 → 시스템 → 정보
가상화	BIOS 가상화 활성화 + 가상 머신 플랫폼	작업관리자 → 성능 → CPU → "가상화: 사용"
계정	Claude 유료 요금제	claude.ai 로그인 후 설정에서 확인

Home 에디션이거나 가상화가 차단된 회사 PC여도 괜찮습니다 — 협업 작업을 '클라우드'에서 실행하면 됩니다 (트러블슈팅 A-1 참고).

2🤝 코워크(협업) 테스트

클로드 데스크탑 실행 → 입력창 아래 [Cowork(협업)] 탭 클릭
작업 폴더 연결을 요청하면, 바탕화면에 새 폴더 「AI 실습」을 만들어 연결
입력창에 다음을 입력: "이 폴더에 hello.txt 파일을 만들고 '테스트 성공'이라고 적어줘"
폴더에 hello.txt 가 생성되고 내용이 맞으면 테스트 통과

[Cowork(협업)] 버튼이 눌리지 않거나 오류 말풍선이 뜨면 → 트러블슈팅 A로 이동

3🔧 Git 설치 ★ 코딩 작업 전 반드시 완료

왜 필요한가

클로드가 만든 코드는 Git 위에서 이력이 관리됩니다. 작업을 이전 상태로 되돌리기, 변경 내용 비교, 여러 작업을 나눠서 진행하기 — 이 기능들이 전부 Git을 씁니다. Git이 없으면 앞부분은 문제없이 되지만, 되돌리기·버전 관리 단계에서 오류가 나며 그때부터 진도가 나가지 않습니다.

설치 (약 5분)

브라우저에서 git-scm.com/download/win 접속 → 64-bit Git for Windows Setup 다운로드
설치 파일 실행 → 옵션은 전부 기본값 그대로 [Next] (임의로 바꾸지 마십시오)
설치 완료 후 열려 있던 명령 창·클로드 데스크탑을 모두 닫습니다 — 이걸 안 하면 설치해도 인식되지 않습니다

Git for Windows 내려받기 ↗

설치 확인

Win + R → cmd 입력 → 확인
아래를 입력하고 Enter

git --version

git version 2.xx.x — git version 2.xx.x 처럼 버전이 표시되면 설치 완료입니다

최초 1회 사용자 등록

이름과 메일을 등록해 두지 않으면 저장(커밋) 단계에서 오류가 납니다. 아래 두 줄을 본인 정보로 바꿔 입력하세요.

git config --global user.name "Hong Gildong"
git config --global user.email "hong@company.com"

회사 메일이 아니어도 됩니다. 외부에 공개되지 않으며, 기록용 표시일 뿐입니다.

4🧪 코딩 작업 테스트

코워크(협업) 탭에서 코딩 작업이 되는지 아래 순서로 확인합니다. (3장 Git 설치가 끝난 뒤에 진행하세요.)

클로드 데스크탑 → [Cowork(협업)] 탭 → 「AI 실습」 폴더가 연결된 상태에서 새 작업 시작
입력창에 다음을 입력: "이 폴더에 구구단을 출력하는 웹페이지(gugudan.html)를 만들어줘"
폴더에 생성된 gugudan.html 을 더블클릭 → 브라우저에 구구단이 표시되면 통과
이어서 입력: "방금 작업을 되돌려줘" → 오류 없이 처리되면 Git 연동까지 정상입니다

2장(hello.txt)·3장(Git)·4장(gugudan.html + 되돌리기)이 모두 성공하면 교육 당일 모든 실습을 수행할 준비가 끝난 것입니다.

5🩺 자체 트러블슈팅

A. 코워크(협업) 문제

A-1. "Missing HCS services: HNS, vmcompute, vfpext" 오류 (가장 흔함)

윈도우 가상화 서비스가 꺼져 있는 상태입니다. 순서대로 조치하세요.
30초 진단: 에디션(Home이면 4번으로 직행) + 작업관리자 "가상화: 사용" 확인
Win + R → optionalfeatures → Hyper-V · 가상 머신 플랫폼 · Windows 하이퍼바이저 플랫폼 · 컨테이너 4개 체크 → 반드시 "다시 시작" — 종료 후 다시 켜는 방식은 안 됩니다
PowerShell(관리자)에서 아래 실행 후 재시작
위 방법으로 모두 해결되지 않으면 → 협업 작업을 '클라우드'에서 실행: 새 작업을 시작할 때 화면 우측 상단의 실행 위치 선택("Run this task")에서 '클라우드'를 선택합니다. 내 PC가 아닌 클라우드 서버에서 실행되므로 가상화 기능과 무관하게 즉시 작동합니다. 매번 선택하기 번거로우면 설정 → Cowork → '새 작업을 클라우드에서 실행'을 켜 두면 됩니다.

wsl --shutdown
wsl --update
net start vmcompute
net start hns
Get-Service vmcompute, hns   # 두 서비스가 Running 이면 정상

A-2. Cowork(협업) 탭이 아예 안 보임

클로드 데스크탑을 최신 버전으로 업데이트 → 완전 종료 후 재실행
해결 안 되면 제거 후 claude.com/download 에서 재설치

A-3. 설정 화면에서 무한 로딩(스피너)

VPN·백신을 잠시 끄고 재시도, 회사망이면 개인 핫스팟으로 테스트
Docker Desktop 사용 중이면 종료 후 재시도 (네트워크 자원 충돌)

B. Git 문제 ★

B-1. "'git'은(는) 내부 또는 외부 명령… 이 아닙니다"

가장 흔한 원인은 설치 후 창을 다시 열지 않은 것입니다. 명령 창과 클로드 데스크탑을 완전히 종료했다가 다시 실행하세요.
그래도 안 되면 PC를 재부팅합니다. 대부분 여기서 해결됩니다.
재부팅 후에도 같으면 Git이 실제로 설치되지 않은 것입니다 → 제어판 "앱"에서 Git 항목 확인 후 재설치

B-2. 관리자 권한이 없어 설치가 막힘 (회사 표준 PC)

설치 시 "Only for me (현재 사용자)" 옵션을 선택하면 관리자 권한 없이 설치되는 경우가 많습니다.
그래도 막히면 IT 부서에 Git 설치를 요청하십시오 — 개발 도구가 아니라 일반 업무 도구로 널리 승인됩니다.
끝내 설치가 불가하면 트러블슈팅 A-1의 4번(클라우드 실행)으로 진행하십시오. 클라우드에는 Git이 이미 갖춰져 있어 내 PC에 설치하지 않아도 실습이 전부 가능합니다.

B-3. 저장(커밋) 시 이름·메일을 묻는 오류

3-4의 사용자 등록을 하지 않은 경우입니다. 위 3-4의 두 줄을 입력하면 해결됩니다.

B-4. 회사망에서 SSL 인증서 오류 / 연결 실패

사내 방화벽이 통신을 가로채는 환경입니다. 개인 핫스팟으로 전환해 재시도하면 대부분 해결됩니다.
사내망에서 계속 써야 한다면 IT 부서에 사내 인증서 적용을 문의하십시오. 보안 검증을 끄는 설정은 권장하지 않습니다.

C. 코딩 작업 문제

C-1. 파일은 만들어지는데 내용이 이상하거나 실행이 안 됨

같은 작업 창에서 "브라우저에서 열었더니 안 보여. 수정해줘" 라고 이어서 지시 (수정도 클로드가 수행)
새 작업으로 다시 시작해 같은 지시 재시도

C-2. 폴더에 파일이 생성되지 않음

Cowork(협업) 탭에서 「AI 실습」 폴더가 연결되어 있는지 확인 후 재시도
OneDrive·회사 동기화 폴더는 피하고, 바탕화면의 일반 폴더 사용

D. 공통 문제

네트워크 오류

백신·방화벽에서 Claude 허용. 회사망 차단 시 IT 부서에 claude.ai / anthropic.com 도메인 허용 요청

로그인 반복 요청

브라우저 쿠키 삭제 후 재로그인, 또는 다른 브라우저 사용

요금제 문의

코워크(협업) 기능은 유료 요금제(Pro 이상)에서 사용 가능

6✅ 최종 점검 체크리스트 (교육 전날까지)

최종 점검 체크리스트 (교육 전날까지)
No	점검 항목	판정 기준
1	클로드 데스크탑 설치 + 로그인	앱 실행 및 채팅 가능
2	실습 폴더 준비	바탕화면 「AI 실습」 폴더
3	코워크(협업) 테스트	hello.txt 생성 성공
4	코워크 실패 시 클라우드 실행 확인	클라우드 선택 후 작동
5	Git 설치 ★	git --version 버전 표시
6	Git 사용자 등록 ★	이름·메일 config 입력 완료
7	코딩 작업 테스트	gugudan.html 브라우저 실행
8	되돌리기 테스트 ★	"되돌려줘" 지시가 오류 없이 처리

3·7·8번이 끝내 해결되지 않아도 교육 참여에는 지장이 없습니다. 4번(클라우드 실행)만 확인되면 모든 실습이 가능합니다.

5·6번(Git)은 로컬 PC에서 실습하실 분만 해당합니다. 클라우드 실행으로 진행하시면 Git 설치는 필요 없습니다.

7🤖 그래도 해결되지 않을 때 — AI에게 직접 물어보기

위 방법으로도 해결되지 않으면, 오류 화면을 캡처해서 AI에게 직접 물어보는 것이 가장 빠릅니다. 이 과정 자체가 교육에서 다루는 'AI를 실무에 쓰는 법'의 예행연습이기도 합니다.

방법

화면 캡처 — 오류 메시지가 보이는 화면을 캡처합니다. (Windows: Win + Shift + S → 영역 선택 → 자동 복사)
AI 서비스 접속 — 챗GPT(chatgpt.com), 제미나이(gemini.google.com), 클로드(claude.ai) 중 편한 곳에 접속합니다.
이미지 붙여넣기 + 질문 — 캡처 이미지를 붙여넣고(Ctrl + V) 아래 질문 템플릿을 함께 입력합니다.
답변대로 조치 → 안 되면 결과를 다시 알려주기 — 한 번에 안 되어도 "그렇게 했는데 이런 화면이 나옵니다"라고 이어서 대화하면 해결 확률이 크게 올라갑니다.

그대로 복사해서 쓰는 질문 템플릿

첨부한 화면은 Windows PC에서 Claude 데스크톱 앱의 코워크(협업) 기능 또는 Git 설치 과정에서 나온 오류입니다.
· 제 환경: Windows [10 / 11], [Home / Pro] 에디션, 회사 노트북(관리자 권한 [있음 / 없음])
· 이미 시도한 것: [예 — Hyper-V 기능 켜기, wsl --update 실행, Git 재설치 후 재부팅]

이 오류의 원인이 무엇인지 설명하고, 초보자도 따라 할 수 있도록 해결 방법을 순서대로 알려주세요.
명령어가 필요하면 어디에 어떻게 입력하는지까지 함께 알려주세요.

회사 보안정책상 설치·설정 변경이 막혀 있다면 AI도 해결할 수 없습니다. 이 경우 무리하게 시도하지 마시고 트러블슈팅 A-1의 4번(클라우드 실행)으로 진행하시면 실습에 전혀 지장이 없습니다.

주의: 사내 시스템 정보·계정 정보·고객 데이터가 화면에 함께 캡처되지 않도록 확인 후 업로드하세요.

작성: 나눔경영컨설팅 김종혁