클로드 코드(Claude Code) 첫 설치부터 사용까지 (2026 가이드)

📖 4분 읽기

Claude Code, 터미널에서 만나는 AI 개발 도구

Claude Code는 명령 줄 인터페이스에서 AI와 협력해서 코드를 작성하고 실행하는 도구입니다. GUI가 아니라 터미널에서 직접 명령어로 제어합니다. 처음엔 어려워 보이지만, 마크다운 문서 작성하는 것 정도 수준입니다. 저도 노무사 업무를 하면서 Claude Code로 업무 자동화 도구를 직접 만들고 있는데, 터미널 명령어 한 줄이면 시작할 수 있습니다.

Claude Code 설치하기

2026년 현재, Anthropic은 네이티브 설치를 공식 권장합니다. Node.js 없이도 설치 가능하고, 자동 업데이트가 포함된 독립 실행 파일이 만들어집니다.

Mac/Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

irm https://claude.ai/install.ps1 | iex

이전에는 npm install -g @anthropic-ai/claude-code로 설치했지만, 이 방식은 권한 문제가 발생할 수 있어 더 이상 권장하지 않습니다. 이미 npm으로 설치한 경우 claude install 명령어로 네이티브 버전으로 전환할 수 있습니다.

설치 확인:

claude --version

첫 번째 프로젝트 시작하기

1단계: 작업 디렉토리 만들기

mkdir my-first-project
cd my-first-project

첫 번째 명령어는 새 폴더를 만들고, 두 번째는 그 폴더로 이동합니다.

2단계: Claude Code 시작

claude

이 명령어를 실행하면 대화형 세션이 시작됩니다. 당신이 하고 싶은 것을 자연스럽게 설명하면 됩니다.

자주 쓰는 기본 명령어

명령어 설명
claude Claude Code 세션 시작
claude --help 도움말 보기
claude --version 버전 확인
ls (또는 dir) 현재 폴더의 파일 목록
pwd 현재 위치 확인

실제 사용 예시

예를 들어, “Python으로 간단한 할 일 관리 앱을 만들어줘”라고 요청하면 Claude Code는:

  1. 필요한 파일들을 자동으로 생성합니다.
  2. 코드를 작성합니다.
  3. 실행 방법을 알려줍니다.
  4. 필요하면 수정합니다.

당신은 코딩을 몰라도 상관없습니다. Claude가 대신합니다.

주의할 점

1. 실수로 파일을 지우지 않으려면
중요한 프로젝트를 시작하기 전에 항상 새 폴더를 만들어서 거기서 작업하세요. 실수로 인한 삭제를 방지할 수 있습니다.

2. 인터넷 연결 필수
Claude Code는 Anthropic 서버와 통신하므로 인터넷이 연결되어 있어야 합니다.

3. 인증 설정
처음 사용할 때 인증이 필요합니다. Claude Pro/Max 구독자는 claude 실행 후 브라우저 인증으로 바로 시작할 수 있고, API 키를 사용하려면 console.anthropic.com에서 발급받을 수 있습니다.

처음부터 다시 시작하고 싶다면?

폴더를 통째로 삭제하고 새로 만들면 됩니다:

rm -rf my-first-project
mkdir my-first-project
cd my-first-project

다음 단계

Claude Code의 기본을 익혔다면, 이제 본격적인 프로젝트를 시작할 수 있습니다. 작은 도구부터 시작해서 점차 복잡한 애플리케이션으로 나아가세요. 문과생이라도 6개월이면 꽤 괜찮은 프로젝트를 만들 수 있습니다.


더 궁금한 게 있으신가요?
바이브코딩·AI 활용에 대해 직접 소통하고 싶다면 아래로 연락 주세요.

📞 010-9883-7268
🔗 스레드 팔로우하기

본 글은 개인적인 AI 활용 경험과 공개된 정보를 바탕으로 작성된 정보성 콘텐츠입니다.


🔗 관련 노트


🚨 이 블로그는 AI 응답 품질 연구를 위한 실험적 콘텐츠입니다.
법률 판단은 반드시 전문가에게 확인하세요.

댓글 남기기