먼저, 확실히 짚고 넘어가자: Claude Code가 정확히 무엇인가?
2분만 읽어보면, 왜 설치해야 하는지 알게 될 것이다.
많은 사람들이 Claude Pro에 가입해서 매일 이렇게 사용하고 있다:
한 가지 핵심 차이점: 웹 버전 Claude는 서버에 존재하며 로컬 환경과 연결되지 않는다. Claude Code는 사용자 컴퓨터에 설치되어 파일을 읽고 실제 작업을 완료하도록 도와준다.
프로그래밍 배경 지식은 필요 없다: 아래의 모든 작업은 복사 & 붙여넣기만 할 줄 알면 된다. 진짜다!
【01】 설치 전 준비 사항
시작하기 전에 두 가지를 먼저 해결해야 한다. 대부분의 설치 실패와 반복되는 오류가 여기서 비롯된다.
⚠️ 중요: 네트워크 문제. Claude Code의 서버는 미국에 있다. 안정적인 프록시가 없으면 이후 모든 작업이 무용지물이다. claude.ai에 정상적으로 접속되는지 확인하고, 글로벌 모드에서 미국 노드를 사용하는 것을 권장한다. 웹 페이지는 열리는데 프록시 노드가 잘못되었거나 글로벌 모드가 켜져 있지 않아 설치가 실패하는 경우가 많다.
필요한 계정:
✅ Claude Pro 구독 (월 $20) — 이미 구독 중이라면 추가 비용 없이 바로 시작 가능
✅ claude.ai에 접속할 수 있는 네트워크 환경
확인되었으면, 사용 중인 시스템에 맞는 설치 가이드로 넘어가자!
【02】 Mac / Linux 설치 방법
명령어 하나로 3분이면 끝
- "터미널" 열기: Command + Space를 누르고 "터미널"을 검색한 후 Enter를 누른다. 깜빡이는 커서가 있는 검은색(또는 흰색) 창이 나타날 것이다. 겁내지 마라. 이게 바로 "검은 상자"다.
- 설치 명령어를 붙여넣고 Enter 누르기: 아래 줄을 복사해서 터미널에 붙여넣고 Enter를 누른다. 그런 다음 조용히 기다리면 영문 텍스트가 스크롤되는데, 정상이니 당황하지 말자. 저절로 멈출 때까지 기다린다.
claude입력하고 Enter 누르기: 설치가 완료되면 터미널에claude를 입력하고 Enter를 누른다.
- 로그인 방식 선택 후 브라우저에서 인증하기: 방향키를 사용하여 "1. Claude account with subscription"을 선택하고 Enter를 누른다. 브라우저가 열리면 검은색 "Authorize" 버튼을 클릭한다.
- 성공: 터미널에 "Welcome back!" 또는 Claude 대화형 인터페이스가 나타나면 설치 성공이다!
✓ 성공 신호: 터미널에 Claude ASCII 로고가 나타나거나 "Welcome back, [사용자 이름]."이 표시된다.
【03】 Windows 설치 방법
마찬가지로 간단하다. 역시 3분이면 끝
- PowerShell 열기: Win + S를 누르고 "PowerShell"을 검색한 후 마우스 오른쪽 버튼을 클릭하여 "관리자 권한으로 실행"을 선택한다. 이것 역시 검은색 창이다.
- 설치 명령어를 붙여넣고 Enter 누르기:
- 설치 완료 기다리기: 진행률 표시줄이나 스크롤되는 텍스트를 보며 인내심을 가지고 기다린다. 이 시간 동안 창을 닫지 마라.
claude입력하고 Enter 누른 후 브라우저에서 로그인하기: Mac 단계와 동일하다.claude를 입력하고 Enter를 누르면 브라우저가 열리고 "Authorize"를 클릭하면 끝이다.
⚠️ Windows 특별 참고: "scripts are disabled"라는 메시지가 나타나면 먼저 다음 명령어를 실행하여 잠금을 해제한 후 설치를 다시 시도하라:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
【04】 설치 실패? 90%의 함정이 여기에 있다
오류가 발생해도 당황하지 마라. 가장 흔한 세 가지 함정과 해결 방법을 소개한다:
🪤 함정 #1: 진행률 표시줄 정체 / ETIMEDOUT 오류. 가장 흔한 문제다.
원인은 브라우저에서 Claude를 열 수 있더라도 터미널(검은 상자)이 프록시를 사용하지 않기 때문이다. Mac 사용자: 터미널에서 다음 명령어를 실행하여 프록시 포트를 확인하라: networksetup -getwebproxy "Wi-Fi"
포트 번호(예: 15236)를 기억한 후, 다음 명령어를 실행하라 (숫자는 사용자 환경에 맞게 변경): export https_proxy=http://127.0.0.1:15236 http_proxy=http://127.0.0.1:15236 all_proxy=socks5://127.0.0.1:15236
✓ 해결 방법: 위 줄을 실행한 후 설치 명령어를 다시 붙여넣어라.
🪤 함정 #2: "command not found"
설치 후 claude를 입력했을 때 "command not found" 오류가 발생하면 일반적으로 PATH가 아직 적용되지 않은 것이다.
✓ 해결 방법: 터미널 창을 닫고 새 창을 연 후 다시 claude를 입력해보아라.
🪤 함정 #3: 브라우저는 열리지만 인증 실패
Authorize를 클릭해도 반응이 없거나 오류 페이지로 돌아간다. 일반적으로 로그인된 Claude 계정이 Pro가 아니거나 점프 중 네트워크가 끊긴 경우다.
✓ 해결 방법: claude.ai 계정이 Pro인지 확인하고, 프록시를 글로벌 모드로 설정한 후 브라우저를 닫고 다시 시도하라.
💡 범용 문제 해결 팁:
오류가 발생하면 빨간색 오류 텍스트를 복사하여 웹 버전 Claude에 붙여넣고 "Claude Code를 설치하는 중인데 이 오류가 발생했습니다. 원인 분석을 도와주세요"라고 말하면 해결 방법을 알려줄 것이다.
【05】 설치 완료! 어떻게 시작하나?
Claude Code는 "터미널" 안에서 사용한다. 사용할 때마다 먼저 작업 폴더로 이동한 후 시작해야 한다.
1. 터미널을 열고 작업 폴더로 이동
예를 들어 바탕화면에 "Work"라는 폴더에 파일이 있다면:
cd ~/Desktop/Work
💡 cd가 무엇인가? cd = Change Directory, 즉 "이 폴더로 들어가라"는 뜻이다. 경로를 자신의 폴더로 변경하면 된다.
2. `claude`를 입력하여 시작:
Claude 인터페이스가 나타나면 한국어로 직접 대화할 수 있다. 마치 카카오톡 메시지를 보내듯이 하고 싶은 작업을 알려주면 된다.
처음에는 간단한 명령어로 실제로 컴퓨터를 작동하는지 확인해보자:
📋 예시 명령어
바탕화면에 "Claude Works"라는 폴더를 만들고, 그 안에 "첫 번째 파일.txt"라는 새 텍스트 파일을 생성해줘. 파일 내용에는 오늘 날짜와 "Claude Code 설치 성공!"이라고 적어줘.
그러면 바탕화면에 폴더와 파일이 즉시 나타날 것이다. 이것이 CC와 웹 버전의 핵심적인 차이점이다 — 단순히 텍스트를 출력하는 것이 아니라 실제로 사용자를 위해 작업을 수행한다.
【06】 가장 중요한 단계: 메모리 프로필 만들기
Claude Code를 설치했지만 이 작업을 하지 않으면 여전히 "기억을 못하는 임시 직원"을 사용하는 것이다.
이 단계를 거치면 사용자가 누구인지, 무엇을 하고 있는지, 어떤 스타일을 선호하는지 기억할 수 있어 두 번 다시 자기소개를 할 필요가 없다.
Claude Code 인터페이스에서 다음 내용을 복사하여 붙여넣는다 (대괄호 안의 내용은 사용자 정보로 변경):
📋 예시 명령어
제 이름은 [사용자 이름]이고, [작업 방향, 예: 소셜 미디어 운영자 / PM / 프리랜서]로 일하고 있습니다.
주요 일상 업무는 다음과 같습니다:
- [업무 1, 예: 블로그 글 작성]
- [업무 2, 예: 고객 프로젝트 관리]
- [업무 3]
작업 스타일 선호도: [예: 간결하고 직설적으로 / 각 단계별 자세한 설명 필요]
자주 사용하는 도구: [예: Notion, 피그마, Slack]
위 정보를 기록하여 장기 협업의 기반으로 삼을 CLAUDE.md 파일을 생성해주세요. 앞으로 Claude Code를 열 때마다 이 파일을 먼저 읽고 제 배경을 이해한 후 작업을 시작해야 합니다.
그러면 작업 폴더에 CLAUDE.md 파일이 생성된다. 이것이 바로 Claude Code의 "메모리 프로필"이다.
✓ 이 파일의 역할: Claude Code를 시작할 때마다 자동으로 CLAUDE.md를 읽고 사용자가 누구인지, 무엇을 하고 있는지, 선호하는 스타일이 무엇인지 파악한 후 작업을 시작한다. 다시는 자기소개를 반복할 필요가 없다.
【07】 고급: 사용할수록 강해지는 시스템 구축하기
대부분의 사람들은 AI를 "소모품" 방식으로 사용한다: 열고, 결과를 얻고, 닫고, 지우고, 석 달이 지나면 쌓인 것이 아무것도 없다.
진정으로 가치 있는 사용 방식은 "축적형"이다: 작업할 때마다 결과가 저장되고 경험이 시스템에 축적되어 다음 번에는 더 빠르고 더 좋아진다.
폴더를 하나씩 만들 필요 없다. 이 내용을 복사하여 Claude Code가 대신 만들어주도록 하자:
📋 예시 명령어
작업 시스템을 위한 폴더 구조를 구축해주세요.
제 상황은 다음과 같습니다:
- 제가 하는 일: [2-4개의 업무 라인 나열, 예: 소셜 미디어 콘텐츠 제작, 컨설팅 프로젝트 수행, 영어 공부]
- 현재 가장 큰 문제점: [예: 아이디어가 항상 사라짐 / 자료를 찾을 수 없음 / AI가 내 맥락을 기억하지 못함]
다음을 도와주세요:
- 저에게 적합한 디렉토리 구조 설계
- 현재 디렉토리에 모든 폴더 생성
- 각 폴더의 용도를 설명하는 README.md 파일 생성
- CLAUDE.md 업데이트하여 앞으로 들어올 때 전체 시스템을 빠르게 파악할 수 있도록 함
【08】 코딩을 못하는 사람들이 실제로 사용하는 방법
다음은 실제 사례들이다. 모든 명령어를 그대로 복사하여 Claude Code에 붙여넣을 수 있다:
📝 소셜 미디어 / 콘텐츠 제작 "3개월치 트윗 초안을 주제별로 정리하고, 아직 다루지 않은 각도가 무엇인지 찾아서 주제 제안 보고서를 생성해줘." → 파일 읽기 → 분류 → 격차 분석 → 보고서 작성
📊 영업 / 고객 관리 "지난 6개월간의 고객 채팅 기록을 스캔하여 각 고객의 핵심 요구사항과痛点을 요약하고, 고객 페르소나 보고서를 생성해줘." → 파일 일괄 읽기 → 분석 → 구조화된 보고서
📋 프로젝트 관리 "이 회의록을 실행 항목으로 정리하고, 담당자별로 분류하며, 마감일을 표시하고, 후속 목록을 생성해줘." → 10초, 구조화된 목록 완성
🗂️ 지식 / 파일 관리 "바탕화면에 있는 300개의 파일을 업무, 학습, 생활로 분류하고, 지저분한 파일명을 정리하며, 1년 이상 열지 않은 파일을 목록화하여 삭제 여부를 결정할 수 있게 해줘." → 3분, 모든 정리 완료
📈 데이터 분석 "이 엑셀 시트를 분석하여 지난 6개월간 어떤 유형의 콘텐츠가 가장 높은 상호작용을 보였는지 찾고, 패턴을 요약하여 결론을 분석 보고서 파일로 작성해줘." → 표 읽기 → 계산 → 결론 도출
🎯 개인 브랜드 / PPT "[작업 방향]에 대한 투자 피칭 자료를 만들어줘. 문제점, 해결책, 차별성, 실행 계획을 포함한 명확한 프레임워크로 구성해줘." → 프레임워크 바로 생성, 반복 작업 준비 완료
🔑 사용 비결: Claude Code에 명령을 내릴 때는 구체적일수록 좋다. 어떤 파일을 작업할지, 무엇을 할지, 어떤 형식으로 출력할지, 어디에 저장할지 알려줘라. 명확할수록 결과가 정확해진다.
CC를 설치하고, CLAUDE.md를 설정하고, 일주일 동안 사용해보라.
일주일 후면 "AI가 내 컴퓨터에 살게 한다"는 것이 무엇을 의미하는지 진정으로 이해하게 될 것이다. 웹 AI를 석 달 동안 사용해도 쌓이는 것은 없다. CC를 석 달 동안 사용하면 점점 더 나를 이해하는 시스템을 갖게 된다.
이 글을 읽었으면 설치를 못 할 거라고 말하지 마라. 문과 출신 엄마인 나도 할 수 있었는데, 당신도 충분히 할 수 있다!
