Claude Code 작동 방식 이해하기 2: 접근 범위, 실행 환경 및 인터페이스

Claude의 접근 범위

해당 설명은 터미널 환경을 기준으로 합니다.

디렉토리에서 claude 명령어를 실행하면 Claude Code는 다음과 같은 요소에 접근할 수 있습니다.

• 프로젝트: 디렉토리 및 하위 디렉토리의 파일, 별도로 허가한 다른 위치의 파일
• 터미널: 해당 디렉토리에서 실행할 수 있는 모든 명령어(빌드 도구, git, 패키지 관리자, 시스템 유틸리티, 스크립트 등 실제 터미널에서 실행할 수 있는 모든 명령어)
• git Status: 현재 브랜치, 커밋되지 않은 변경 사항, 최근 커밋 등
• CLAUDE.md: 프로젝트별 지침, 규칙, Claude가 각 세션에 따라 알아야 할 컨텍스트를 저장하는 마크다운 파일
• 자동 저장 메모리: Claude가 작업하면서 자동으로 저장한 사용자에 대한 내용(프로젝트 패턴, 사용자 선호도 등). MEMORY.md의 처음 200줄 혹은 25kb 중 먼저 도달하는 것이 세션 시작 시 자동 로드됩니다.
• 확장 기능: 외부 서비스를 위한 MCP servers, 워크플로우를 위한 skills, 위임된 작업을 위한 subagents, 브라우저 상호작용을 위한 Claude in Chrome.

현재 파일만 보는 인라인 코드 어시스턴트와 다르게 Claude는 위 내용과 같이 전체 프로젝트를 기준으로 작업을 하기 때문에 전체 코드에 대한 이해, 편집, 실행 등이 가능합니다.

Claude 실행 환경 및 인터페이스

이전 글에서 설명한 에이전트 루프, 도구 등은 Claude Code를 사용하는 모든 곳에서 동일하게 적용됩니다. 실행 환경별 차이점은 코드가 실행되는 위치와 상호작용 방식입니다.

 

실행 환경

Claude Code는 세 가지 환경에서 실행되며, 각각은 코드가 실행되는 위치에 따른 특징이 있습니다.

환경	코드 실행 위치	사용 사례
로컬	사용자 개인 pc	기본값. 파일, 도구, 환경에 대한 전체 접근
클라우드	Anthropic 관리 VM	작업 오프로드, 로컬에 없는 리포지토리에서 작업
원격 제어	사용자 머신, 브라우저에서 제어	웹 UI를 사용하면서 모든 것을 로컬로 유지

​

구분	실행 위치	로컬 환경 접근	병렬 작업	핵심 가치
로컬	내 PC	⭕ 전체	△ (수동)	완전한 제어
클라우드	Anthropic VM	❌ 불가	⭕ 강함	오프로드·확장성
원격 제어	내 PC	⭕ 전체	❌ (1세션)	로컬 환경의 이동성

로컬 (Local)

가장 기본이 되는 실행 방식으로, 터미널에서 claude를 실행해 사용자 PC에서 직접 동작합니다.

 

특징

• 파일시스템, 로컬 도구, 환경변수, MCP 서버에 제약 없이 접근
• .env 파일, 로컬 DB, 사내 전용 MCP, 커스텀 빌드 파이프라인을 그대로 활용
• 별도의 환경 재구성 비용이 없음 (이미 세팅된 개발 환경을 그대로 사용)

사용 예시

• 자격증명·DB 등 민감 정보에 접근해야 하는 작업
• 사내 전용 MCP 서버나 특정 툴체인이 필요한 작업
• 로컬에서 테스트 스위트를 직접 돌려가며 반복 검증하는 작업

💡 보안·거버넌스가 중요한 팀일수록, 환경이 외부로 나가지 않는 로컬 방식이 안전합니다.

 

클라우드 (Claude Code on the web)

claude.ai/code에서 Anthropic이 관리하는 클라우드 인프라 위에서 작업을 실행합니다. 각 작업은 격리된 샌드박스(매번 새로 생성되는 Linux 컨테이너)에서 돌아갑니다.

 

특징

• GitHub 리포지토리를 새 클라우드 환경에 클론해 작업하고, 완료 후 변경 사항은 새 브랜치로 push
• 브라우저를 닫아도 세션이 유지되며, 모바일 앱에서 진행 상황을 모니터링 가능
• 작업마다 독립 샌드박스가 할당되어 병렬 처리에 유리
• 네트워크·파일시스템 제한이 걸려 있고, Git 연동은 보안 프록시를 통해 인증되어 허가된 리포에만 접근
• 실행이 끝나면 클론된 환경은 폐기되며, 로컬에는 아무것도 남지 않음(stateless)

사용 예시

• 로컬에 없는 리포지토리에서 바로 작업할 때
• 노트북을 닫아도 진행되어야 하는 작업 오프로드
• 버그픽스나 잘 정의된 루틴 작업, TDD로 검증 가능한 백엔드 변경

주의점

• 로컬 환경변수나 시크릿에 직접 접근할 수 없음 → 민감 정보가 필요하면 CLI(로컬) 권장
• 현재 Pro·Max·Team 및 일부 Enterprise 대상 리서치 프리뷰 단계

 

원격 제어 (Remote Control)

실행은 로컬에 두고, 제어만 브라우저·모바일로 가져오는 방식입니다. 클라우드와의 핵심 차이는 "코드가 어디서 돌아가느냐"입니다.

특징

• claude remote-control로 시작하거나, 진행 중인 세션에서 /rc로 전환 → 세션 URL과 QR 코드 제공
• 로컬 세션은 outbound HTTPS 요청만 하고, 머신에 inbound 포트를 열지 않음(보안 설계)
• 로컬 파일시스템·MCP 서버·도구·프로젝트 설정이 그대로 유지되고, @ 입력 시 로컬 경로 자동완성도 동작
• 여러 기기 간 대화가 동기화되어 터미널에서 시작 → 폰에서 확인 → 웹에서 후속 지시가 끊김 없이 이어짐
• 한 번에 하나의 세션만 동작하는 single-thread 모델 (병렬은 클라우드가 유리)

사용 예시

• 리팩터링·테스트 작성 등 몇 분씩 걸리는 작업을 돌려놓고 자리를 비울 때
• 출퇴근·이동 중 폰으로 진행 상황을 확인하고 다음 단계를 승인
• 로컬 환경(사내 MCP·DB·커스텀 설정)이 꼭 필요하면서도 이동성도 원할 때

주의점

• Pro·Max에서 사용 가능하며, Team·Enterprise는 admin이 토글을 켜야 활성화

구분	실행 위치	로컬 환경 접근	병렬 작업	핵심 가치
로컬	내 PC	⭕ 전체	△ (수동)	완전한 제어
클라우드	Anthropic VM	❌ 불가	⭕ 강함	오프로드·확장성
원격 제어	내 PC	⭕ 전체	❌ (1세션)	로컬 환경의 이동성

 

 

인터페이스

터미널, 데스크톱 앱, IDE 확장, claude.ai/code, 원격 제어, Slack, CI/CD 파이프라인을 통해 Claude Code에 접근할 수 있습니다. 인터페이스는 Claude와 상호작용하는 방식을 결정하지만, 기본 에이전트 루프는 동일합니다. 전체 방법은 Claude Code를 어디서나 사용을 통해 알 수 있습니다.