클로드 코드 사용법|설치·요금·CLAUDE.md 정리
클로드 코드 설치 요건과 운영체제별 공식 설치 명령, Pro·Max 계정 로그인, API 키 과금 주의, CLAUDE.md와 /init·/memory 사용법, 사용량 한도 대처, IDE·웹 사용을 2026-09-23 공식 문서 기준으로 정리했습니다.
최종 업데이트 2026.10.02 · 공식 자료 기준
클로드 코드는 터미널이나 지원되는 IDE에서 Claude 모델에 바로 접근해 코딩 작업을 맡길 수 있는 Anthropic의 코딩 도구입니다.
처음 쓰려는 분이 막히는 지점은 대개 세 곳입니다. 어떻게 설치하고 로그인하는지, 프로젝트 규칙을 매번 설명하지 않으려면 무엇을 해야 하는지, 그리고 쓰다가 사용량이 다 차면 어떻게 되는지입니다.
Pro와 Max 플랜은 웹·데스크톱·모바일의 Claude와 터미널의 클로드 코드를 하나의 구독으로 함께 씁니다. 아래에서 설치, CLAUDE.md, 사용량 한도, IDE와 웹 사용까지 순서대로 정리했습니다.
클로드 코드 사용법, 먼저 확인할 것
설치 전에 내 계정이 어떤 방식으로 클로드 코드를 쓰게 될지부터 정하세요. Pro나 Max 구독으로 로그인하면 구독에 포함된 사용량을 씁니다.
Team 플랜은 모든 시트에 클로드 코드가 포함되고, Premium 시트는 업무량이 많은 구성원을 위해 더 많은 사용량을 제공합니다.
무료(Free) 플랜에서 클로드 코드를 쓸 수 있는지는 공식 도움말에 따로 적혀 있지 않습니다. 공식 안내는 Pro와 Max를 기준으로 설명합니다.
플랜별 가격과 비교는 클로드 코드 요금에서 볼 수 있습니다.
클로드 코드 설치하고 로그인하는 순서
클로드 코드가 돌아가는 환경은 macOS 13.0 이상, Windows 10 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상입니다.
하드웨어는 4GB 이상 RAM과 x64 또는 ARM64 프로세서가 필요하고, 인터넷 연결이 있어야 합니다. 셸은 Bash, Zsh, PowerShell, CMD를 쓸 수 있습니다.
공식 설치 명령은 운영체제마다 다릅니다.
| - macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash |
|---|
- Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
설치가 끝나면 작업할 프로젝트 폴더로 이동해 클로드 코드를 실행합니다. 처음 실행하거나 설정할 때 로그인 안내가 나오면 Claude에서 쓰는 것과 같은 계정으로 로그인하세요. 그러면 Pro나 Max 구독이 클로드 코드에 연결됩니다.
Team이나 Enterprise 계정이라면 "구독이 있는 Claude 계정"을 고른 뒤 OAuth 화면에서 조직 플랜을 선택하고 승인을 누릅니다.
구독인데 API 요금이 나오는 이유
내 컴퓨터에 ANTHROPIC_API_KEY 환경변수를 넣어 두었다면, 클로드 코드는 구독 계정이 아니라 그 API 키로 로그인합니다.
이 경우 구독에 포함된 사용량 대신 API 사용 요금이 따로 청구됩니다. 예전에 API를 시험해 보느라 환경변수를 넣어 둔 적이 있다면 설치 전에 확인하세요.
구독 요금과 API 요금은 서로 다른 체계입니다. 클로드 코드에서 API 크레딧으로 계속 쓰기로 선택하면 Pro·Max 가격과 다른 표준 API 요금으로 청구됩니다.
CLAUDE.md로 프로젝트 규칙 정리하기
빌드 방법이나 코드 규칙을 대화마다 다시 설명하지 않으려면 CLAUDE.md를 씁니다.
CLAUDE.md는 프로젝트, 개인 작업 방식, 조직 전체를 위한 지속적인 지침을 담는 마크다운 파일입니다. 모든 대화를 시작할 때 자동으로 읽힙니다.
가장 쉬운 시작은 /init 명령입니다. 실행하면 클로드 코드가 코드베이스를 분석해 빌드 명령, 테스트 방법, 프로젝트 규칙을 담은 CLAUDE.md를 만들어 줍니다. 이미 파일이 있으면 덮어쓰지 않고 개선할 점을 제안합니다.
파일을 두는 위치에 따라 적용 범위가 달라집니다.
| 위치 | 적용 범위 |
|---|---|
| ~/.claude/CLAUDE.md | 내 모든 프로젝트에 적용되는 개인 선호 |
| ./CLAUDE.md 또는 ./.claude/CLAUDE.md | 저장소에 올려 팀과 공유하는 프로젝트 지침 |
| ./CLAUDE.local.md | 이 프로젝트에서 나만 쓰는 설정, .gitignore에 추가 |
파일은 짧게 유지하는 것이 좋습니다. 공식 문서는 파일당 200줄 이하를 권장하고, 이를 넘기면 컨텍스트를 더 쓰고 지침을 따르는 정도가 떨어질 수 있다고 설명합니다.
지금 어떤 메모리 파일이 있는지는 /memory 명령으로 볼 수 있습니다. 목록에서 파일을 골라 바로 편집할 수 있고, 클로드 코드가 스스로 배운 내용을 쌓는 자동 메모리를 켜고 끌 수도 있습니다.
클로드 코드 사용량 한도와 소진 시 대처
구독으로 쓰면 웹의 Claude와 클로드 코드가 같은 사용량 한도를 함께 씁니다. IDE에서 쓴 사용량도 여기에 포함됩니다.
한도에 자주 닿는다면 선택지는 네 가지입니다. Max 5x 플랜으로 올리기, 사용 크레딧을 켜서 한도 이후에도 계속 쓰기, Claude Console 계정으로 바꿔 API 크레딧 구매하기, 한도가 초기화될 때까지 기다리기입니다.
사용 크레딧과 API 크레딧은 구독료에 포함된 것이 아니라 따로 청구됩니다. 켜기 전에 청구 방식을 확인하세요. 한도 구조 전체는 클로드 사용량 한도에서 정리했습니다.
IDE와 웹에서 클로드 코드 쓰는 법
Pro와 Max에는 VS Code, Cursor 같은 VS Code 계열과 IntelliJ, PyCharm 같은 JetBrains IDE에서 쓰는 클로드 코드도 포함됩니다. 터미널과 같은 계정으로 로그인하면 됩니다.
웹에서도 쓸 수 있습니다. 웹용 클로드 코드는 GitHub 저장소의 코드로 원격 작업을 실행하고, 작업을 시작한 뒤 페이지를 떠나도 계속 진행됩니다. 끝나면 검토할 변경 사항을 담은 풀 리퀘스트를 자동으로 만듭니다.
웹 작업은 그 작업만을 위한 격리된 가상 머신에서 실행됩니다. GitHub 인증은 보안 프록시로 관리돼 자격증명이 작업 환경에 직접 들어가지 않습니다.
어느 방식이든 처음에는 수정 없이 저장소 구조를 요약하게 하고, 수정 계획을 먼저 받은 뒤 변경 내용과 테스트 결과를 직접 검토하는 순서가 안전합니다. 삭제나 배포처럼 되돌리기 어려운 작업은 따로 확인하세요.