Mac mini에서 Claude Code를 원격으로 실행할 때 브라우저 접근은 어떻게 하시나요?

두 경우 모두 원격 데스크톱은 필요 없습니다.

직접 UI를 확인하려면 Air의 브라우저에서 여세요. ssh -L 3000:localhost:3000 mini를 사용하거나, --host 0.0.0.0으로 개발 서버를 시작하고 미니의 Tailscale 호스트네임으로 접속하세요. OAuth 콜백이나 쿠키가 localhost에 묶여 있다면 터널을 선호합니다. 각 워크트리에 고유 포트를 할당하세요.

Claude의 브라우저를 보려면 --remote-debugging-port=9222로 Chrome을 실행하게 하고, 그 포트도 포워딩한 뒤 Air에서 chrome://inspect를 열어 Configure 아래에 localhost:9222를 추가하세요. Inspect를 클릭하면 화면 공유보다 훨씬 가벼운, 클릭 가능한 라이브 뷰를 볼 수 있습니다. 아니면 Playwright를 헤드리스로 실행하고 Claude가 스크린샷을 저장하게 해서 열어보세요.

저도 Mac mini에서 에이전트를 돌립니다. 저희에게 효과적이었던 방법은 브라우저를 직접 보는 대신, Chrome DevTools Protocol(CDP)을 통해 에이전트가 브라우저를 조종하게 하는 것이었습니다.

• 미니에서 별도의 프로필로 Chrome을 실행하세요: --user-data-dir=<경로> --remote-debugging-port=<포트>. 일상용이 아닌 전용 프로필을 사용하세요. 해당 포트에 접근할 수 있는 모든 것은 그 안의 모든 탭과 로그인 세션에 대한 완전한 제어권을 가집니다. 제가 알기로는 최신 Chrome 버전은 기본 프로필에서 디버깅 포트를 거부합니다.

• 에이전트가 여기에 연결(Playwright connectOverCDP 또는 작은 스크립트 사용)하여 직접 스크린샷을 찍게 하세요. 그러면 "Claude가 무엇을 보고 있는지"에 대한 대부분의 상황이 해결됩니다. 스크린샷을 요청하거나 에이전트가 저장하게 하면 되니까요.

• 한 가지 측정한 점: CDP 스크린샷은 미니의 화면이 잠겨 있어도 실제 페이지를 보여줍니다. 일반 화면 캡처나 클릭은 그때 작동하지 않죠. 그래서 미니를 잠금 해제 상태로 두거나 화면 공유 세션을 켜둘 필요가 없습니다.

직접 확인하고 싶을 때는 SSH를 통해 포트를 포워딩(ssh -L <포트>:localhost:<포트> mini)하고 MacBook에서 chrome://inspect를 열어 localhost:<포트>를 타겟으로 추가해보세요. 그러면 클릭 가능한 라이브 뷰를 포함해 각 원격 탭에 대한 DevTools를 사용할 수 있을 겁니다. 저는 노트북에서 그 부분까지는 직접 써보지 않아서 참고용으로만 보세요. 포트는 localhost에 바인딩하고 tailnet에 여는 대신 SSH 터널을 통하세요.

사용 사례가 뭔지는 모르겠지만, 그냥 Claude가 만들고 있는 결과물을 아티팩트로 생성하게 해보세요.

T3Code

CDP 방식을 선택한다면, 제가 겪었던 문제 하나를 공유합니다. 제 스크립트가 구동하는 Chrome이 일반 브라우징에도 사용되면서 탭이 다른 탭 뒤로 숨겨졌고, Chrome이 이를 멈춰버렸습니다. 탭이 멈추면 모든 eval이 걸립니다. 타이머와 fetch는 실행되지 않지만, 기본적인 동기식 eval은 응답할 수 있어서 "살아있는지" 확인하는 기본 체크는 통과해버리죠. 제 작업은 처음에 이 멈춤 현상을 로그아웃된 것으로 인식했습니다.

지금은 50ms setTimeout에서 해결되는 promise를 eval하는 체크를 사용합니다. 응답이 없으면 디버그 포트의 /json/activate/<탭 ID>를 호출해 탭을 앞으로 가져오고, 그래도 응답이 없으면 탭을 닫고 /json/new로 새 탭을 엽니다. 저는 Windows를 써서 Mac mini에서도 똑같이 작동할지는 모르겠지만, 해두면 좋은 저렴한 체크입니다.