Claude Code 사용법｜설치·로그인·요금·한도

Claude Code 핵심 답

• 터미널과 지원 IDE에서 사용하는 Anthropic 공식 코딩 도구입니다.
• Pro·Max는 같은 Claude 계정으로 포함 사용량을 이용할 수 있습니다.
• Console API 키 인증은 토큰 기준 별도 과금될 수 있습니다.
• 웹·데스크톱·Claude Code는 구독 한도를 공유합니다.
• 파일 변경과 명령 실행은 사람이 검토하고 복구 가능하게 운영해야 합니다.

현재 포함 플랜과 가격은 Claude 요금제 안내에서 비교할 수 있습니다.

무엇을 할 수 있나

프로젝트 폴더를 탐색하고 오류 관련 파일을 찾으며 변경안을 적용하고 테스트 실행을 도울 수 있습니다. 저장소 구조 파악, 버그 원인 분석, 여러 파일 기능 변경, 테스트 추가, 반복 수정에 적합합니다. 그러나 제안한 코드와 명령을 자동으로 신뢰해서는 안 됩니다.

운영 데이터 삭제, 배포, 외부 메시지, 결제처럼 되돌리기 어려운 작업은 별도 승인과 백업이 필요합니다. 처음에는 읽기 전용 구조 요약과 수정 계획부터 요청하세요.

설치 전 준비와 공식 요구사항

운영체제, 메모리, 네트워크와 셸 요구사항은 업데이트될 수 있으므로 Claude Code 공식 시작 문서를 기준으로 확인합니다. Windows는 WSL 또는 Git for Windows 경로가 안내됩니다.

1. 공식 지원 환경인지 확인합니다.
2. Git 상태와 복구 지점을 점검합니다.
3. Pro·Max 구독과 Console API 중 인증 방식을 결정합니다.
4. 조직의 소스코드·AI 정책을 확인합니다.
5. .env, 키, 인증서와 고객 데이터를 작업 범위에서 제외합니다.

유료 기능이 필요한지 아직 판단하지 못했다면 Claude 무료 이용 안내를 먼저 비교하세요.

설치와 첫 실행 순서

1. 공식 문서에서 운영체제별 최신 설치 방식을 선택합니다.
2. 설치 후 터미널을 새로 열고 실행 파일을 확인합니다.
3. 작업할 프로젝트 폴더로 이동합니다.
4. Claude Code를 실행하고 의도한 계정 유형을 선택합니다.
5. 브라우저 인증에서 이메일과 플랜을 확인합니다.
6. 읽기 전용 질문으로 저장소 인식을 시험합니다.
7. 첫 수정 전에 Git 변경 상태와 테스트 명령을 확인합니다.

권한 오류 때문에 관리자 권한 설치를 무조건 사용하면 안 됩니다. 공식 문서의 대체 설치와 진단 절차를 따르고 설치 유형은 진단 명령으로 점검합니다.

Pro·Max와 API 과금 경계

Pro·Max 계정은 Claude 웹과 Claude Code를 하나의 구독에서 사용할 수 있지만 무제한은 아닙니다. Console API 키로 로그인하면 토큰 사용량이 별도 청구됩니다. 특히 시스템의 ANTHROPIC_API_KEY 환경변수가 구독 인증보다 우선해 예상하지 못한 API 비용이 발생할 수 있습니다.

연결 방식과 환경변수 주의사항은 Pro·Max의 Claude Code 공식 안내에서 확인하세요. 조직·Bedrock·Vertex 환경은 개인 구독과 청구 체계가 다를 수 있습니다.

사용량 한도와 추가 비용

구독 인증이면 Claude 웹과 터미널 작업이 같은 사용량 풀을 공유합니다. 긴 대화, 큰 저장소, 모델과 작업 복잡도가 사용량에 영향을 줍니다. API 키 인증이면 토큰 기준으로 과금되며 비용 확인 화면과 세션 비용을 함께 봐야 합니다.

한도에 도달하면 초기화를 기다리거나 상위 플랜, 사용 크레딧 또는 명시적인 API 종량제를 검토할 수 있습니다. 사용 크레딧은 구독료에 무제한 포함되는 것이 아니라 추가 청구될 수 있습니다. 최신 측정 방식은 Claude Code 모델·사용량 공식 안내를 따릅니다.

안전한 첫 작업과 검증

1. 저장소 구조와 진입점을 수정 없이 요약하게 합니다.
2. 목표와 관련된 파일만 찾게 합니다.
3. 원인과 수정 계획, 제외 범위를 설명하게 합니다.
4. 한 번에 처리할 파일과 완료 증거를 정합니다.
5. 변경 후 diff와 테스트 결과를 검토합니다.
6. 삭제·배포·외부 전송은 별도 승인으로 둡니다.

비밀키와 개인정보를 프롬프트에 붙이지 말고 운영 DB와 개발 DB를 구분해야 합니다. 인증·결제·권한·삭제 코드는 사람의 보안 검토가 필요합니다. 도구 자체의 오류는 Claude 오류 해결 안내에서 점검할 수 있습니다.

IDE와 터미널 구분

공식 안내는 VS Code, Cursor 같은 VS Code 계열과 JetBrains 계열 IDE 사용을 설명합니다. 터미널은 저장소 전체 작업과 명령 흐름에, IDE는 현재 편집 파일과 diff 검토에 편리할 수 있습니다. 어느 한쪽이 항상 우월한 것은 아닙니다.

유사 이름의 비공식 확장을 설치하지 말고 공식 문서에서 게시자와 설치 경로를 확인하세요. 계정·결제·조직 설정 지원이 필요하면 Claude 고객센터 안내를 참고할 수 있습니다.

설치와 요금에서 헷갈리는 부분

Claude Code는 Anthropic의 코딩 도구이며 Pro·Max에서 사용할 수 있지만 사용량 한도가 있습니다. 별도 API 키를 연결하면 종량 과금이 발생할 수 있고, 웹과 Claude Code의 사용량은 공유될 수 있습니다.

Windows 지원 방식과 현재 설치 조건은 공식 설치 문서를 확인하고, 도구가 변경한 파일과 실행한 명령 결과는 적용 전에 직접 검토하세요.