블로그

원격 AI 코딩의 보안 모범 사례

AI 에이전트가 코드베이스에 쓰기 권한을 갖고 네트워크를 통해 제어할 때, 보안 결정이 중요합니다. 올바른 선택을 하는 방법을 소개합니다.

게시일 2026년 2월 28일태그: 보안 / 가이드 / 모범사례 / seo

블로그

이 카테고리의 제품 및 엔지니어링 업데이트를 확인하세요.

AI 코딩 에이전트를 원격으로 실행하면 책상에 앉아 있을 때와는 다른 보안 고려사항이 생깁니다. 에이전트는 코드베이스에 접근하고, 명령을 실행하고, 파일을 수정할 수 있습니다. 휴대폰과 Mac 사이의 네트워크 경로는 잠재적으로 신뢰할 수 없는 영역을 거칩니다.

이것이 원격 AI 코딩을 피할 이유는 아닙니다. 위협 모델을 이해하고 정보에 기반한 결정을 내릴 이유입니다. 대부분의 위험은 간단한 실천으로 관리할 수 있습니다.

위협 모델

구체적 대응에 앞서, 보호 대상을 이해합니다:

자산:

소스 코드(지적 재산, 설정 파일의 시크릿)
개발 환경(명령 실행 능력)
Mac의 git 자격 증명과 SSH 키
코드가 사용하는 서비스의 API 키

위협 행위자:

노출된 서비스를 스캔하는 기회주의적 공격자
공유 WiFi의 네트워크 도청자
휴대폰을 찾거나 훔친 사람
사용 중인 도구의 공급망 공격

공격 면:

휴대폰과 Mac 간의 네트워크 연결
인증 메커니즘
AI 에이전트의 파일시스템 권한
Mac에서 실행되는 서버 프로세스

레이어 1: 네트워크 보안

암호화된 연결 사용

LAN 모드(ws://): 트래픽이 암호화되지 않습니다. 집의 WiFi에서는 트래픽이 로컬 네트워크를 벗어나지 않으므로 허용 가능합니다. 공유 또는 공개 네트워크에서는 허용되지 않습니다.

Cloudflare Tunnel(wss://): TLS로 트래픽이 암호화됩니다. 인터넷을 거치는 모든 연결에 사용하세요. 터널은 휴대폰과 Cloudflare 엣지 사이, Cloudflare와 Mac 사이를 암호화합니다.

기본 원칙: 자신이 통제하는 네트워크(집, 사무실)에서는 LAN 모드로 충분합니다. 그 외에는 Cloudflare Tunnel을 사용하세요.

원시 포트를 노출하지 마세요

라우터에서 포트 8765(또는 다른 포트)를 Mac으로 포워딩하지 마세요. 이는 중간 보호 없이 서버를 인터넷에 직접 노출합니다.

Cloudflare Tunnel은 이를 완전히 회피합니다 — Mac이 Cloudflare로 아웃바운드 연결을 시작합니다. 인바운드 포트가 필요 없습니다.

Mac 앱에는 방화벽 감지 기능이 포함되어 방화벽 구성에 대한 경고를 표시합니다. Mac의 방화벽을 스텔스 모드로 활성화된 상태로 유지하세요.

레이어 2: 인증

API 키 설정

Tactic Remote는 WebSocket 연결에 API 키 인증을 사용합니다:

LAN 연결: API 키는 선택 사항입니다. 로컬 네트워크가 신뢰 경계 역할을 합니다.
Cloudflare Tunnel 연결: API 키가 필수입니다. 서버가 인증되지 않은 연결을 거부합니다.

API 키는 WebSocket 핸드셰이크 중 Sec-WebSocket-Protocol 헤더를 통해 전송됩니다. wss://에서는 이것이 암호화됩니다.

API 키 모범 사례

생성된 키를 사용하세요. Mac 앱이 32자 랜덤 키를 생성합니다. 수동으로 선택할 어떤 비밀번호보다 강력합니다.
안전하게 전달하세요. QR 코드 기능으로 직접 대면하여 iPhone에 키를 전달하세요. 이메일, Slack, SMS로 보내지 마세요.
주기적으로 교체하세요. 키가 유출되었을 수 있다면 Mac 앱에서 새 키를 생성하고 iPhone을 업데이트하세요.
재사용하지 마세요. Tactic Remote API 키를 다른 서비스에 사용하지 마세요. 단일 목적의 자격 증명입니다.

속도 제한

서버에는 반복된 인증 실패 시도를 억제하는 속도 제한 미들웨어가 포함됩니다. 이는 API 키에 대한 무차별 대입 공격을 방어합니다. 32자 랜덤 키로는 무차별 대입이 계산적으로 불가능하지만, 속도 제한은 심층 방어를 추가합니다.

레이어 3: 접근 제어

경로 제한

Tactic Remote는 CLAUDE_REMOTE_ALLOWED_PATH 환경 변수를 지원합니다. 이는 Claude Code가 접근할 수 있는 디렉토리를 제한합니다. 코드 디렉토리로 설정하세요:

export CLAUDE_REMOTE_ALLOWED_PATH=/Users/you/code

이 설정 없이는 Claude Code가 전체 홈 디렉토리에 접근합니다(기본 동작). 경로 제한은 문제 발생 시 피해 범위를 줄입니다.

Claude Code 권한

Claude Code 자체에 권한 시스템이 있습니다. Tactic Remote에서 두 가지 모드를 사용할 수 있습니다:

표준 모드: claude — Claude Code가 위험한 작업(파일 삭제, 낯선 명령 실행) 전에 승인을 요청합니다
권한 건너뛰기 모드: claude --dangerously-skip-permissions — Claude Code가 승인 없이 실행합니다. 빠르지만 안전장치가 없습니다.

원격 사용 권장: 항상 표준 모드를 사용하세요. 승인 프롬프트는 원격에서 특히 유용합니다. iPhone에서 제안된 작업을 검토하고 Y/N을 탭할 수 있기 때문입니다. 권한을 건너뛰면 Claude가 여러분의 인지 없이 무엇이든 할 수 있습니다 — 직접 보고 있지 않을 때 위험합니다.