데스크톱 앱과 엔트리포인트

진입점 개요

Claude Code는 다양한 환경과 사용 패턴을 위해 여러 진입점을 제공합니다.

Claude Code 진입점:

  CLI ──────────────── 터미널 기반 기본 인터페이스
  데스크톱 앱 ─────── Mac/Windows 네이티브 앱
  웹 앱 ───────────── claude.ai/code 브라우저 기반
  IDE 확장 ─────────── VS Code, JetBrains
  Entrypoints SDK ──── 외부 도구 임베딩

CLI

터미널 기반의 기본 인터페이스로, 가장 강력하고 유연합니다.

# 대화형 모드
claude

# 원샷 실행
claude --print "코드를 분석해 주세요"

# 파이프 입력
cat error.log | claude --print "이 오류를 설명해 주세요"

# 특정 파일과 함께
claude --add-file src/auth.ts "인증 로직을 리뷰해 주세요"

장점	단점
스크립트 통합 가능	GUI 없음
전체 기능 접근	학습 곡선
CI/CD 자동화 적합	-

데스크톱 앱

Mac과 Windows용 네이티브 애플리케이션입니다.

특성	설명
시스템 트레이 통합	백그라운드 실행, 빠른 접근
네이티브 파일 다이얼로그	드래그 앤 드롭 지원
알림 통합	OS 네이티브 알림
오프라인 지원	일부 기능 오프라인 사용 가능
자동 업데이트	최신 버전 자동 설치

웹 앱 (claude.ai/code)

브라우저에서 접근하는 웹 기반 인터페이스입니다.

장점:
  - 설치 불필요
  - 어디서든 접근 가능
  - 실시간 협업 기능

제한:
  - 로컬 파일 시스템 접근 제한
  - 오프라인 사용 불가
  - 브라우저 보안 정책 적용

IDE 확장

개발 환경에 직접 통합되는 방식입니다.

IDE	확장명	주요 기능
VS Code	Claude Code	인라인 diff, 채팅 패널, 코드 렌즈
JetBrains	Claude Code	프로젝트 트리, 컨텍스트 메뉴 통합

IDE 확장은 현재 편집 중인 파일의 컨텍스트를 자동으로 포함하여 더 정확한 코드 어시스턴스를 제공합니다.

Entrypoints SDK

외부 애플리케이션에 Claude Code를 임베딩하기 위한 SDK입니다.

import { createEntrypoint } from '@anthropic-ai/claude-code/entrypoints';

const claudeCode = createEntrypoint({
  systemPrompt: '당신은 우리 제품의 코딩 어시스턴트입니다.',
  allowedTools: ['Read', 'Write', 'Bash(npm:*)'],
  theme: {
    primaryColor: '#0066CC',
    fontFamily: 'Inter'
  }
});

// React 컴포넌트로 임베딩
function MyApp() {
  return (
    <div>
      <claudeCode.ChatPanel height={600} />
    </div>
  );
}

진입점	주요 사용자	핵심 장점
CLI	개발자, DevOps	자동화, 스크립팅
데스크톱 앱	일반 개발자	편의성, 네이티브 경험
웹 앱	팀 협업	접근성, 공유
IDE 확장	코딩 중심 개발자	워크플로우 통합
Entrypoints SDK	제품 팀	커스텀 임베딩