사용 안내

Claude Code 2.1.288~2.1.289 에서 확인한 화면 기준입니다

1. 준비

회사 서버 하나에 개발자들의 Mac 을 붙입니다.

회사 서버: Tomcat 11(Java 21)과 PostgreSQL 을 사내 서버에 둡니다. 웹 콘솔은 회사의 HTTPS 프록시 뒤에, Agent 연결(/ws/agent·/agent/)은 사내망(VPN) 안에서만 엽니다. 웹 로그인은 아이디·비밀번호에 OTP 가 꼭 필요합니다.
각 Mac: tmux 와 Claude Code. Claude Code 를 tmux 창 안에서 띄워야 웹에서 입력·승인을 할 수 있습니다.
Agent 설치: 관리자가 웹의 관리 › 호스트 › 「호스트 추가」로 만든 한 줄 명령을 개발자 Mac 의 터미널(사내망 안)에서 실행합니다. 등록 코드는 한 번만, 15분 안에 쓸 수 있습니다.

# 「호스트 추가」가 만들어 주는 명령의 모양 (주소·코드는 화면에 나온 값)
curl -fsSL <서버 주소>/agent/install.sh | bash -s -- --code XXXX-XXXX

설치 스크립트가 실행 파일을 검증하고, 등록하고, launchd 로 상주시키고, Claude Code hook 을 걸고, 마지막에 점검까지 합니다. 그 뒤로 Agent 업데이트는 웹의 「지금 업데이트」로 합니다.

세션 목록에는 모든 Mac 의 세션이 상태 순서로 보입니다.

상태	뜻
승인 대기	Claude 가 권한이나 답을 기다립니다. 가장 위에 보입니다.
입력 대기	Claude 가 일을 마치고 다음 지시를 기다립니다.
작업 중	Claude 가 일하는 중입니다. 진행 줄(경과 시간·토큰)이 보입니다.
보기 전용	tmux 밖에서 띄운 세션이라 볼 수만 있습니다. 「tmux 로 이어 열기」로 제어할 수 있게 됩니다.
완료	끝난 세션입니다. 이어 열거나 다른 Mac 으로 옮길 수 있습니다.

세션을 누르면 대화가 열립니다. 대화·도구 호출·결과가 터미널과 같은 순서로 실시간으로 쌓이고, 위로 올려 읽던 중이면 새 메시지가 와도 읽던 자리를 지킵니다(「새 메시지」 단추로 맨 아래로).

권한 요청: 「허용」·「이 명령 항상 허용」·「거부」. 「항상 허용」은 Claude 가 제안한 그 규칙(대개 그 명령 하나)만 저장합니다. 명령마다 묻는 게 번거로우면 권한 모드를 「자동」으로 바꾸세요.
Claude 의 질문: 질문 카드에서 선택지를 고르거나(하나·여럿) 직접 써서 「답 보내기」. 질문이 여러 개면 모두 답해야 보낼 수 있습니다.
터미널에도 같은 창이 함께 떠 있고, 먼저 답한 쪽이 적용됩니다.
알림 칸(휴대폰은 「알림」 탭)에 기다리는 요청이 모입니다.

입력창에 쓰고 전송(⌘/Ctrl+Enter). 긴 글도 그대로 보내고, 보냈다는 확인이 온 뒤에만 입력창을 비웁니다.
파일은 입력창에 끌어다 놓거나 붙여 넣으면 세션 폴더의 uploads/ 로 올라가고 @경로가 입력창에 들어갑니다. 첨부 단추로 폴더를 골라 올릴 수도 있습니다.
「중단」은 터미널의 Esc 와 같습니다. /compact·/clear 같은 명령은 빠른 단추로 보냅니다.

「새 세션」에서 Mac(호스트)·계정·모델·effort·프로젝트 폴더·권한 모드를 고릅니다. 폴더는 그 Mac 에서 허용한 폴더 안에서만 열 수 있습니다.
「새 대화」 또는 「이어하기」(끝난 대화 고르기). 이어하기는 그 대화가 쓰던 권한 모드·effort 로 엽니다.
대화가 저장된 계정과 다른 계정으로 이어 열면, 대화 파일을 그 계정으로 복사해 이어 씁니다(원래 계정의 파일은 그대로).

팝업은 「취소」·X·Esc 로만 닫힙니다. 바깥을 잘못 눌러도 쓰던 내용이 사라지지 않습니다.

세션 머리말의 「모델 · effort」 단추로 바꿉니다. 기본은 이 세션만이고, 「새 세션 기본값으로도 저장」을 켜면 그 계정의 기본값도 바뀝니다.
대화 중에 모델을 바꾸면 다음 메시지에서 대화 전체를 새 모델로 다시 읽어 느리고 토큰을 더 씁니다.
권한 모드: 기본(매번 묻기) · 편집 자동 수락 · 플랜 · 자동(위험해 보이는 것만 묻기) · 모두 허용(믿을 수 있는 폴더에서만).

세션 메뉴 › 「다른 호스트로 옮기기」. 원래 Mac 에서 끝난 세션만 옮깁니다.

대화만 옮기거나, 작업 폴더도 함께 옮깁니다. 작업 폴더는 node_modules·target 같은 다시 만들 수 있는 폴더를 빼고 묶어 서버를 거쳐 받는 Mac 의 빈 폴더에 풉니다.
진행 막대로 단계(내보내기 → 묶기 → 올리기 → 받기 → 풀기 → 이어 열기)를 봅니다. 웹을 닫아도 계속되고, 다시 들어오면 진행이 보입니다.
코드는 git 으로 맞추는 것이 기본입니다. 옮기기 창이 두 Mac 의 git 상태를 비교해 보여 줍니다.

작업: 세션을 가로질러 지금 도는 백그라운드 에이전트와 워크플로우, 최근 24시간에 끝난 것을 봅니다.
사용량: 기간·계정·호스트를 골라 추정 비용·요청·출력 토큰·캐시 적중을 이전 기간과 비교합니다. 계정 한도(5시간·주간·모델별 주간)와 지금 속도로 본 예측, 날마다 모델별 막대, 프로젝트·세션별 순위, 요일×시간 열지도가 있습니다.
비용은 API 단가로 환산한 추정치입니다. 구독 요금이 아닙니다.

호스트: 연결 상태·버전·지표, 「호스트 추가」·등록 해제, Agent 「지금 업데이트」.
계정 · 사용량: Mac 마다 Claude·Ollama 계정의 로그인 상태, 웹에서 로그인·로그아웃.
모델: 쓸 모델 켜기·끄기, 종류별 기본 모델.
백업: 각 Mac 의 대화 기록을 Agent 가 10분마다 회사 서버에 올립니다. 서버 보관함 크기·디스크 여유, 호스트별 백업 상태와 「지금 백업」, 백업된 대화 찾기와 「되살리기」(관리자). 되살린 대화는 새 세션 › 이어하기로 엽니다.
설정: 파일 미리보기 한도·보존 기간 같은 서버 설정(관리자), 테마·편집기 같은 이 브라우저 설정.

휴대폰: 사파리에서 「홈 화면에 추가」로 앱처럼 띄우고, 아래 탭(세션·알림·작업·사용량·관리)으로 오갑니다. 승인·질문은 알림 탭에서 「세션에서 답하기」로 바로 갑니다.

데스크톱: 세션 목록·대화·알림이 세 칸으로 나란히 보입니다. 양쪽 칸은 접어서 요약 줄·아이콘 줄로 둘 수 있고(이 브라우저가 기억), 파일 탐색기는 두 파일을 나란히 엽니다. 대화 영역에 파일을 끌어다 놓으면 바로 올라갑니다.