Claude Code CLI 시리즈: 기술 가이드 — 파트 3: 원격, 제한 사항 및 모범 사례

콘텐츠 버전: 2026년 10월
출처: Anthropic의 공식 문서(code.claude.com/docs 및 support.claude.com)에서만 제공됩니다. 전체 목록은 공식 출처에 있습니다.
주의: Claude Code는 자주 업데이트됩니다. 이 자료를 참고하기 전에 /release-notes와 CLI 공식 참조 문서에서 변경 사항을 확인하십시오. claude --help에는 모든 플래그가 나열되어 있지 않습니다.

📑 시리즈 목차

1. 🧠 Claude Code CLI란 무엇인가 (파트 1)
2. 📦 설치 및 인증 (파트 1)
3. 🚪 입력 명령어 (파트 1)
4. ⌨️ 단축키 및 접두사 (파트 1)
5. ⚡ 필수 슬래시 명령어 (파트 1)
6. 🔐 권한 모드 (파트 1)
7. 📄 메모리: CLAUDE.md 및 자동 메모리 (파트 1)
8. ⚖️ 설정: settings.json (파트 1)
9. 🪝 Hooks (파트 2)
10. 👥 Subagents (파트 2)
11. 🧩 Skills, 명령어 및 플러그인 (파트 2)
12. 🔌 터미널의 MCP (파트 2)
13. ⏪ 체크포인트 및 컨텍스트 관리 (파트 2)
14. 🤖 비대화형 모드 (-p) 및 CI (파트 2)
15. 🔀 병렬 세션 (파트 2)
16. ⏰ 예약 자동화 (파트 2)
17. 📱 원격 작업 및 기기 간 연동
18. ✅ CLI만 가능한 기능
19. ❌ CLI가 할 수 없는 것
20. 🤫 잘 알려지지 않은 기능
21. 🏆 권장 워크플로우
22. ⚠️ 주의사항 및 제한 사항
23. 📚 공식 출처

17. 📱 원격 작업 및 기기 간 연동

Remote Control: 다른 장치의 로컬 세션 제어

claude --remote-control   # 또는 --rc: Remote Control이 활성화된 대화형 세션
claude remote-control     # 서버 모드

• 세션 내부에서: /remote-control 또는 /rc.
• 세션은 사용자의 기기에서 계속 실행되며, 사용자는 브라우저나 모바일 앱을 통해 확인하고 응답할 수 있습니다.
• Pro, Max, Team 또는 Enterprise가 필요하며 claude.ai에 로그인해야 합니다. API key, Bedrock, Agent Platform 또는 Foundry와는 작동하지 않습니다. Team 및 Enterprise에서는 Owner가 활성화해야 합니다.
• 모든 세션에서 켜려면: /config → Enable Remote Control for all sessions.

클라우드 세션 (claude.ai/code)

claude --cloud "auth.spec.ts의 불안정한 테스트를 수정해줘"  # 클라우드에 세션 생성
claude --teleport                                       # 클라우드에서 세션을 가져옴

• --remote는 --cloud의 오래된 별칭(deprecated)입니다.
• 세션 내부에서, /teleport (또는 /tp) 역시 클라우드 세션을 불러옵니다.
• 텔레포트는 깨끗한 git 상태, 동일한 저장소, 게시된 브랜치 및 claude.ai의 동일 계정을 요구합니다.
• GitHub에 원격 연결이 없는 경우, --cloud는 git 번들(최대 100MB, 추적되지 않은 파일 제외)을 전송합니다.
• --teleport은 --resume과 다릅니다. 후자는 로컬 기록만 읽습니다.
• /autofix-pr은 현재 PR을 따라가며 오류를 수정하는 클라우드 세션을 생성합니다.

기타 장치

• 모바일: iOS 및 Android용 Claude 앱; 클라우드 세션과 Remote Control이 Code 탭에 표시됩니다. /mobile은 앱 다운로드를 위한 QR 코드를 보여줍니다.
• 데스크톱: claude --desktop은 현재 폴더에서 데스크톱 앱을 열어줍니다 (macOS 및 Windows x64, v2.1.285+). 세션을 가져오려면 --continue 또는 --resume <id>와 결합합니다.
• Slack: Pro, Max, Team 또는 Enterprise를 사용하고 웹에서 Claude Code가 활성화되었으며 GitHub에 연결된 경우 작동합니다. DM이 아닌 채널에서 작동합니다. Team 및 Enterprise의 경우, 이 버전은 Claude Tag로 대체되고 있습니다.

18. ✅ CLI만 가능한 기능

데스크톱 앱, IDE, 웹 및 모바일과 비교하여:

• 스크립팅 및 -p 모드: 데스크톱은 인터랙티브 전용이다. 파이프라인(Pipelines), --output-format, 그리고 지속적 통합(CI)은 CLI에 의존한다.
• Agent SDK: 플랫폼 페이지에서 Agent SDK를 스크립팅과 함께 CLI 전용 기능으로 분류한다. 공식 패키지는 Python과 TypeScript로 되어 있다.
• Agent teams: 데스크톱이 아닌 CLI에서 사용 가능하다.
• 세션별 --allowedTools / --disallowedTools: 데스크톱에는 이에 상응하는 것이 없다.
• /permissions와 같은 대화형 명령어(Dialogue commands): 데스크톱에서는 사용 불가능하다고 응답한다.
• Vim 모드 (/config → 에디터 모드, 또는 "editorMode": "vim") 및 /terminal-setup.
• 터미널과 클라우드 간 작업 이동: claude --cloud와 claude --teleport.
• 타사 제공업체(Third-party providers) (Bedrock, Agent Platform, Foundry): CLI와 CLI를 실행하는 IDE에서 지원된다. 데스크톱은 기본적으로 Anthropic의 API를 사용한다.

Subagents, hooks, skills, CLAUDE.md, plugins, MCP, checkpoints 및 sandbox는 CLI에만 국한된 것이 아니다: 모든 인터페이스와 제공업체에서 작동한다.

19. ❌ CLI가 하지 못하는 것

• Diff 시각적 검토, 앱 미리보기 및 컴퓨터 사용: 데스크톱 앱의 기능이다.
• 편집기 내 인라인 Diff: VS Code 및 JetBrains 확장 프로그램의 기능이다.
• 사용자 기기 없이 실행: CLI 세션은 사용자 컴퓨터에 의존한다. 모든 것을 끄고 계속하려면 클라우드 세션(--cloud) 또는 루틴(/schedule)을 사용해야 한다.
• 네이티브 Windows 환경에서의 Sandbox: macOS, Linux 및 WSL 2에서만 가능하다.
• 모든 것에 대한 Sandbox: sandbox는 셸 명령어를 포함한다. 파일 도구, MCP 서버 및 hooks는 이 외부에서 실행된다.
• Bash 효과 되돌리기(Undo): checkpoints는 rm, mv, 배포(deploys) 또는 API 호출을 커버하지 않는다.
• /btw의 도구: 병렬 질문은 도구를 사용하지 않는다.
• Bedrock, Agent Platform 또는 Foundry에서의 Fast 모드: 지원되지 않는다.

claude.ai에서 로그인이 필요한 기능(콘솔 API 키나 타사 제공업체와는 작동하지 않음): 클라우드 세션, 모바일의 Claude Code, Slack 통합, 데스크톱 앱, 루틴, /ultrareview, 원격 제어 (Remote Control), 컴퓨터 사용 (computer use).

20. 🤫 잘 알려지지 않은 기능

유용한 추가 정보:

• 프롬프트 제안: Tab 또는 →가 허용됩니다. promptSuggestionEnabled: false로 비활성화할 수 있습니다.
• 알림: 기본적으로 Ghostty, Kitty 및 iTerm2에서만 작동합니다. 다른 터미널에서는 "preferredNotifChannel": "terminal_bell"을 사용하세요.
• 이미지: Ctrl+V를 사용하거나 프롬프트로 드래그하여 붙여넣으세요.

21. 🏆 권장 워크플로우

공식 모범 사례 페이지를 기반으로 합니다:

1. 탐색, 계획, 구현, 커밋. 플랜 모드(plan mode)에 진입합니다 (Shift+Tab 또는 claude --permission-mode plan). Claude가 코드를 읽고 계획을 제안하도록 하세요. 구현하기 전에 편집기에서 계획을 수정하려면 Ctrl+G를 사용하세요.
2. 작은 변경 사항에서는 계획 건너뛰기. diff(변경 내용)를 한 문장으로 설명할 수 있다면, 계획이 필요 없습니다.
3. Claude가 검증하는 방법을 제공하기. 테스트, 빌드, 린터 또는 디자인과 비교한 스크린샷을 사용하세요. 검증 과정 없이는 작업이 완료된 것처럼 보일 때 Claude는 멈춥니다.
4. 검증에 종료 시점을 결정하게 하기. 세션의 조건으로 /goal을 사용하거나, 결정론적 게이트(deterministic gate)를 위해 Stop 후크를 사용하거나, 검토자 서브 에이전트(subagent revisor)를 사용하세요.
5. 구체적으로 설명하기. 파일을 명시하고, 시나리오, 따라야 할 기존 패턴, 그리고 "수정된" 형태가 어떠한지 말해주세요.
6. 간결한 CLAUDE.md 유지하기. /init으로 시작하세요. 각 줄에 대해 "이것을 제거하면 Claude가 오류를 범할까?"라고 질문하세요.
7. 조기에 수정하기. 중간에 멈추려면 Esc를 누르고; 되돌아가려면 Esc Esc 또는 /rewind를 사용합니다. 성공하지 못한 수정이 두 번 연속되면, /clear를 실행하고 더 나은 프롬프트를 작성하세요.
8. 관련 없는 작업 사이에는 /clear를 사용하고, 장시간 조사에는 서브 에이전트를 사용하세요.

대규모 기능 구현 전에 인터뷰하세요. Claude에게 인터뷰를 요청하고, SPEC.md를 생성한 다음 새 세션에서 구현하세요.
10. 작가와 검토자(Escritor e revisor). 한 세션은 기능을 구현하고, 다른 세션(깨끗한 컨텍스트 사용)에서 diff를 검토합니다.
11. 대규모 마이그레이션: /batch 또는 --allowedTools 및 --permission-mode dontAsk를 사용한 claude -p 루프.

피해야 할 실패 패턴: "싱크대" 세션(모든 것이 뒤섞임), 연속적인 수정, 부풀려진 CLAUDE.md, 검증 없이 신뢰하기, 범위가 없는 조사.

22. ⚠️ 주의사항 및 제한 사항

보안 (Segurança)

• default 모드에서는 Claude가 초기 폴더와 하위 폴더에만 작성하며, 외부에서 읽기 전에 확인을 요청합니다.
• curl과 wget은 자동으로 승인되지 않습니다.
• 문서에는 어떤 시스템도 모든 공격으로부터 면역이 아니라고 명시되어 있습니다. 프롬프트 인젝션(Prompt injection)은 실제 위험이며, 특히 웹 콘텐츠 및 MCP 서버에서 발생할 수 있습니다.
• Anthropic은 MCP 서버를 감사하지 않습니다. 저장소에 버전 관리된 설정은 팀의 책임입니다.
• Windows에서는 WebDAV와 \\* 경로를 피하세요. 이들은 권한 시스템을 우회할 수 있습니다.

bypassPermissions 및 자동 모드 (auto mode)

• bypassPermissions는 **프롬프트 인젝션(prompt injection)**이나 원치 않는 동작으로부터 보호하지 않습니다. 격리된 컨테이너나 VM에서만 사용하세요.
• Linux와 macOS에서는 root로 실행하거나 sudo를 사용할 때 이 플래그가 거부됩니다. 관리자는 permissions.disableBypassPermissionsMode: "disable"을 사용하여 이를 차단할 수 있습니다.
• 자동 모드(auto mode)의 분류기는 되돌릴 수 없거나, 파괴적이거나, 환경 외부의 동작을 차단합니다. 기본적으로 작업 디렉토리와 저장소에 구성된 원격지(remotes)만 신뢰합니다.
• 연속으로 3회 또는 총 20회의 차단이 발생하면 자동 모드는 일시 중지되고 다시 권한을 요청합니다.
• "$defaults" 없이 soft_deny와 같은 목록을 재정의하면 강제 푸시(force-push) 차단 및 프로덕션 배포(deploy in production) 차단을 포함한 내부 보호 기능이 제거됩니다.
• 엄격한 제한을 위해서는 분류기 대신 permissions.deny를 사용하세요.

개발 컨테이너 (Dev containers)

• 격리에는 권장되지만, 컨테이너가 악성 프로젝트가 내부의 내용물, 심지어 ~/.claude에 있는 자격 증명까지 읽는 것을 막지는 못합니다.
• 호스트의 비밀 정보(예: ~/.ssh 또는 클라우드 자격 증명)를 마운트하지 말고, allowlist로 네트워크 출력을 제한하세요.

IDE

• JetBrains에서 acceptEdits를 사용하면 Claude가 IDE가 자체적으로 실행하는 설정 파일을 변경할 수 있으며, 이는 Bash의 확인 절차를 우회합니다.

데이터

• 개인 사용자 플랜(Free, Pro, Max): 옵션이 켜져 있으면 데이터를 학습에 사용할 수 있습니다(5년 보존). 이 옵션을 끄면 30일 동안 보존됩니다.
• 기업용 플랜(Team, Enterprise, API): 기본적으로 학습을 사용하지 않습니다. 기본 보존 기간은 30일입니다. 적격 계정의 경우 데이터 보존이 '제로'입니다.
• 로컬 트랜스크립션은 ~/.claude/projects/에 일반 텍스트 파일로 30일 동안 보관됩니다 (cleanupPeriodDays).
• /feedback는 코드를 포함한 전체 대화를 전송하며, 이는 5년 동안 보관됩니다.
• 텔레메트리: DISABLE_TELEMETRY 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC로 비활성화하세요.

비용

• 기업 평균: 개발자당 일일 약 US$ 13, 월별 US$ 150~250입니다. 사용자 중 90%는 일일 US$ 30 미만으로 유지됩니다.
• 비용을 높이는 요인: 긴 컨텍스트, 캐시 손실, 예약된 작업 및 서브에이전트. 에이전트 팀은 팀원이 계획 모드(plan mode)로 실행될 때 일반 세션보다 약 7배 많은 토큰을 소비합니다.
• 비용 절감 방법: 작업 간 /clear 사용, 집중적으로 /compact 사용, CLAUDE.md 파일의 줄 수를 200줄 미만으로 유지, 대부분의 작업에 Sonnet 사용 및 어려운 작업에 Opus 사용, 간단한 서브에이전트에는 model: haiku 사용, 가능한 경우 MCP보다 CLI 도구 사용.
• 사용량은 /usage로 확인하세요.

23. 📚 공식 출처

모든 내용은 code.claude.com/docs에서 확인했으며, 2026년 10월에 조회되었습니다.

개요 및 설치

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

• 개요
• Claude Code 작동 방식
• 플랫폼
• 기능 사용 가능 여부
• 설정
• 인증(Authentication)
• 서드파티 통합(Third-party integrations)

터미널에서 사용하기 (Uso no terminal)

• CLI 참고 자료
• 대화형 모드(Interactive mode)
• 명령어(Commands)
• 키 바인딩(Keybindings)
• 터미널 설정(Terminal config)
• 상태 표시줄(Status line)
• 출력 스타일(Output styles)
• 모델 설정(Model config)
• 빠른 모드(Fast mode)

권한, 메모리 및 구성