제3부 · Claude Code로 직접 만들기

21단계설치 전에 준비할 것

설치에서 막히는 이유는 대개 설치 전에 있습니다. 계정, 터미널, 폴더, 회사 정책부터 확인합시다.

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

이 단계를 마치면

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

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

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

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

운영체제 여는 법 열리면 보이는 것
맥 Spotlight 검색에 "터미널"을 치거나, 응용 프로그램 안 유틸리티 폴더에서 터미널을 엽니다 이름@컴퓨터이름 ~ % 같은 줄 끝에 커서
윈도우 시작 메뉴 검색에 "PowerShell"을 칩니다. Windows 터미널이 깔려 있으면 그 안에서 PowerShell을 엽니다 PS C:\Users\이름> 같은 줄 끝에 커서

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

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

구분 나쁜 예 좋은 예
맥 ~/Desktop/새 폴더 (2)/방문 일지 ~/work/visit-log
윈도우 C:\Users\김철수\OneDrive\바탕 화면\영업 도구 C:\work\visit-log

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

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

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

준비 항목 확인하는 법 안 되면
Claude 유료 계정 웹에서 로그인해 요금제를 봅니다 요금제를 정하거나, 회사 계정이면 관리자에게 허용을 묻습니다
터미널 열어서 프롬프트가 보입니다 검색 이름을 다시 확인합니다
작업 폴더 경로에 한글·공백이 없습니다 드라이브나 홈 바로 아래에 새로 만듭니다
설치 권한 회사 PC면 IT 담당자의 답을 받았습니다 개인 노트북으로 연습합니다
GitHub 계정 25단계에서 만듭니다. 개인 이메일을 준비합니다 회사 계정은 조직 승인이 필요할 수 있습니다

현장 장면

윤 과장은 회사 노트북으로 시작하려 했습니다. 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 사용] 중 해당하는 것.
정중하지만 짧게, 담당자가 예·아니오로 답할 수 있게 질문을 끝에 목록으로 정리해 줘.

막히면 이렇게

증상 원인 처방
프롬프트 경로에 한글 이름이 보입니다 사용자 이름이 한글입니다 드라이브나 홈 바로 아래에 영문 작업 폴더를 새로 만듭니다
cd 뒤에 "경로를 찾을 수 없다"가 나옵니다 폴더 이름 오타이거나 다른 곳에 만들었습니다 파일 탐색기에서 폴더 주소를 복사해 cd 뒤에 붙입니다
보안 프로그램이 실행을 막았다는 창이 뜹니다 회사 정책이 스크립트 실행을 막습니다 설정을 풀지 말고 IT 담당자에게 요청합니다
Claude 웹에서 Claude Code 항목이 안 보입니다 요금제나 조직 설정 문제입니다 요금제를 확인하고, 회사 계정이면 관리자에게 묻습니다

실습 파일

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

스스로 점검

  • ☐ 터미널을 열고 지금 있는 폴더가 어디인지 말할 수 있습니까?
  • ☐ 작업 폴더 경로에 한글, 띄어쓰기, 동기화 폴더가 없습니까?
  • ☐ 회사 PC라면 설치해도 된다는 답을 받았습니까?
점검 해설 보기
  1. 터미널이나 PowerShell을 열어 프롬프트에 적힌 경로를 읽고, pwd로 지금 위치를 확인할 수 있으면 통과입니다. 아직 어렵다면 운영체제별로 여는 법을 정리한 표를 보고, pwd, cd, ls(또는 dir) 세 명령만 다시 연습합니다.
  2. cd로 작업 폴더에 들어갔을 때 프롬프트 경로 전체가 영문이고 공백이 없으며, 동기화 폴더 밖에 있으면 통과입니다. 사용자 이름이 한글이라면 C:\work처럼 드라이브나 홈 바로 아래에 새 폴더를 만듭니다. 나쁜 예와 좋은 예를 비교한 표를 다시 봅니다.
  3. IT 담당자에게서 설치 권한, 스크립트 실행, 외부 주소 접속에 대한 답을 글로 받았으면 통과입니다. 답이 없으면 「복사해 쓰는 프롬프트」로 요청 메일을 만들어 보내고, 허락이 어렵다면 개인 노트북으로 연습합니다. 보안 설정을 직접 풀어서는 안 됩니다.

기억할 것

  • 작업 폴더는 영문, 공백 없이, 동기화되지 않는 곳에 새로 만듭니다.
  • 회사 PC의 정책은 우회하지 않고 먼저 묻습니다.
v2026.09.27.7 · 2026년 9월 27일 기준 · CEO비즈니스스쿨 김문수 교수 · 기능과 화면은 자주 바뀝니다. 책과 화면이 다르면 부록의 공식 문서가 기준입니다.