인공지능 AI 코딩 도구, 클로드 코드 쉬운 시작 [코드깎는노인]

Claude Code 설치 및 사용 완전 가이드

1. CLI(Command Line Interface)란 무엇인가?

1.1 CLI의 개념

• CLI: 명령줄 조작 방식(Command Line Interface)
• 그래픽 화면이 아닌 텍스트 명령어로 컴퓨터를 조작하는 방식
• 현재 AI 도구들(Gemini CLI, Claude Code, Canvas CLI, Codex CLI)이 이 방식을 채택

1.2 CLI의 장점

• 자동화 가능: 반복적인 작업을 명령어로 자동화
• 효율성: 마우스 클릭보다 빠른 작업 처리
• 맥락 공유 용이: 텍스트 기반이므로 AI와 상황 공유가 쉬움
• 강력함: 컴퓨터의 모든 기능에 직접 접근 가능

1.3 Windows에서 CLI 실행하기

1. 화면 하단 검색란에 "파워" 입력
2. "Windows PowerShell" 실행
3. 명령어 입력 창 확인

2. Claude Code 설치하기

2.1 사전 준비사항: Node.js 설치

Node.js가 필요한 이유:

• Claude Code는 JavaScript로 작성됨
• Node.js는 JavaScript 코드를 실행하는 런타임 환경

설치 방법:

1. Node.js 공식 사이트 방문
2. LTS 버전 다운로드 및 설치
3. 설치 완료 후 PowerShell 재시작

2.2 Claude Code 설치

설치 명령어:

 

 

bash

npm install -g @anthropic-ai/claude-code

실행 명령어:

 

 

bash

claude

2.3 초기 설정

1단계: 테마 선택

• Dark 모드 또는 Light 모드 선택 (기본값: Dark)

2단계: 요금제 선택

• 구독제: Claude Pro 플랜 사용자 (월정액)
• 사용량제: 사용한 만큼 지불

3단계: 로그인

• 웹브라우저에서 Anthropic 계정으로 로그인
• 승인 버튼 클릭

4단계: 작업 폴더 설정

• 안전한 별도 폴더 생성 권장
• 폴더 우클릭 → "터미널에서 열기"
• claude 명령어 실행
• 작업 권한 승인

3. Claude Code 기본 사용법

3.1 텍스트 파일 생성

예시 명령어:

 

 

세계에서 가장 높은 산 10개의 목록을 텍스트 파일로 만들어줘

결과:

• .txt 파일 자동 생성
• 메모장으로 열어서 확인 가능

3.2 웹페이지 생성

예시 명령어:

 

 

이 내용을 담은 웹페이지를 만들어줘

결과:

• HTML 파일 생성
• 더블클릭으로 브라우저에서 실행
• CSS와 JavaScript가 포함된 인터랙티브 페이지

추가 기능 요청:

 

 

산들의 이름을 클릭하면 산에 대한 자세한 설명이 뜨도록 해줘

3.3 파일 변환 프로그램 생성

예시 명령어:

 

 

웹페이지를 PDF로 변환하는 파이썬 프로그램을 만들어서 실행해줘

처리 과정:

1. 필요한 라이브러리 설치 (예: pdfkit)
2. Python 코드 작성
3. 코드 실행
4. PDF 파일 생성

3.4 애니메이션 웹페이지 생성

사전 준비:

• 이미지 파일들 준비 (image1.jpg, image2.jpg 등)

예시 명령어:

 

 

image1.jpg부터 image4.jpg까지 이미지 파일들을 준비했어.
이미지들이 1초 간격으로 우측에서 좌측으로 부드럽게 넘어가는 애니메이션을 담은 웹페이지를 만들어줘.

수정 요청:

 

 

각 이미지마다 1초씩 멈춰있도록 하고 가장 마지막 이미지에서 완전히 멈추도록 하자. 투명도는 조절할 필요 없다.

4. 실행 가능한 명령어 예시

4.1 기본 파일 생성

 

 

bash

# Claude Code 실행
claude

# 프롬프트 입력 예시들:

4.2 프로젝트별 명령어

데이터 파일 생성:

 

 

한국의 주요 도시 20개와 인구수를 CSV 파일로 만들어줘

간단한 웹 앱:

 

 

할 일 목록을 관리할 수 있는 간단한 웹 앱을 만들어줘. 할 일 추가, 삭제, 완료 표시 기능이 있어야 해.

데이터 처리 스크립트:

 

 

CSV 파일을 읽어서 데이터를 분석하고 차트로 시각화하는 파이썬 스크립트를 만들어줘

게임 제작:

 

 

간단한 숫자 맞추기 게임을 HTML, CSS, JavaScript로 만들어줘

5. 안전 사용 수칙

5.1 보안 주의사항

• ⚠️ 중요 파일이 있는 폴더에서 직접 사용 금지
• ✅ 별도의 안전한 작업 폴더 생성 후 사용
• ⚠️ 명령어 실행 권한 요청 시 신중히 검토
• ✅ 가상 머신 사용 권장 (중요 데이터 보호)

5.2 권한 관리

• 파일 생성/수정 권한 설정
• 시스템 명령어 실행 시 주의
• 자동 승인 설정 시 신중한 판단

6. 추가 팁

6.1 다중 라인 입력

• Windows: Ctrl + Enter
• macOS: Option + Enter

6.2 도움말 활용

 

 

bash

claude --help

6.3 프로젝트 관리

• 각 프로젝트별로 별도 폴더 생성
• 관련 파일들을 한 곳에 정리
• 버전 관리 고려

7. 문제 해결

7.1 설치 관련

• Node.js 버전 확인: node --version
• npm 업데이트: npm update -g @anthropic-ai/claude-code

7.2 실행 관련

• PowerShell 관리자 권한으로 실행
• 방화벽 설정 확인
• 인터넷 연결 상태 확인

7.3 에러 발생 시

• 에러 메시지를 Claude에게 보여주고 해결책 문의
• 작업 폴더 권한 확인
• 필요한 라이브러리 설치 상태 확인

---

시작하기

이제 다음 단계를 따라 Claude Code를 시작해보세요:

1. ✅ Node.js 설치
2. ✅ Claude Code 설치 (npm install -g @anthropic-ai/claude-code)
3. ✅ 안전한 작업 폴더 생성
4. ✅ 터미널에서 claude 실행
5. ✅ 첫 번째 프로젝트 만들기

첫 번째 시도 추천:

 

 

안녕하세요. 간단한 자기소개 웹페이지를 만들어주세요. 이름, 취미, 좋아하는 음식 정보가 들어가면 좋겠습니다.

행운을 빌어요! 🚀