클로드코드 설치 가이드: 터미널에서 AI와 코딩하는 법

터미널에서 직접 AI와 대화하며 코드를 작성하고 싶으신가요? ChatGPT나 웹 기반 AI 도구를 사용하면서 “코드 복사-붙여넣기가 너무 번거롭다”고 느끼셨다면, 클로드코드(Claude Code)가 정답입니다.

이 글에서는 클로드코드 설치부터 첫 번째 명령어 실행까지, 개발 초보자도 따라할 수 있도록 단계별로 안내합니다. 글을 끝까지 읽으면 5분 안에 터미널에서 AI 코딩 어시스턴트를 사용할 수 있습니다.

클로드코드란?

클로드코드(Claude Code)는 Anthropic에서 개발한 CLI(Command Line Interface) 기반 AI 코딩 어시스턴트입니다. 웹 브라우저 없이 터미널에서 직접 Claude AI와 대화하며 코드를 작성, 수정, 실행할 수 있습니다.

주요 특징

클로드코드가 기존 AI 도구와 다른 점은 다음과 같습니다:

파일 직접 편집: 프로젝트 파일을 읽고 수정할 수 있습니다
터미널 명령 실행: git, npm 등 개발 도구를 AI가 직접 실행합니다
컨텍스트 유지: 전체 프로젝트 구조를 이해하고 작업합니다
MCP 서버 연동: 외부 도구와 연결해 기능을 확장할 수 있습니다

기존에 웹에서 코드를 복사해 붙여넣는 방식과 달리, 클로드코드는 “이 파일 수정해줘”라고 말하면 직접 파일을 열어 수정합니다. AI 코딩의 새로운 패러다임이라고 할 수 있죠.

설치 전 준비사항

클로드코드를 설치하기 전에 몇 가지 필수 요구사항을 확인해야 합니다. 아래 체크리스트를 하나씩 확인해 보세요.

필수 요구사항

항목	요구 버전	확인 방법
Node.js	18.0 이상	`node --version`
npm	8.0 이상	`npm --version`
운영체제	macOS, Windows, Linux	–

Node.js 설치 확인

터미널을 열고 다음 명령어를 입력하세요:

node --version

v18.0.0 이상이 출력되면 준비 완료입니다. 만약 설치되어 있지 않거나 버전이 낮다면, Node.js 공식 사이트에서 LTS 버전을 다운로드하세요.

Anthropic 계정 준비

클로드코드는 Anthropic의 Claude API를 사용합니다. 다음 두 가지 방법 중 하나로 인증할 수 있습니다:

Claude Pro/Max 구독: 웹 로그인으로 간편하게 연동
API 키 사용: Anthropic Console에서 발급

개인 사용자라면 Claude Pro 구독이, 팀이나 자동화 용도라면 API 키 방식이 적합합니다.

운영체제별 설치 방법

클로드코드 설치는 npm을 통해 간단하게 진행됩니다. 운영체제별로 약간의 차이가 있으니 자신의 환경에 맞는 방법을 따라하세요.

macOS 설치

맥북 클로드코드 설치는 터미널 앱을 열고 한 줄만 입력하면 됩니다:

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

권한 오류 발생 시:

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

설치가 완료되면 claude 명령어가 시스템 어디서든 사용 가능해집니다.

Windows 설치

Windows에서는 PowerShell 또는 명령 프롬프트를 관리자 권한으로 실행한 후 설치합니다:

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

Windows Terminal 사용 권장: 기본 명령 프롬프트보다 Windows Terminal을 사용하면 더 나은 사용 경험을 얻을 수 있습니다.

Linux 설치

Ubuntu, Debian, Fedora 등 대부분의 Linux 배포판에서 동일한 명령어로 설치합니다:

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

nvm 사용자 참고: nvm으로 Node.js를 관리하는 경우 sudo 없이 설치할 수 있습니다.

설치 확인

설치가 정상적으로 완료되었는지 확인하려면:

claude --version

버전 번호가 출력되면 설치 성공입니다.

초기 설정 및 인증

설치 후 처음 실행하면 인증 과정이 필요합니다. Claude Pro 구독자와 API 키 사용자의 설정 방법이 다릅니다.

방법 1: Claude Pro/Max 구독자 (권장)

가장 간단한 방법입니다. 터미널에서 다음 명령어를 실행하세요:

claude

처음 실행하면 브라우저가 열리면서 Anthropic 로그인 페이지로 이동합니다. 로그인하면 자동으로 인증이 완료됩니다.

방법 2: API 키 사용

API 키를 사용하려면 환경 변수를 설정합니다:

macOS/Linux:

export ANTHROPIC_API_KEY="your-api-key-here"

영구 설정을 원하면 ~/.zshrc 또는 ~/.bashrc에 추가하세요.

Windows PowerShell:

$env:ANTHROPIC_API_KEY="your-api-key-here"

설정 파일 구성

클로드코드는 ~/.claude/ 디렉토리에 설정을 저장합니다. 주요 설정 파일:

settings.json: 기본 설정
commands/: 사용자 정의 명령어
.clauderc: 프로젝트별 설정

첫 번째 사용 예시

설정이 완료되었다면, 이제 클로드코드를 실제로 사용해 봅시다. 간단한 예시부터 시작해 점점 복잡한 작업으로 나아가겠습니다.

기본 대화

터미널에서 claude 명령어로 대화 모드에 진입합니다:

claude

프롬프트가 나타나면 자연어로 질문하세요:

> Python으로 피보나치 수열 함수 만들어줘

Claude가 코드를 생성하고 설명까지 제공합니다.

파일 작업

특정 파일을 분석하거나 수정하려면:

claude "이 파일의 버그를 찾아줘" src/main.py

또는 대화 모드에서:

> @src/main.py 이 코드 리팩토링해줘

@ 기호로 파일을 참조하면 Claude가 해당 파일을 읽고 작업합니다.

프로젝트 전체 작업

프로젝트 루트에서 클로드코드를 실행하면 전체 구조를 파악합니다:

cd my-project
claude "이 프로젝트의 구조를 설명해줘"

터미널 명령 실행

Claude에게 직접 명령어 실행을 요청할 수도 있습니다:

> git status 보여주고 변경사항 커밋해줘

Claude가 git status를 실행하고, 적절한 커밋 메시지를 작성해 커밋까지 진행합니다.

실전 활용 팁

클로드코드를 더 효과적으로 사용하기 위한 팁을 소개합니다.

슬래시 명령어 활용

자주 사용하는 작업은 슬래시 명령어로 빠르게 실행할 수 있습니다:

명령어	기능
`/help`	도움말 보기
`/clear`	대화 초기화
`/compact`	컨텍스트 압축
`/cost`	사용량 확인

CLAUDE.md 파일

프로젝트 루트에 CLAUDE.md 파일을 만들면 프로젝트별 지침을 설정할 수 있습니다:

# 프로젝트 규칙
- TypeScript 사용
- 함수형 프로그래밍 선호
- 테스트 필수 작성

Claude가 이 파일을 읽고 프로젝트 컨벤션을 따릅니다.

MCP 서버 연동

MCP(Model Context Protocol) 서버를 연결하면 Claude의 기능을 확장할 수 있습니다. 예를 들어:

데이터베이스 직접 조회
외부 API 호출
파일 시스템 확장 접근

VS Code 확장 프로그램과 함께 사용하면 더욱 강력한 개발 환경을 구축할 수 있습니다.

자주 묻는 질문

Q: 클로드코드는 무료인가요?

클로드코드 CLI 자체는 무료입니다. 하지만 사용하려면 다음 중 하나가 필요합니다:
– Claude Pro/Max 구독 ($20/월~)
– Anthropic API 키 (사용량 기반 과금)

개인 학습 용도라면 Claude Pro 구독이 가성비가 좋습니다.

Q: 맥북 클로드코드 설치 시 권한 오류가 발생해요

EACCES 오류가 나타나면 두 가지 해결책이 있습니다:

sudo로 설치: sudo npm install -g @anthropic-ai/claude-code
npm 기본 디렉토리 권한 변경 (권장):

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Q: VS Code에서 사용할 수 있나요?

네, 두 가지 방법이 있습니다:

VS Code 내장 터미널: 터미널에서 claude 실행
Claude Dev 확장: VS Code 마켓플레이스에서 설치

터미널 AI 경험을 선호한다면 내장 터미널 사용을, GUI를 원한다면 확장 프로그램을 추천합니다.

Q: 오프라인에서 사용 가능한가요?

아니요, 클로드코드는 인터넷 연결이 필수입니다. 모든 AI 처리는 Anthropic 서버에서 이루어지기 때문입니다.

Q: 코드가 Anthropic 서버로 전송되나요?

네, 요청 시 관련 코드가 서버로 전송됩니다. 민감한 코드나 기밀 정보가 있다면 주의가 필요합니다. Anthropic은 사용자 데이터를 모델 학습에 사용하지 않는다고 명시하고 있습니다.

마치며

이 글에서 클로드코드 설치부터 실전 활용까지 살펴보았습니다. 핵심을 정리하면:

Node.js 18+ 환경에서 npm으로 간단히 설치
Claude Pro 구독 또는 API 키로 인증
터미널에서 자연어로 코딩 작업 요청

클로드코드는 단순한 코드 생성 도구가 아닙니다. 파일을 읽고, 수정하고, 명령어를 실행하는 진정한 AI 페어 프로그래머입니다.

지금 바로 터미널을 열고 npm install -g @anthropic-ai/claude-code를 실행해 보세요. AI와 함께하는 새로운 코딩 경험이 시작됩니다.

이 글이 도움이 되셨다면, 댓글로 클로드코드 사용 후기를 공유해 주세요!

클로드코드 설치 가이드: 터미널에서 AI와 코딩하는 방법