Claude Code CLI 가이드: 명령어, 설정 및 모범 사례

간단 요약: Claude Code CLI는 전체 코드베이스를 이해하고, 파일을 편집하며, 명령을 실행하고, 자연어를 통해 개발 도구와 통합되는 AI 기반 터미널 코딩 지원 도구입니다. 명령줄 인터페이스, IDE 확장 프로그램, 데스크톱 앱 및 웹 인터페이스로 사용할 수 있으며, 자동화된 워크플로우, 코드 검토 및 git 작업을 터미널에서 직접 지원합니다.

명령줄 인터페이스가 이렇게 지능적이었던 적은 없습니다. Claude Code는 터미널을 난해한 명령어를 입력하는 곳에서 자연어와 코드 실행이 만나는 대화형 작업 공간으로 변화시킵니다. 이는 사이드바에 갇힌 또 다른 챗봇이 아닙니다. 개발자가 실제로 작업하는 곳에 존재하는 에이전트형 코딩 도구입니다.

이 도구는 전체 코드베이스를 읽고, 프로젝트 컨텍스트를 이해하며, 여러 파일을 동시에 편집하고, 사용자를 대신하여 명령을 실행합니다. Anthropic에서 개발한 Claude Code는 터미널에서 로컬로 실행되면서 Claude의 API에 연결하여 요청을 처리합니다. 그 결과는? 반복적인 작업을 처리하고, 복잡한 코드를 설명하며, 대화형 명령을 통해 git 워크플로우를 관리하는 코딩 지원 도구입니다.

Claude Code CLI의 차별점

기존 AI 코딩 지원 도구는 자동 완성 제안을 제공하거나 채팅 창에서 질문에 답변합니다. Claude Code는 완전히 다른 수준에서 작동합니다. 이는 에이전트 시스템으로, 다단계 작업을 계획하고, 자율적으로 실행하며, 결과를 기반으로 조정할 수 있다는 의미입니다.

CLI는 프로젝트 구조를 읽고, 파일 관계를 이해하며, 세션 간에 대화 컨텍스트를 유지합니다. 버그 수정을 요청받으면 Claude Code는 단순히 코드를 제안하는 것이 아닙니다. 문제를 식별하고, 관련 파일을 수정하며, 테스트를 실행하여 수정을 확인하고, 변경 사항을 git에 커밋할 수도 있습니다.

공식 문서에 따르면 Claude Code는 터미널, IDE(VS Code 및 JetBrains), 데스크톱 애플리케이션, 브라우저 및 CI/CD 파이프라인과 통합됩니다. 이러한 유연성은 개발자가 로컬에서 작업을 시작하고 모바일에서 계속하거나, 선호하는 환경에서 코딩하면서 PR 검토를 자동화할 수 있음을 의미합니다.

설치 및 설정

Claude Code를 실행하는 데는 몇 분밖에 걸리지 않습니다. 설치 과정은 플랫폼마다 약간씩 다르지만, 핵심 단계는 Windows, macOS 및 Linux에서 일관되게 유지됩니다.

시스템 요구 사항

설치 전에 시스템이 기본 요구 사항을 충족하는지 확인하십시오. Claude Code는 최신 버전의 Windows, macOS 및 대부분의 Linux 배포판에서 실행됩니다. Alpine Linux 및 musl 기반 시스템에는 고급 설정 문서에 따라 추가 종속성이 필요합니다.

이 도구는 기본적으로 자동 업데이트되어 구성 가능한 릴리스 채널을 통해 최신 버전을 가져옵니다. 버전 관리가 필요한 팀은 자동 업데이트를 비활성화하고 설치를 수동으로 관리할 수 있습니다.

빠른 설치 프로세스

설치는 플랫폼에 대한 네이티브 바이너리를 다운로드하는 것으로 시작됩니다. 공식 문서에는 종속성을 자동으로 처리하는 플랫폼별 설치 프로그램이 제공됩니다.

설치 후 인증을 통해 로컬 CLI를 Anthropic의 API에 연결합니다. 인증 명령을 실행하고 프롬프트를 따라 Anthropic 계정을 연결하십시오. 이 프로세스는 시스템 키체인에 자격 증명을 안전하게 저장합니다.

확인을 통해 모든 것이 올바르게 작동하는지 확인합니다. 설치 확인 명령은 바이너리를 검증하고, 인증 상태를 확인하며, 모든 종속성이 있는지 확인합니다.

필수 CLI 명령어

Claude Code의 명령 구조는 단순함과 강력함의 균형을 이룹니다. 기본 명령으로 즉시 시작할 수 있으며, 고급 플래그를 통해 복잡한 워크플로우를 사용할 수 있습니다.

세션 시작

가장 간단한 명령으로 대화형 세션을 시작할 수 있습니다. 터미널에 claude를 입력하기만 하면 됩니다. 이렇게 하면 Claude가 코드베이스를 읽고, 파일을 편집하며, 명령을 실행할 수 있는 대화가 시작됩니다.

일회성 작업을 위해 프롬프트를 직접 전달하십시오: Claude "이 프로젝트 설명"은 해당 초기 메시지와 함께 세션을 시작합니다. -p 플래그는 쿼리를 실행하고 즉시 종료하므로 스크립팅에 적합합니다.

대화 관리

-c 플래그는 가장 최근 대화를 계속합니다. 컨텍스트는 세션 간에 유지됩니다. Claude는 이전 대화 내용, 편집된 파일, 실행된 명령을 기억합니다.

여러 기능을 동시에 작업하려면 --worktree 플래그를 사용하여 격리된 git worktree를 생성하십시오. 각 worktree는 git 기록을 공유하면서 독립적인 파일 상태를 유지하여 Claude 인스턴스가 서로 간섭하는 것을 방지합니다.

고급 플래그

여러 플래그를 사용하여 Claude Code의 동작을 수정할 수 있습니다. --ide 플래그는 IDE가 있는 경우 자동으로 IDE에 연결됩니다. --from-pr 플래그는 특정 풀 리퀘스트에 연결된 세션을 시작하여 자동 코드 검토 워크플로우를 활성화합니다.

시스템 프롬프트 플래그는 Claude의 지침을 변경합니다. 이러한 고급 옵션을 통해 팀은 특정 워크플로우에 대한 동작을 사용자 정의하거나 조직 표준을 적용할 수 있습니다.

Claude Code 실무

명령어를 이해하는 것과 효과적으로 사용하는 것은 다릅니다. Claude Code가 코드를 어떻게 생각하는지 이해해야 합니다.

실행 모드

Claude Code는 작업에 따라 다른 모드로 작동합니다. 계획 모드는 실행 전에 단계를 설명합니다. 질문 모드는 변경하기 전에 확인을 기다립니다. 자동 편집 모드는 승인된 변경 사항을 자동으로 적용합니다.

숙련된 사용자의 커뮤니티 토론에서는 실행 전에 접근 방식을 개선하기 위해 상당한 시간을 할애한다고 합니다. 이러한 워크플로우는 실수를 방지하고 Claude가 작업을 올바르게 이해하도록 합니다.

컨텍스트 및 코드베이스 이해

Claude Code는 각 세션 시작 시 전체 프로젝트 구조를 읽습니다. 프로그래밍 언어, 프레임워크, 빌드 도구 및 종속성을 식별합니다. 이 컨텍스트는 모든 제안 및 편집에 영향을 미칩니다.

이 도구는 형식화된 언어에 코드 인텔리전스 플러그인을 사용하여 텍스트 기반 검색이 아닌 정확한 기호 탐색을 제공합니다. 이를 통해 익숙하지 않은 코드를 탐색할 때 불필요한 파일 읽기를 줄입니다.

파일 작업 및 Git 통합

Claude Code는 파일을 직접 편집하며, 변경 사항을 적용하기 전에 diff를 보여줍니다. 개발자는 제안된 수정을 검토하고 승인하거나 거부합니다. 이 도구는 단일 작업에서 여러 파일을 처리하여 관련 변경 사항 간의 일관성을 유지합니다.

Git 통합은 기본적으로 지원됩니다. Claude는 브랜치를 생성하고, 설명적인 메시지로 변경 사항을 커밋하며, 원격 저장소에 푸시하고, GitHub CLI 통합을 통해 풀 리퀘스트를 생성할 수도 있습니다. --from-pr 플래그는 Claude가 PR 변경 사항을 분석하고 개선 사항을 제안하는 자동 코드 검토를 활성화합니다.

구성 및 사용자 정의

Claude Code는 관리(시스템 전체), 사용자(개인 설정), 프로젝트(저장소 수준) 및 로컬(기계별)의 여러 범위에서 구성을 지원합니다. 설정은 계층적으로 적용되며, 더 구체적인 범위가 더 넓은 범위를 재정의합니다.

설정 파일

구성 설정은 JSON 파일에 저장됩니다. 사용자 설정은 ~/.claude/에, 프로젝트 설정은 저장소 내 .claude/에 저장됩니다. 팀은 프로젝트 설정을 버전 관리에 커밋하여 모든 공동 작업자에 대해 일관된 동작을 보장합니다.

사용 가능한 설정은 권한, 샌드박싱, 모델 선택, 키보드 단축키 및 UI 사용자 정의를 제어합니다. 설정 문서는 모든 옵션과 해당 범위를 자세히 설명합니다.

권한 및 보안

권한 규칙은 Claude Code가 액세스할 수 있는 것을 정의합니다. 개발자는 허용된 디렉터리, 제외된 파일 및 명령 제한 사항을 지정합니다. 이를 통해 도구가 민감한 데이터에 액세스하거나 위험한 작업을 실행하는 것을 방지할 수 있습니다.

샌드박싱 설정은 추가적인 보안 계층을 제공합니다. 경로 접두사는 파일 작업을 특정 디렉터리로 제한하므로 여러 프로젝트에서 작업하거나 공유 환경에서 작업할 때 유용합니다.

비용 관리 및 토큰 사용량

Claude Code는 모든 요청마다 API 토큰을 소비합니다. 더 큰 코드베이스와 복잡한 작업은 더 많은 토큰을 사용합니다. /cost 명령은 현재 세션 사용량과 예상 비용을 표시합니다.

비용 관리 문서에 따르면 팀은 컨텍스트를 사전 적극적으로 관리하고, 적절한 모델을 선택하고, MCP 서버 오버헤드를 줄이며, 코드 인텔리전스 플러그인을 설치하여 토큰 사용량을 줄일 수 있습니다. 도구 검색은 컨텍스트 창의 10%를 초과하는 도구 설명을 자동으로 지연시켜 모든 정의를 컨텍스트에 유지하는 대신 온디맨드로 도구를 로드합니다.

평균적으로 Claude Code는 Sonnet 4.6을 사용하는 경우 개발자당 월 약 $100-$200의 비용이 들지만, 사용 패턴에 따라 비용이 크게 달라집니다.

속도 제한 권장 사항은 팀 규모에 따라 다릅니다. 소규모 팀은 사용자당 더 많은 토큰(TPM) 및 분당 요청(RPM)을 할당할 수 있지만, 대규모 조직은 제한을 더 보수적으로 분배합니다.

대규모 Claude Code CLI 실행 전에 AI 크레딧 확보

Claude Code CLI를 사용하면 특히 LLM 주변의 스크립트, 자동화 또는 개발자 워크플로우를 구축할 때 지속적인 API 사용이 필요합니다. 사용량이 증가함에 따라 비용이 빠르게 증가할 수 있으며, 많은 개발자 또는 팀이 크레딧을 사용할 수 있는지 확인하지 않고 전체 가격을 지불하기 시작합니다.

Get AI Perks는 200개 이상의 AI, 클라우드 및 개발자 도구에 대한 크레딧과 할인을 한 곳에 집계하며, 프로그램 전체의 총 가용 가치는 700만 달러를 초과합니다. 현재 개발자는 창업자를 위한 500달러의 Anthropic 크레딧 및 선정된 참여자를 위한 최대 15,000달러의 Claude 크레딧과 같은 혜택을 이용할 수 있습니다. 이 플랫폼은 조건, 승인 가능성 및 신청 방법을 보여주므로 개발자는 어떤 프로그램이 가치 있는지 빠르게 확인할 수 있습니다.

Claude 사용량을 확장하거나 워크플로우에 더 깊이 통합하기 전에 Get AI Perks를 확인하고 자격이 되는 모든 크레딧을 먼저 청구하십시오.

개발 도구와의 통합

Claude Code는 터미널을 넘어 확장됩니다. VS Code 확장 프로그램은 인라인 diff, @-mention을 통한 파일 참조 및 키보드 단축키로 Claude를 편집기로 가져옵니다. JetBrains IDE도 유사한 통합을 제공합니다.

Chrome 확장 프로그램은 라이브 웹 애플리케이션 디버깅을 활성화합니다. 데스크톱 앱은 GUI를 선호하는 팀을 위한 독립형 인터페이스를 제공합니다. 원격 제어 기능을 통해 개발자는 여러 장치에서 세션을 계속할 수 있습니다. 데스크톱에서 작업을 시작하고 모바일에서 계속할 수 있습니다.

CI/CD 통합은 워크플로우를 자동화합니다. GitHub Actions 및 GitLab CI/CD는 PR 검토, 이슈 분류 및 자동 테스트를 위해 Claude Code를 트리거할 수 있습니다. Slack 통합은 버그 보고서를 풀 리퀘스트로 직접 라우팅합니다.

커뮤니티 모범 사례

실제 사용 패턴은 효과적인 전략을 보여줍니다. 커뮤니티 저장소의 사용자 경험은 몇 가지 모범 사례를 강조합니다.

실행 전에 계획을 개선하는 데 시간을 투자하십시오. 계획 단계가 성공을 결정합니다. 명확한 지시 없이 편집에 서두르면 토큰 낭비와 좋지 않은 결과로 이어집니다.

긴 작업을 위해 체크포인트를 사용하십시오. Claude Code는 세션이 충돌하거나 일시 중지가 필요한 경우 복구를 허용하는 대화 상태를 저장하는 체크포인트를 지원합니다.

상태 표시줄을 사용자 정의하십시오. 고급 사용자는 모델, 디렉터리, git 브랜치, 커밋되지 않은 파일 및 토큰 사용량을 표시하는 상태 표시줄을 구성합니다. 이 정보는 실시간으로 컨텍스트 소비를 모니터링하는 데 도움이 됩니다.

훅과 스킬을 활용하십시오. 훅은 워크플로우의 특정 지점(세션 시작, 편집 전, 명령 후)에서 실행되는 스크립트입니다. 스킬은 메인 프롬프트와 별도로 저장된 재사용 가능한 지침입니다. 둘 다 반복을 줄이고 일관성을 개선합니다.

자주 묻는 질문

Claude Code와 함께 나아가기

Claude Code는 개발자가 AI 코딩 지원 도구와 상호 작용하는 방식을 변화시킵니다. CLI는 컨텍스트가 가장 풍부하고 워크플로우가 가장 빠른 터미널에 에이전트 기능을 직접 제공합니다.

시작하는 데 몇 분밖에 걸리지 않습니다. 설치, 인증 및 첫 세션은 모두 한 번에 완료됩니다. 하지만 숙달하려면 실험이 필요합니다. 다양한 모드를 시도하고, 권한을 구성하고, 훅을 설정하고, 설정을 사용자 정의하여 워크플로우에 맞추십시오.

이 도구는 빠르게 발전합니다. 하위 에이전트, MCP 서버 통합 및 향상된 체크포인팅과 같은 기능은 정기적으로 기능을 확장합니다. 공식 변경 로그를 따르면 새로운 기능에 대한 최신 정보를 얻을 수 있습니다.

채택을 고려하는 팀의 경우 작게 시작하십시오. 단일 프로젝트에서 Claude Code를 실행하고, 패턴을 설정한 다음, 확장하십시오. 프로젝트 설정에 구성을 문서화하여 팀 전체가 최적화된 동작의 이점을 누릴 수 있도록 하십시오.

개발 워크플로우를 혁신할 준비가 되셨나요? 공식 문서에서 Claude Code를 다운로드하고, 계정을 인증하고, 첫 세션을 시작하십시오. 코딩의 미래는 대화형이며 터미널에서 실행됩니다.