AIRA@aira
Claude Code 시작하기: 설치, 요금제 및 토큰 절약 방법
브라우저 창에서 Claude와 대화하는 것에 익숙하다면 커맨드 라인 AI 도구는 다소 낯설게 느껴질 수 있습니다. Anthropic은 Claude Code를 통해 에이전트형 코딩 어시스턴트를 터미널로 직접 가져와 이러한 간극을 메우고자 했습니다. 이제 코드 조각을 일일이 복사해서 붙여넣을 필요 없이, 도구가 직접 리포지토리를 읽고, 테스트를 실행하고, 파일을 수정하고, 작업 중인 프로젝트에 관해 직접 질문에 답변할 수 있습니다.
Claude Code의 작동 방식과 실행에 필요한 플랜, 그리고 구독료나 API 크레딧을 소진하지 않고 설정하는 방법을 소개합니다.
Claude Code 사용 권한
Anthropic은 유료 구독 티어와 API 계정에서 Claude Code를 제공합니다. Claude Pro 구독(월 20달러, 또는 연간 결제 시 월 17달러), Claude Team 플랜(좌석당 월 25달러) 또는 Claude Max 플랜(월 100~200달러)을 구독 중인 경우 사용할 수 있습니다. 표준 무료 티어에서는 CLI 액세스가 제공되지 않습니다.
구독 대신 사용한 만큼만 지불하고 싶다면 Anthropic API 키를 연결할 수 있습니다. API 키를 사용하면 호출하는 모델에 따라 토큰 단위로 비용이 청구됩니다. 예를 들어 Claude Sonnet 5.5는 입력 토큰 100만 개당 2.00달러, 출력 토큰 100만 개당 10.00달러이며, 표준 프롬프트 기준 Claude Haiku 5.5는 입력 100만 개당 0.10달러, 출력 100만 개당 0.50달러입니다. 대부분의 일상적인 작업에는 기존 Claude Pro나 Team 구독을 통해 Claude Code를 실행하는 것이 토큰 초과 요금 걱정 없이 매달 예측 가능한 예산을 유지하는 방법입니다.
네이티브 방식으로 CLI 설치하기
Anthropic은 npm과 같은 패키지 관리자보다 네이티브 설치 스크립트를 사용하는 것을 공식 권장합니다. 이렇게 하면 설치 과정이 간소화되고 CLI를 항상 최신 업데이트 경로로 유지할 수 있습니다.
macOS, Linux 또는 Windows용 Linux 하위 시스템(WSL)에서는 터미널을 열고 공식 설치 명령어를 실행하세요:
Windows에서 PowerShell을 사용하는 경우, Claude Code가 Bash 호환 유틸리티 명령어를 액세스할 수 있도록 Git for Windows가 설치되어 있어야 합니다. Git 설정이 완료되면 PowerShell에서 다음 설치 명령어를 실행하세요:
확인 및 로그인
스크립트가 완료되면 터미널 세션을 다시 시작하거나 새 탭을 열어 경로를 업데이트하세요. 다음 명령어로 버전을 확인하여 설치가 성공했는지 확인할 수 있습니다:
Anthropic은 셸 권한, 네트워크 연결 및 종속성을 검사하는 진단 명령어도 기본으로 제공합니다. 초기에 이 명령어를 실행하면 문제 해결 시간을 절약할 수 있습니다:
프로젝트 디렉토리 내에서 claude을 처음 실행하면 대화형 로그인 흐름이 시작됩니다. 브라우저를 통해 Anthropic 구독으로 인증하거나 API 키를 입력하라는 메시지가 표시됩니다. 연결이 완료되면 에이전트가 코드를 분석할 준비를 마칩니다.
CLAUDE.md 파일을 사용한 토큰 절약
에이전트형 CLI 어시스턴트는 로컬 파일을 읽고 디렉토리 구조를 분석하기 때문에, 관리가 되지 않으면 컨텍스트 토큰을 빠르게 소비할 수 있습니다. Anthropic은 토큰 사용량을 효율적으로 유지하기 위해 자동 프로젝트 구성 표준을 만들었습니다.
프로젝트 루트로 이동하여 다음 초기화 명령어를 실행하세요:
이 명령어는 리포지토리를 스캔하고 루트 폴더에 가벼운 CLAUDE.md 마크다운 파일을 생성합니다. 이 파일은 CLI의 영구 메모리 역할을 하며, 패키지 관리자, 테스트 명령어, 코드 형식 규칙 및 폴더 구조와 같은 필수 프로젝트 세부 정보를 캡처합니다.
Claude Code는 시작할 때마다 자동으로 CLAUDE.md을 읽어들입니다. 어시스턴트가 프로젝트 빌드 및 실행 방법을 즉시 이해하기 때문에 모든 폴더를 다시 스캔하거나 반복적인 질문을 할 필요가 없어 쿼리할 때마다 컨텍스트 토큰을 절약할 수 있습니다. 5분만 투자하면 매월 사용량을 효율적으로 관리할 수 있습니다.
