소개

sotatek-proxy는 워크스테이션에서 투명하게 실행되는 경량 데몬으로, AI CLI 도구(Claude Code, claude-cli 등)와 Sotatek Bifrost 게이트웨이 사이를 연결하며 모든 요청에 프로세스 및 git 속성 메타데이터를 추가합니다.

sotatek-proxy가 필요한 이유

프록시 없이 Bifrost로 전송되는 AI CLI 요청에는 로컬 컨텍스트가 없습니다 — 어떤 개발자가 요청을 보냈는지, 어떤 저장소에서 작업이 시작되었는지 알 수 없습니다.

sotatek-proxy는 CLI 워크플로를 변경하지 않고 이 문제를 자동으로 해결합니다:

루프백 인터페이스(127.0.0.1:3817)에서 요청을 가로챕니다
호출 프로세스의 작업 디렉토리를 확인합니다
가장 가까운 .git/ 디렉토리를 찾아 git remote -v를 읽습니다
Bifrost로 전달하기 전에 X-Git-Remote 헤더(base64 인코딩)를 삽입합니다
응답을 실시간으로 CLI에 스트리밍합니다

주요 기능

기능	설명
루프백 전용	`127.0.0.1:3817`에만 바인딩 — LAN에 노출되지 않음
SSE / 스트리밍	청크 단위 플러시, 버퍼링 없음 — 즉각적인 토큰 스트리밍
Git 속성	모든 요청에 `X-Git-Remote` 헤더 삽입
TTL 캐시	PID → git-remote 캐시, TOCTOU 안전한 CWD 재검증
크로스 플랫폼	macOS (arm64 / amd64), Linux (amd64 / arm64), Windows (amd64)
데몬 관리	launchd · systemd · Windows SCM — 로그인 / 부팅 시 자동 시작
보안	인증 헤더 미기록; 클라이언트가 속성 헤더를 위조할 수 없음

시작하기

macOS에 설치 launchd 사용자 에이전트, 관리자 권한 불필요

Linux에 설치 systemd 사용자 유닛, 부팅 시 자동 시작 옵션

Windows에 설치 LocalSystem 하의 Windows 서비스, 관리자 권한 필요

설치 후 CLI 설정 가이드를 따라 Claude Code가 프록시를 가리키도록 설정하세요.

sotatek-proxy status를 실행하여 데몬이 실행 중인지 확인한 후 다음을 설정하세요:

export ANTHROPIC_BASE_URL=http://127.0.0.1:3817/anthropic
export ANTHROPIC_AUTH_TOKEN=<가상-키>