AI 에이전트 입문기: 클로드 코드 설치
클로드 코드 설치를 통한 나만의 AI 비서 만들기
"엔진부터 체크하셨나요?"
리눅스 환경에 들어오셨나요? 반갑습니다. 오늘은 최근 개발자와 데이터 과학자들 사이에서 뜨거운 관심을 받고 있는 Claude Code(클로드 코드)를 아주 쉽게, 기초부터 마스터할 수 있는 가이드를 준비했습니다.
Claude Code는 Anthropic에서 내놓은 터미널 기반의 AI 코딩 에이전트입니다. 단순히 코드를 짜주는 것을 넘어, 직접 파일을 읽고, 수정하고, 명령어를 실행하며 프로젝트 전체를 관리할 수 있는 도구죠. 이제 본격적인 Agentic AI의 세계로 들어가기 전, 기초 공사부터 시작해 봅시다.
기초 공사: 왜 Node.js가 필요한가?
Claude Code를 본격적으로 설치하기 전에, 우리는 먼저 'Node.js'라는 엔진을 준비해야 합니다. Claude Code는 자바스크립트 기반의 도구인데, 이 도구가 브라우저를 벗어나 리눅스 환경에서 직접 파일을 읽고 명령을 수행하려면 Node.js라는 실행 환경이 필수적이기 때문입니다. 마치 자동차를 타기 전 엔진 성능을 먼저 점검하는 것과 같습니다.
1. Node.js 설치 및 관리 가이드 (nvm 방식)
1. nvm(Node Version Manager) 설치
터미널에 아래 명령어를 복사해서 붙여넣으세요. 이 도구는 노드의 여러 버전을 마치 앱처럼 쉽게 갈아끼울 수 있게 해줍니다.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
2. 환경 설정 반영하기
설치된 nvm을 터미널이 인식하도록 설정을 새로고침합니다.
source ~/.bashrc
3. Node.js 20 버전(LTS) 설치
클로드 코드는 18 버전 이상을 요구하므로, 현재 가장 안정적인 20 버전을 설치하는 것을 추천합니다.
nvm install 20
4. 설치 확인
아래 명령어를 입력했을 때 v20.x.x와 같은 숫자가 나오면 성공입니다.
node -v
2. Anthropic API 키 확인
1. 클로드 API 키 확인하는 곳
브라우저를 여시고 아래 주소로 접속하세요.
https://console.anthropic.com/
이곳은 일반 대화용 claude.ai와 달리, 개발자나 교수님처럼 API를 쓰려는 분들을 위한 콘솔 페이지입니다.
2. 키 발급 순서
로그인: 평소 쓰시는 계정으로 로그인합니다.
API Keys 메뉴: 화면 상단이나 메뉴에서 'Get API Keys' 또는 'Settings > API Keys'를 클릭합니다.
Create Key: Create Key 버튼을 누르고 이름을 적당히(예: Claudecode_Test) 입력합니다.
복사: sk-ant-api03-...로 시작하는 긴 코드가 나타납니다. 이때 딱 한 번만 보여주니 반드시 복사해서 메모장 같은 곳에 저장해 두세요.
3. 비용 확인 (중요)
API는 claude.ai 유료 결제(Pro 플랜)와는 별개로 운영됩니다.
Credits: 처음에 가입하면 무료 크레딧을 조금 줄 수도 있지만, 보통은 'Billing' 메뉴에서 일정 금액(예: 5달러)을 먼저 충전해야 코드가 정상적으로 작동합니다.
API 키에 잔액이 없으면 "Over quota" 에러가 날 수 있으니 체크해 보세요.
3. Claude Code 설치
먼저 터미널에서 아래 명령어를 입력하여 Claude Code를 전역(global)으로 설치합니다.
npm install -g @anthropic-ai/claude-code
설치가 완료되면, 작업하고자 하는 프로젝트 폴더로 이동한 뒤 다음을 입력하세요.
claude
4. Claude Code 시작하기: 인증 방식 선택
Claude를 잘 입력하셨다면 가장 먼저 인증을 요구합니다. 이때 본인의 사용 환경과 결제 모델에 따라 다음 두 가지 방식 중 하나를 선택해야 합니다.
1. OAuth 인증 방식 (Claude Pro 구독자용)
특징: 웹 브라우저를 통해 본인의 Claude.ai 계정으로 로그인하여 인증합니다.
명령어: 터미널에서 /login 입력.
장점: 추가 비용 없이 월 $20 고정 구독료 범위 내에서 터미널과 웹을 통합해 쓸 수 있어 개인 사용자에게 가장 경제적입니다.
2. API Key 인증 방식 (종량제/개발자용)
특징: Anthropic Console에서 발급받은 sk-... 형태의 고유 키를 입력합니다.
명령어: 최초 실행 시 나타나는 입력창에 직접 붙여넣거나 환경 변수로 설정합니다.
장점: 티어(Tier)를 높여 분당 요청 횟수를 늘릴 수 있어, 수백 장의 사진 분석 등 대규모 자동화 작업에 유리합니다.
� 종량제 vs 구독제: 나에게 맞는 방식은?
5. 바로 써먹는 실전 명령어
이제 Claude에게 일을 시켜볼 차례입니다. 각자의 상황에 맞게 아래와 같이 시작해 보세요.
연구용: "CSV 데이터를 읽고 500도 이상의 데이터만 추출해서 그래프로 그려줘."
집필용: "내 교재 초고를 읽고 논리 전개가 일관적인지 분석해서 보고서를 써줘."
시스템 관리: "폴더 구조를 파악하고 불필요한 파일을 정리하는 셸 스크립트를 짜줘."
6. 마치며: Agentic AI의 세계로
저는 가장 먼저 일본어로 된 복잡한 엑셀 파일을 영어로 번역하는 작업을 시켜보았는데, 토큰 비용은 조금 들었지만 그 결과물은 실로 완벽했습니다. 사람이 몇 시간 고생할 일을 단 몇 초 만에 끝내는 경험, 이것이 바로 우리가 AI 에이전트를 공부해야 하는 이유입니다.
다음 시간에는 OpenClaw를 활용해 텔레그램으로 명령하고 일을 진행하는 '나만의 비서'를 만드는 과정을 공유하겠습니다. 다 같이 진정한 지능형 에이전트의 세계로 가 봅시다!