터미널에서 Claude 코드 시작하는 방법 (2026 가이드)

빠른 요약: 터미널에서 Claude Code를 시작하는 것은 간단합니다. 공식 사이트의 한 줄 명령으로 설치하고, Anthropic 계정으로 인증한 후, 'claude'를 입력하여 대화형 세션을 실행합니다. CLI 도구는 macOS, Linux, Windows에서 작동하며, 개발자가 자연어 명령을 통해 터미널 환경에서 직접 기능을 구축하고, 버그를 수정하며, 작업을 자동화할 수 있게 합니다.

Claude Code는 개발자가 AI 지원과 상호 작용하는 방식의 변화를 나타냅니다. 브라우저 탭과 텍스트 편집기 간에 코드를 복사하는 대신, 이 터미널 기반 도구는 개발 워크플로우 내부에 존재하며 전체 코드베이스를 이해하고 대화형 명령을 통해 복잡한 작업을 실행합니다.

설정 과정은 대부분의 개발자에게 5분도 채 걸리지 않습니다. 하지만 Claude Code를 효과적으로 시작하는 것은 단순히 설치하는 것 이상입니다.

이 가이드에서는 초기 설치부터 생산적인 세션 시작까지, 실제 프로젝트에서 작동하는 실용적인 예제를 포함하여 모든 것을 다룹니다.

Claude Code의 실제 기능

공식 문서에 따르면 Claude Code는 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하며, 개발 도구와 통합하는 에이전트형 코딩 도구입니다. 터미널 인터페이스는 대부분의 개발자에게 주요 상호 작용 지점 역할을 합니다.

이 도구는 기능 구축, 버그 수정, 워크플로우 자동화, 복잡한 코드 섹션 설명과 같은 일상적인 개발 작업을 처리합니다. 프로젝트 파일, git 기록 및 실행 중인 프로세스의 전체 컨텍스트를 가지고 작동합니다.

브라우저 기반 AI 지원과 달리 Claude Code는 셸 환경에서 직접 명령을 실행합니다. 빌드 오류 수정 요청을 받으면 단순히 해결책을 제안하는 것이 아니라, 실제로 수정을 실행하고 결과를 테스트하며 변경 사항을 커밋할 수 있습니다.

터미널 vs. 기타 플랫폼

Claude Code는 터미널 CLI, 데스크톱 애플리케이션, 웹 인터페이스, VS Code 및 JetBrains용 IDE 확장 프로그램, 라이브 애플리케이션 디버깅을 위한 Chrome 확장 프로그램 등 여러 플랫폼에서 작동합니다. 터미널 버전이 가장 직접적인 제어를 제공합니다.

터미널 세션은 키보드 단축키, 백그라운드 작업 실행, 기존 셸 구성과의 통합을 제공합니다. 명령줄에서 생활하는 개발자에게는 이 인터페이스가 가장 빠릅니다.

설치 요구 사항

Claude Code를 설치하기 전에 시스템이 기본 요구 사항을 충족하는지 확인하십시오. 이 도구는 macOS, Linux 및 Windows(WSL2 포함)에서 실행됩니다.

활성 Anthropic 계정이 필요합니다. 계정이 없는 경우, 설치를 진행하기 전에 공식 Anthropic 웹사이트에서 생성하십시오.

터미널은 인터넷 연결 및 스크립트를 다운로드하고 실행할 수 있는 권한이 있어야 합니다. 일부 기업 네트워크는 스크립트 실행을 제한하므로, 설치에 실패하면 IT 부서에 문의하십시오.

지원 운영 체제

공식 자료에서 찾을 수 없는 이 주장은 삭제하십시오. 설치는 Terminal 또는 iTerm2와 같은 모든 터미널 에뮬레이터를 통해 작동합니다.

Linux 배포판에는 최신 셸(bash 또는 zsh)이 필요합니다. 대부분의 최신 Ubuntu, Debian, Fedora 및 Arch 설치는 수정 없이 작동합니다.

Windows 사용자는 먼저 Windows Subsystem for Linux(WSL2)를 설치해야 합니다. 네이티브 Windows 지원이 있지만 WSL2는 개발 도구와의 호환성을 더 잘 제공합니다.

Get AI Perks로 AI 도구 비용 절감

Claude Code 시작 시 다른 AI 도구도 시도하게 되는 경우가 많습니다. Get AI Perks는 설립자가 AI 및 클라우드 제품 전반에 걸쳐 스타트업 크레딧 및 소프트웨어 할인을 찾도록 돕습니다. 이 플랫폼은 Claude, Anthropic, OpenAI, Gemini, ElevenLabs 등에 대한 200개 이상의 제안과 각 제안에 대한 조건을 통합합니다.

사용 가능한 AI 도구 혜택을 확인하고 싶으신가요?

Get AI Perks를 확인하여 다음을 수행하십시오:

• Claude 및 기타 AI 도구 제안을 찾아보세요
• 귀사에 적합한 혜택을 확인하세요
• 가이드에 따라 사용 가능한 크레딧을 청구하세요

👉 Get AI Perks를 방문하여 사용 가능한 AI 소프트웨어 혜택을 비교하세요.

단계별 설치 프로세스

공식 설치 방법은 운영 체제를 감지하고 해당 버전을 설치하는 단일 명령을 사용합니다.

macOS 및 Linux의 경우

터미널 창을 열고 다음 명령을 실행합니다:

설치 스크립트는 Claude Code 바이너리를 다운로드하여 시스템 경로에 배치하고 셸 통합을 구성합니다. 프로세스는 일반적으로 30초 이내에 완료됩니다.

설치가 성공하면 터미널에 확인 메시지가 표시됩니다. 다음을 입력하여 설치를 테스트하십시오:

이 명령은 현재 버전 번호를 반환해야 합니다. 대신 'command not found' 오류가 표시되면 PATH 구성을 조정해야 합니다.

WSL2가 설치된 Windows의 경우

먼저 WSL2가 설치 및 구성되어 있는지 확인하십시오. WSL2 터미널(Ubuntu 권장)을 열고 Linux와 동일한 설치 명령을 실행하십시오:

Windows 관련 네트워킹 문제가 WSL2에서 간혹 발생합니다. 문제 해결 설명서에 따르면 WSL2와 Windows 프로세스 간의 통신을 허용하기 위해 방화벽 규칙을 조정해야 할 수 있습니다.

설치 문제 해결

가장 일반적인 설치 문제는 PATH 구성입니다. 설치 후 터미널에 'command not found'가 표시되면 Claude 바이너리가 셸 실행 경로에 없습니다.

다음 명령으로 설치 위치를 확인하십시오:

결과가 없으면 설치 디렉토리를 PATH에 수동으로 추가하십시오. bash의 경우, ~/.bashrc에 다음 줄을 추가하십시오:

zsh 사용자는 대신 ~/.zshrc에 동일한 줄을 추가하십시오. 터미널을 다시 시작하거나 source ~/.bashrc를 실행하여 변경 사항을 즉시 적용하십시오.

네트워크 관련 설치 실패는 종종 'TLS connect error' 또는 다운로드 중단으로 표시됩니다. 이는 방화벽 제한 또는 오래된 인증서를 나타냅니다. 시스템 인증서를 업데이트하거나 기업 네트워크에서 작업하는 경우 네트워크 관리자에게 문의하십시오.

인증 및 첫 실행

설치가 성공하면 인증을 통해 로컬 CLI를 Anthropic 계정에 연결합니다. 다음을 실행하여 인증 프로세스를 시작하십시오:

첫 실행은 자동으로 인증을 트리거합니다. 브라우저 창이 열리고 로그인 페이지가 표시됩니다. Anthropic 계정 정보로 로그인하십시오.

브라우저 인증이 완료되면 터미널 세션이 활성화됩니다. 환영 메시지가 연결을 확인하고 기본 사용 지침을 표시합니다.

세션 관리

claude가 터미널에서 실행될 때마다 새 세션이 시작됩니다. 세션은 Ctrl+D를 누르거나 exit를 입력하여 명시적으로 종료할 때까지 유지됩니다.

인증 토큰은 로컬에 저장되므로 후속 실행 시 브라우저 로그인이 필요하지 않습니다. 토큰은 Anthropic 웹사이트의 계정 설정을 통해 수동으로 취소할 때까지 유효합니다.

대화형 모드 시작

대화형 모드는 개발자가 Claude Code를 사용하는 주요 방법입니다. 추가 인수 없이 claude를 입력하여 실행합니다.

터미널이 대화형 프롬프트로 전환되며, 자연어 명령으로 AI를 제어합니다. 이 모드는 대화 컨텍스트를 유지하고 이전 요청을 기억하며 다단계 워크플로우를 실행할 수 있습니다.

필수 대화형 명령

몇 가지 내장 명령을 사용하여 세션 동작을 제어할 수 있습니다. 

Claude Code 프롬프트에서 입력하십시오:

• /model – 다른 Claude 모델(Opus, Sonnet) 전환
• /status – 현재 모델, 세션 ID 및 구성 보기
• /btw – 작업 컨텍스트를 변경하지 않고 추가 질문하기
• ? – 키보드 단축키 및 도움말 정보 표시

키보드 단축키는 생산성을 향상시킵니다. Ctrl+L을 눌러 세션을 종료하지 않고 터미널 화면을 지웁니다. Ctrl+C를 사용하여 실행 중인 생성을 취소합니다. Ctrl+F는 모든 백그라운드 작업을 종료합니다(두 번 눌러 확인).

하단의 상태 줄에는 활성 백그라운드 프로세스, 현재 모델 및 토큰 사용량이 표시됩니다. 이 정보는 복잡한 작업 중 리소스 사용량을 모니터링하는 데 도움이 됩니다.

백그라운드 작업 실행

Claude Code는 새로운 명령에 대한 응답성을 유지하면서 백그라운드에서 장시간 실행되는 작업을 수행할 수 있습니다. 백그라운드 작업은 진행률 표시기를 표시하고 비동기적으로 완료됩니다.

여러 작업이 동시에 실행될 때 작업 목록이 각 작업을 추적합니다. Ctrl+F를 눌러 백그라운드 프로세스를 보고 관리합니다.

일회성 명령 실행

모든 작업이 대화형 세션을 필요로 하는 것은 아닙니다. 빠른 작업을 위해 Claude Code는 명령을 인수로 직접 받아들입니다:

이 명령은 Claude Code를 시작하고, 요청을 처리하고, 출력을 표시한 다음 즉시 종료합니다. 대화형 세션은 시작되지 않습니다.

일회성 명령은 스크립팅 및 자동화에 적합합니다. 특정 하위 작업에 AI 지원이 필요한 git 후크, CI/CD 파이프라인 또는 셸 스크립트에 통합될 수 있습니다.

쿼리 전용 모드

-p 플래그는 파일을 수정하지 않고 질문에 답변하는 쿼리 전용 모드를 실행합니다:

이 모드는 프로젝트 파일을 읽지만 아무것도 편집, 생성 또는 삭제하지 않습니다. 정보만 제공하므로 의도하지 않은 수정 없이 안전하게 탐색할 수 있습니다.

모델 선택 및 구성

Claude Code는 서로 다른 기능과 속도를 가진 여러 AI 모델을 지원합니다. 공식 문서에 따르면 지원되는 모델에는 Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5 및 Sonnet 4.5가 포함됩니다.

대화형 세션 중에 /model 명령을 사용하여 활성 모델을 변경합니다. 대화형 메뉴는 각 모델의 강점을 간략하게 설명하는 사용 가능한 옵션을 나열합니다.

영구적인 모델 선호도를 위해 Claude Code를 실행하기 전에 환경 변수를 설정합니다:

이 구성은 변수가 변경되거나 해제될 때까지 세션 간에 유지됩니다.

빠른 모드 구성

빠른 모드는 포괄적인 분석보다 응답 속도를 우선시합니다. 전체 컨텍스트 분석이 필요하지 않은 빠른 반복 및 간단한 작업에 유용합니다.

설정 구성을 통해 또는 속도에 최적화된 모델 변형을 사용하여 빠른 모드를 활성화합니다. 새 모델 릴리스에 따라 빠른 모드 옵션이 발전하므로 공식 문서를 확인하십시오.

프로젝트 작업

Claude Code는 현재 디렉터리와 하위 디렉터리의 파일을 분석하여 프로젝트 구조를 이해합니다. 시작하기 전에 프로젝트 디렉터리로 이동하십시오:

이 도구는 프로젝트 파일을 자동으로 읽고, 코드베이스 구조를 이해하며, 패키지 관리자, 프레임워크 구성 및 빌드 도구와 같은 일반적인 패턴을 인식합니다.

민감한 파일 제외

일부 파일은 AI 도구에서 분석하거나 수정해서는 안 됩니다. 자격 증명, API 키, 대형 바이너리 파일 또는 생성된 콘텐츠입니다. 특정 경로를 제외하려면 프로젝트 루트에 .claudeignore 파일을 만드십시오:

이는 .gitignore 구문과 유사하게 작동합니다. 제외된 파일은 분석 및 실행 중에 Claude Code에 보이지 않습니다.

터미널 구성 팁

Claude Code는 특정 터미널 구성에서 더 잘 작동합니다. 대부분의 문제는 호환되지 않는 셸 설정 또는 누락된 기능에서 발생합니다.

셸 통합

Soften: 일부 최신 터미널은 OSC 133 시퀀스를 통한 프롬프트 감지와 같은 선택적 셸 통합 기능을 지원하지만, 이는 필수는 아닙니다.

최적의 호환성을 위해 인기 있는 터미널 에뮬레이터의 최신 버전을 사용하십시오: macOS의 경우 iTerm2, Linux의 경우 Alacritty, Kitty 또는 WezTerm. Windows Terminal은 WSL2와 잘 작동합니다.

키보드 단축키 사용자 지정

기본 키보드 단축키는 기존 터미널 또는 셸 바인딩과 충돌할 수 있습니다. ~/.claude/settings.json에 있는 설정 구성 파일을 통해 사용자 지정하십시오.

설정 파일은 JSON 형식을 사용하며 모든 내장 명령을 다른 키 조합으로 다시 매핑할 수 있습니다. 편집 후 Claude Code를 다시 시작하여 변경 사항을 적용하십시오.

일반적인 첫 세션 워크플로우

솔직히 말해서, 첫 Claude Code 세션은 종종 실험을 포함합니다. 다음은 핵심 기능을 보여주는 실용적인 시작점입니다.

코드베이스 탐색

Claude Code에 프로젝트 구조를 설명하도록 요청하는 것부터 시작하십시오:

“이 코드베이스에 대한 개요를 알려주세요. 주요 구성 요소는 무엇이며 어떻게 상호 작용하나요?”

이 요청은 아무것도 수정하지 않습니다. 분석하고 설명할 뿐입니다. 응답은 Claude Code가 프로젝트 구성을 올바르게 이해했는지 확인하는 데 도움이 됩니다.

간단한 변경

파일 편집이 작동하는지 확인하기 위해 위험 부담이 적은 수정을 시도하십시오:

“README.md 상단에 이 프로젝트가 무엇을 하는지에 대한 설명을 주석으로 추가하세요”

Claude Code는 파일을 읽고, 적절한 내용을 생성하며, 편집을 수행합니다. git diff를 사용하여 변경 사항을 검토하여 정확히 무슨 일이 일어났는지 확인하십시오.

기존 문제 수정

프로젝트에 알려진 버그 또는 TODO 항목이 있는 경우 Claude Code에 이를 해결하도록 요청하십시오:

“이슈 #42에 설명된 로그인 유효성 검사 버그 수정”

이 도구는 관련 소스 파일을 읽고, 문제를 식별하고, 수정을 구현하며, 솔루션이 작동하는지 확인하기 위해 테스트를 실행할 수도 있습니다.

권한 및 안전

Claude Code는 잠재적으로 위험한 작업을 실행하기 전에 권한을 요청합니다. 권한 시스템은 명령을 영향 수준별로 분류합니다.

파일 읽기는 권한 프롬프트 없이 수행됩니다. 코드를 읽는 것은 항상 안전합니다. 파일 쓰기, 삭제 및 셸 명령 실행은 처음 발생하는 경우 명시적인 승인이 필요합니다.

권한 선택은 세션 또는 영구적으로 저장할 수 있습니다. 영구 권한은 구성 파일에 저장되고 모든 향후 세션에 적용됩니다.

샌드박스 구성

공식 설정 설명서에 따르면 샌드박싱은 Claude Code가 변경할 수 있는 위치를 제한합니다. 샌드박스 경로 접두사를 구성하여 특정 디렉터리로의 파일 시스템 액세스를 제한합니다.

이 보안 계층은 시스템 파일 또는 프로젝트 범위를 벗어난 디렉터리의 의도하지 않은 수정을 방지합니다. 민감한 코드베이스에서 작업하는 팀은 배포 전에 샌드박싱을 구성해야 합니다.

자주 묻는 질문

설치 후 다음 단계

Claude Code가 성공적으로 실행되면 확장된 기능을 탐색해 보십시오. 공식 문서에는 사용자 지정 하위 에이전트, 플러그인 개발 및 예약된 작업 자동화와 같은 고급 주제가 다뤄져 있습니다.

Skills는 Claude Code를 프로젝트별 명령 및 워크플로우로 확장하는 방법을 제공합니다. .claude/skills/ 디렉터리에 스킬을 생성하면 특정 개발 요구에 맞는 사용자 지정 기능을 추가할 수 있습니다.

Model Context Protocol(MCP) 통합을 통해 Claude Code는 외부 도구 및 서비스와 상호 작용할 수 있습니다. 이를 통해 동일한 대화형 인터페이스를 통해 데이터베이스 쿼리, API 테스트 및 인프라 관리가 가능해집니다.

Remote Control 기능을 통해 장치 간에 세션을 계속할 수 있습니다. 데스크톱 컴퓨터에서 작업을 시작한 다음 노트북이나 모바일 장치에서 동일한 세션을 이어갈 수 있습니다. 설정 지침은 플랫폼 통합 설명서를 확인하십시오.

막혔을 때 도움받기

공식 문제 해결 설명서는 대부분의 일반적인 문제를 다룹니다. 문제가 발생하면 더 깊이 있는 시스템 구성으로 들어가기 전에 먼저 거기에서 확인하십시오.

Reddit과 같은 플랫폼의 커뮤니티 토론은 다른 개발자로부터 실제적인 해결책을 제공합니다. 많은 사용자가 이러한 포럼에서 구성 조정 및 워크플로우 최적화를 공유합니다.

설치 또는 인증 문제의 경우 Anthropic 웹사이트에서 계정 상태를 확인하십시오. 만료된 구독 또는 계정 제한은 올바른 로컬 설정으로도 성공적인 연결을 방해합니다.

터미널별 문제는 종종 셸 구성 또는 호환성과 관련이 있습니다. 기본 터미널 구성(사용자 지정 셸 사용자 지정 없음)으로 테스트하면 문제가 로컬 수정에서 비롯되었는지 여부를 격리하는 데 도움이 됩니다.

결론

설치가 완료되면 터미널에서 Claude Code를 시작하는 데 몇 분밖에 걸리지 않습니다. 자연어 명령과 직접적인 코드베이스 통합의 조합은 간단한 쿼리와 복잡한 다중 파일 리팩토링 모두를 처리하는 개발 워크플로우를 만듭니다.

터미널 인터페이스는 개발자를 브라우저 탭이나 별도의 애플리케이션으로 컨텍스트 전환 없이 선호하는 환경에 유지합니다. 백그라운드 작업 실행은 장시간 실행되는 작업이 다른 작업을 차단하지 않도록 합니다.

모든 개발 도구와 마찬가지로 숙련도는 연습을 통해 옵니다. Claude Code가 프로젝트 구조를 해석하는 방식을 이해하기 위해 읽기 전용 쿼리로 시작하십시오. 자신감이 쌓이면 파일 편집 및 자동화된 워크플로우로 진행하십시오. 권한 시스템은 학습 단계에서 돌이킬 수 없는 실수를 방지합니다.

코딩 워크플로우를 혁신할 준비가 되셨나요? 지금 Claude Code를 설치하고 터미널에서 직접 AI 지원 개발을 경험하십시오.