브릿지와 원격 실행

브릿지 시스템

브릿지(Bridge)는 src/bridge/ 디렉토리에 구현된 IDE와 Claude Code CLI 간의 양방향 통신 채널 입니다. 소스 코드 분석에 의하면 WebSocket 전송 과 JWT 인증 을 사용하며, 폴링 방식도 지원합니다.

IDE 확장 (VS Code / JetBrains)
        │
        │ WebSocket + JWT 인증
        │ (폴링 폴백 지원)
        ▼
Claude Code CLI 프로세스 (src/bridge/)
        │
        │ 세션 메시징, 모델 변경, 도구 승인
        ▼
Claude 모델

브릿지는 다음 기능을 제공합니다.

기능	설명
채팅 메시지 전달	IDE 패널에서 입력한 메시지를 CLI로 전달
파일 편집 동기화	Claude의 파일 수정을 IDE 네이티브 diff로 표시
모델 변경	세션 도중 IDE에서 모델 전환 가능
도구 승인	IDE UI에서 도구 실행 승인/거부 처리
컨텍스트 공유	현재 열린 파일, 선택 영역 등 IDE 컨텍스트 전달

원격 모드

CLAUDE_CODE_REMOTE=1 환경 변수로 원격 실행 모드를 활성화합니다.

export CLAUDE_CODE_REMOTE=1
claude --print "저장소를 분석해 주세요"

원격 모드의 특성:

항목	일반 모드	원격 모드
Git 컨텍스트 수집	자동 수집	생략
대화형 UI	활성화	비활성화
출력 형식	사람이 읽기 좋은 형식	구조화된 JSON
적합한 용도	로컬 개발	CI/CD, 자동화

업스트림 프록시

기업 환경에서는 업스트림 프록시를 통해 API 요청을 중계할 수 있습니다.

# 프록시 설정
export HTTPS_PROXY="https://proxy.company.com:8080"
export CLAUDE_CODE_API_ENDPOINT="https://internal-gateway.company.com/claude"

이를 통해 보안 정책 준수, 비용 모니터링, 요청 감사 로그 등을 중앙에서 관리할 수 있습니다.

크론 스케줄링 (RemoteTrigger)

RemoteTrigger를 사용하면 정기적인 자동 실행을 설정할 수 있습니다.

// 매일 자정 코드 분석 실행
{
  "remoteTriggers": [
    {
      "id": "daily-analysis",
      "schedule": "0 0 * * *",
      "prompt": "저장소의 코드 품질을 분석하고 개선점을 보고해 주세요",
      "outputFile": "./reports/daily-analysis.md"
    },
    {
      "id": "weekly-security",
      "schedule": "0 9 * * 1",
      "prompt": "보안 취약점을 스캔하고 결과를 요약해 주세요",
      "notify": "security-team@company.com"
    }
  ]
}

크론 표현식 형식: 분 시간 일 월 요일

보이스 시스템

Claude Code는 음성 입력을 지원합니다. 마이크를 통해 자연어로 명령을 내릴 수 있습니다.

# 보이스 모드 활성화
claude --voice

# 또는 설정에서 기본값으로 설정
# settings.json
{
  "voiceInput": {
    "enabled": true,
    "language": "ko-KR",
    "autoSubmit": false
  }
}

보이스 입력은 음성을 텍스트로 변환한 뒤 일반 텍스트 입력과 동일하게 처리됩니다. autoSubmit: false로 설정하면 음성 인식 결과를 확인 후 수동으로 제출할 수 있습니다.

데몬 모드와 UDS Inbox

소스 코드에서 확인된 추가 연결성 기능들입니다.

데몬 모드 (Daemon)

claude --bg 플래그로 백그라운드 세션 관리 를 활성화합니다. tmux와 통합되어 별도 터미널 없이 Claude Code 세션을 유지할 수 있습니다.

UDS Inbox

Unix Domain Socket 기반의 크로스 세션 IPC 메커니즘입니다. ~/.claude/sessions/ 경로에서 소켓을 탐색하여 실행 중인 다른 Claude Code 세션과 통신할 수 있습니다.

---

퀴즈를 불러오는 중...