Tactic Remote

보안

API 키 관리, 경로 제한, 보안 모범 사례.

Tactic Remote는 iPhone에서 Mac의 터미널을 제어할 수 있게 합니다. 이 페이지에서는 보호 대상, 방식, 설정해야 할 항목을 다룹니다.

API 키 인증

서버는 API 키 인증을 지원합니다. 설정하면 모든 연결에서 올바른 키를 제공해야 합니다.

export CLAUDE_REMOTE_API_KEY="your-secret-key"

Mac 앱에서 랜덤 키를 자동 생성할 수도 있습니다.

필수 여부:

  • 공개/터널 접근 시 항상 필수 (강력히 권장).
  • 로컬 전용 접근 시 선택 사항이지만 설정을 권장.

규칙:

  • 스크린샷이나 채팅에 API 키를 공유하지 마세요.
  • 키가 노출된 것으로 의심되면 즉시 교체하세요.
  • Mac 앱은 키를 macOS Keychain에 저장합니다.

경로 제한

Claude Code가 접근할 수 있는 디렉토리를 제한할 수 있습니다:

export CLAUDE_REMOTE_ALLOWED_PATH="/Users/you/projects"

기본값은 홈 디렉토리 (~)입니다. 프로젝트 폴더로 좁히면 Claude가 관련 없는 파일에 접근하는 것을 방지합니다.

기본 차단 대상: 허용 경로 설정과 관계없이, .ssh, .aws, .gnupg 등 민감한 디렉토리는 항상 차단됩니다.

세션 보안

  • 세션 이름 검증: 영숫자, 밑줄, 하이픈만 허용 (최대 50자). 세션 이름을 통한 명령 주입을 방지합니다.
  • 명령어 검증: tmux로 전달되는 명령이 검증됩니다. 승인된 플래그의 claude 명령만 실행 가능합니다.
  • 경로 탐색 공격 (예: ../../etc/passwd) 차단.

속도 제한

서버는 연결당 분당 30건의 요청 속도 제한을 적용합니다. 남용 및 우발적인 요청 폭주를 방지합니다.

네트워크 보안

로컬 네트워크

신뢰할 수 있는 자택/사무실 네트워크에서 로컬 모드는 합리적으로 안전합니다. 주요 위험은 같은 네트워크의 다른 기기입니다. IP와 API 키를 자격 증명으로 취급하세요.

Cloudflare Tunnel

터널 연결은 기본적으로 암호화됩니다 (WSS/TLS). Cloudflare가 DDoS 보호도 제공합니다. 터널을 사용하면 라우터에서 인바운드 포트를 열 필요가 없습니다.

공개 접근 시 항상:

  1. API 키를 설정하세요.
  2. 가능하면 안정적인 URL을 가진 Named Tunnel을 사용하세요.
  3. 더 이상 필요 없는 오래된 터널 설정을 제거하세요.

체크리스트

항목상태
서버 API 키 설정터널 시 필수, 로컬 시 권장
허용 경로 설정기본 ~, 프로젝트 폴더로 축소
Mac 방화벽에서 앱 허용로컬 연결 시 필수
민감 디렉토리 차단자동 (.ssh, .aws 등)
속도 제한 활성자동 (30 req/min)
노출 후 키 교체필요 시 수동 조치

이 페이지에서