DaleSchool

Claude Code와 첫 만남

입문15분

학습 목표

  • Claude Code가 무엇인지 한 문장으로 설명할 수 있다
  • Claude Code를 설치하고 터미널에서 실행할 수 있다
  • 자연어로 코딩 작업을 요청할 수 있다

동작하는 코드

터미널을 열고 Claude Code를 설치해보세요.

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

설치가 끝났으면 아무 프로젝트 디렉토리에서 실행합니다.

cd ~/my-project
claude

Claude Code가 시작되면 이렇게 입력해보세요:

> 이 프로젝트의 구조를 설명해줘

Claude가 프로젝트의 파일과 디렉토리를 분석해서 요약해줍니다.

직접 수정하기

이번에는 다른 요청을 해보세요:

> package.json에 어떤 의존성이 있는지 알려줘

또는 프로젝트가 없다면 빈 디렉토리에서 시작해도 됩니다:

mkdir claude-test && cd claude-test
claude
> hello.js 파일을 만들어줘. "Hello, Claude Code!"를 출력하는 코드로.

Claude가 파일을 생성하겠다고 제안하면 y를 눌러 승인하세요. 파일이 만들어진 걸 확인할 수 있습니다.

"왜?" — Claude Code는 어떤 도구일까요?

Claude Code는 터미널에서 동작하는 AI 코딩 에이전트입니다. 채팅창에 코드를 복사-붙여넣기하는 게 아니라, 여러분의 프로젝트 안에서 직접 파일을 읽고, 수정하고, 명령어를 실행합니다.

기존 AI 코딩 도구와의 차이점:

| 도구 | 방식 | | ------------------- | ------------------------------------------------- | | ChatGPT / Claude.ai | 코드를 복사해서 붙여넣기 | | GitHub Copilot | 에디터 안에서 자동완성 | | Claude Code | 터미널에서 프로젝트 전체를 이해하고 직접 작업 |

Claude Code는 여러분의 코드베이스를 통째로 파악합니다. 한 파일이 아니라 프로젝트 전체의 맥락을 이해한 상태에서 작업하기 때문에, 여러 파일에 걸친 변경도 한 번에 처리할 수 있습니다.

심화 학습

Claude Code를 쓰려면 뭐가 필요한가요?

Claude Code는 Anthropic의 API를 사용합니다. 두 가지 방법 중 하나를 선택하세요:

  1. Anthropic API 키claude login으로 인증
  2. Max 구독 ($100/월) — API 비용 걱정 없이 사용

처음 시작한다면 API 키 방식을 추천합니다. 사용한 만큼만 과금되고, 실습 수준에서는 비용이 거의 들지 않습니다.

claude를 입력했는데 아무 반응이 없어요

Node.js 18 이상이 설치되어 있는지 확인하세요:

node --version

v18.0.0 이상이어야 합니다. 그보다 낮으면 Node.js를 먼저 업데이트하세요.

  1. Claude Code를 설치하고 claude 명령어로 실행해보세요.
  2. "현재 디렉토리에 어떤 파일이 있어?" 라고 물어보세요.
  3. "README.md 파일을 만들어줘" 라고 요청하고, 결과를 확인해보세요.

Q1. Claude Code는 어디에서 실행하나요?

  • A) 웹 브라우저
  • B) VS Code 확장 프로그램
  • C) 터미널 (커맨드라인)
  • D) 모바일 앱

참고 자료