24단계설치 전에 준비할 것

걸리는 시간 · 읽기 약 5분 · 따라 하기 약 30분 · 난이도 ★★☆ 실무 · 화면 확인 2026.09.27

이 단계를 마치면

• 내 운영체제에서 터미널을 열고, 지금 어느 폴더에 있는지 확인할 수 있다.
• 한글과 공백이 없는 작업 폴더를 알맞은 곳에 만들 수 있다.
• 회사 PC라면 설치 전에 IT 담당자에게 무엇을 물어야 하는지 안다.

설치 명령은 몇 글자 되지 않는다. 그런데 수업을 해 보면 그 명령을 붙여 넣기도 전에 멈춰 서는 사람이 매번 나온다. 시간을 잡아먹는 범인은 따로 있었다. 로그인할 계정이 없거나, 터미널을 여는 법을 모르거나, 한글 이름 폴더에서 시작했거나, 회사 노트북이 설치를 막고 있었다. 이 네 가지는 모두 설치 전에 확인할 수 있다. 준비에 공을 들여 두면 다음 단계의 설치는 금방 끝난다.

Claude 유료 계정. Claude Code는 무료 계정으로는 쓸 수 없다. 유료 요금제나 API 계정으로 로그인해야 한다. 어떤 요금제에 포함되는지, 조건이 어떻게 바뀌었는지는 공식 안내에서 확인하자. 회사에서 팀·기업용 계정을 쓰고 있다면 조직 관리자가 Claude Code 사용을 허용해야 열리는 경우도 있다. 개인 계정으로 연습할지 회사 계정으로 할지 미리 정해 두고, 회사 계정이라면 관리자에게 먼저 물어보자.

터미널. 터미널은 글자로 컴퓨터에 명령을 내리는 창이다. 처음 열면 검은 화면에 커서 하나만 깜빡여 막막할 수 있다. 걱정할 것 없다. 이 부에서 직접 칠 명령은 몇 개 되지 않고, 나머지는 Claude Code를 켠 뒤 우리말로 시키면 된다.

커서 앞에 붙은 이 표시를 프롬프트라고 부른다. 지금 내가 어느 폴더에 있는지 알려 주는 표시다. 알아 둘 명령은 셋뿐이다. 지금 위치 보기(pwd), 폴더 옮기기(cd 폴더이름), 폴더 안 목록 보기(맥은 ls, PowerShell은 ls나 dir). 이 셋만 알면 "내가 지금 작업 폴더 안에 있는가"를 확인할 수 있는데, 설치 뒤 첫 실행에서 가장 자주 틀리는 부분이 바로 여기다.

작업 폴더 하나. 앞으로 Claude가 일할 방이다. 문제는 이 방의 이름과 위치에서 자주 생긴다. 경로에 한글이나 띄어쓰기가 들어가면 일부 도구가 경로를 제대로 읽지 못한다. 클라우드 동기화 폴더 안에 두면 파일을 고치는 도중에 동기화가 끼어들기도 한다. 그러니 짧은 영문 이름으로, 동기화되지 않는 곳에 새로 만들자.

윈도우에서 사용자 이름이 한글이면 사용자 폴더 아래는 전부 한글 경로가 된다. 이럴 때는 C:\work처럼 드라이브 바로 아래에 영문 폴더를 만든다. 폴더 이름을 소문자와 하이픈으로 짓는 습관을 들여 두면 나중에 GitHub 저장소 이름과 배포 주소에도 그대로 쓸 수 있다. 그리고 이 폴더에는 회사 기밀이나 고객 명단을 넣지 않는다. 연습용으로 가공한 자료만 둔다.

회사 PC의 정책. 회사 노트북에는 관리자 권한이 없거나, 보안 프로그램이 인터넷에서 받은 스크립트 실행을 막거나, 사내 방화벽이 특정 주소를 차단해 둔 경우가 많다. 이것을 우회하려고 애쓰지 말자. 정책에는 다 이유가 있고, 몰래 풀었다가는 나중에 더 큰 문제가 된다. 대신 설치 전에 IT 담당자에게 무엇을 설치하려는지, 어디서 받는지, 무엇에 쓰는지 적어 보낸다. 허락을 받기 어렵다면 연습은 개인 노트북으로 하는 편이 낫다.

준비물을 표 하나로 정리하면 이렇다.

현장 장면

윤 과장은 회사 노트북으로 시작하려 했다. PowerShell을 열자 PS C:\Users\윤서진>이 떴다. 사용자 이름부터 한글이었다. 바탕 화면에 미리 만들어 둔 "방문일지 만들기" 폴더도 문제였다. 이름에 한글과 띄어쓰기가 섞여 있었고, 경로를 확인해 보니 회사가 설정한 클라우드 동기화 폴더 안에 들어 있었다. 한글 경로에 동기화까지, 피해야 할 것이 한꺼번에 겹쳐 있었다.

윤 과장은 C:\work\visit-log를 새로 만들었다. 파일 탐색기로 C 드라이브를 열어 폴더를 만든 뒤 PowerShell에서 cd C:\work\visit-log를 치자, 프롬프트가 PS C:\work\visit-log>로 바뀌었다. dir을 쳐 보니 아무것도 나오지 않았다. 빈 방에 제대로 들어온 것이다.

진짜 고비는 다음 날 찾아왔다. 설치 명령을 시험 삼아 붙여 넣자 보안 프로그램이 스크립트 실행을 차단했다는 창이 떴다. 설정을 꺼 버리고 싶은 마음이 들었지만 윤 과장은 손대지 않았다. 대신 아래 프롬프트로 IT팀에 보낼 메일을 써서 보냈다. 무엇을 어디서 받아 무엇에 쓰는지, 작업 폴더에 고객 정보를 넣지 않는다는 점까지 적었다. IT팀은 그 주 안에 작업 폴더 경로와 설치 주소를 허용 목록에 넣어 주었다. 문제를 몰래 피해 가는 대신, 담당자가 판단할 수 있도록 정보를 건넨 덕분이다.

따라 하기

1. Claude 웹에 로그인해 내 계정의 요금제를 확인한다. 성공 기준: 요금제 이름을 말할 수 있고, 회사 계정이라면 Claude Code를 써도 되는지 관리자의 답이 있다.
2. 터미널(맥) 또는 PowerShell(윈도우)을 연다. 성공 기준: 줄 끝에 커서가 깜빡이는 프롬프트가 보이고, 거기 적힌 경로를 읽을 수 있다.
3. 영문 이름의 작업 폴더를 만든다. 파일 탐색기나 Finder로 만들어도 된다. 성공 기준: 경로 전체에 한글과 띄어쓰기가 없고, 동기화 폴더 밖에 있다.
4. 터미널에서 cd로 그 폴더에 들어가고 목록을 본다. 성공 기준: 프롬프트에 작업 폴더 이름이 보이고, 목록이 비어 있다.
5. 회사 PC라면 아래 프롬프트로 IT 담당자에게 보낼 요청을 만들어 보낸다. 성공 기준: 설치 전에 허용 여부에 대한 답을 받는다.

복사해 쓰는 프롬프트

회사 IT 담당자에게 보낼 짧은 요청 메일을 써 줘.
내용: 업무용 사내 도구 연습을 위해 내 노트북에 Claude Code를 설치하려고 한다.
설치 방법은 공식 문서(code.claude.com/docs)의 안내를 따른다.
작업 폴더는 [작업 폴더 경로]이고, 회사 기밀이나 고객 정보는 넣지 않는다.
확인받고 싶은 것: [설치 권한 / 스크립트 실행 허용 / 외부 주소 접속 / GitHub 사용] 중 해당하는 것.
정중하지만 짧게, 담당자가 예·아니오로 답할 수 있게 질문을 끝에 목록으로 정리해 줘.

막히면 이렇게

실습 파일

공개 저장소에 올려 둔 가공 자료와 양식이다. 회사 자료 대신 먼저 이것으로 해 본다.

• 샘플 자료 영업_방문기록.csv · 영업 사원 네 명의 3월 방문 기록 30건

스스로 점검

• ☐ 터미널을 열고 지금 있는 폴더가 어디인지 말할 수 있는가
• ☐ 작업 폴더 경로에 한글, 띄어쓰기, 동기화 폴더가 없는가
• ☐ 회사 PC라면 설치해도 된다는 답을 받았는가

기억할 것

• 작업 폴더는 영문, 공백 없이, 동기화되지 않는 곳에 새로 만든다.
• 회사 PC의 정책은 우회하지 않고 먼저 묻는다.