Claude Code를 폰·웹에서 보기 — 어전(eojeon) 0.2~0.5.1, 사장 지적을 1시간에 새 버전 7개로 고친 기록(원격 접속·터미널 미러링·답변 탭·상소함)
픽셀 조선 궁궐로 Claude Code를 감싼 오픈소스 어전(eojeon)이 공개 첫날 밤 0.2.0부터 0.5.1까지 61분 동안 7번 업데이트됐다. 사장이 직접 써 보고 남긴 지적(다른 기기 접속, 쓰던 터미널이 안 보임, 입력창 2개, 터미널 잘림, 답만 보고 싶음, 답 못 한 질문 쌓기)과 고친 기능, AI가 스스로 낸 버그를 고친 0.5.1, 폰 접속·답변 탭의 개인정보 범위를 정리했다.
어전(eojeon)은 Claude Code를 픽셀 조선 궁궐 화면으로 감싼 MIT 오픈소스로, 공개 첫날(2026-10-24) 하이아이오 사장이 직접 써 보고 남긴 지적을 AI가 고쳐 23:12(0.2.0)부터 00:13(0.5.1)까지 61분 동안 새 버전 7개를 냈다. 바뀐 것은 접속 키가 필요한 다른 기기 접속(`--host`), 내 터미널을 웹에 그대로 띄우는 `eojeon claude`, 입력창 하나, 화면 크기에 맞춘 터미널, 궁궐을 크게 두고 명령과 최종 답만 보여 주는 답변 탭, 아직 답하지 않은 권한 요청·질문을 모으는 상소함이다. 마지막 0.5.1은 사장 지적이 아니라 AI가 만든 데모 서버가 연결 파일을 지우던 버그를 고친 것이다.
결론부터. 어전(eojeon)은 공개 첫날 밤, 사장이 직접 써 보며 남긴 지적을 받아 61분 동안 새 버전 7개(0.2.0~0.5.1)를 냈다. 다른 기기에서 접속할 수 있게 했고, 평소 쓰는 터미널을 웹에 그대로 띄우게 했고, 궁궐 화면을 크게 키우면서 명령과 답만 모아 보는 탭과 아직 답하지 않은 질문을 모으는 상소함을 넣었다. 마지막 0.5.1은 AI가 스스로 낸 버그를 고친 것이다. 어전이 무엇인지는 소개 편, 만든 과정은 만든 과정 편에 있다.
버전 7개, 61분
시각은 GitHub 저장소의 git 태그 기준이다(2026-10-24~25, 한국 시간).
| 시각 | 버전 | 무엇이 바뀌었나 |
|---|---|---|
| 23:12 | 0.2.0 | 다른 기기 접속(--host + 접속 키), watch(어전 밖 Claude Code도 보기), 컴퓨터에서는 입력창 하나, SNS 게시 담당 관직 '전령' |
| 23:37 | 0.3.0 | eojeon claude: 내 터미널에서 켠 claude를 어전 웹에 그대로 띄움(웹 입력·윤허 도장도 그 터미널로) |
| 23:48 | 0.3.1 | 어전이 바쁘거나 아직 안 켜졌어도 3초마다 다시 시도해 자동으로 붙음 |
| 23:54 | 0.3.2 | 웹 터미널이 잘리지 않게 글자를 줄여 한 화면에, 어전을 다시 켜도 hook이 새 어전을 찾아감 |
| 23:58 | 0.4.0 | 궁궐이 왼쪽 전체, 오른쪽 '답변' 탭(내 교지와 Claude 최종 답만), 원래 터미널은 버튼으로 |
| 00:01 | 0.5.0 | 상소함: 아직 답하지 않은 권한 요청과 Claude가 묻고 멈춘 질문을 모음 |
| 00:13 | 0.5.1 | 데모 서버가 연결 파일을 지우던 버그 수정(AI가 낸 버그) |
사장 지적과 고친 것
사장의 말은 원문 그대로 옮기지 않고 뜻만 적었다.
| 사장 지적(뜻) | 고친 버전 | 바뀐 것 |
|---|---|---|
Tailscale로 다른 기기에서 macmini:4747에 접속하니 열리지 않음 |
0.2.0 | npx eojeon-cli --host 0.0.0.0으로 켜면 터미널에 찍힌 주소(접속 키 포함)로 폰·태블릿에서 열림. 그 뒤 30일은 키 없이 |
| 지금 쓰는 Claude Code 세션이 어전에 실시간으로 안 보임 | 0.2.0 · 0.3.0 · 0.3.1 | watch로 보기 전용 표시 → eojeon claude로 내 터미널 화면을 그대로 → 어전을 나중에 켜도 자동 연결 |
| CLI 입력창과 교지 입력창이 2개라 헷갈릴 것 같음 | 0.2.0 (0.4.0에서 정리) | 입력창은 하나. 0.4.0부터는 오른쪽 패널 아래 입력칸 하나(Enter 보내기, Shift+Enter 줄바꿈) |
| 웹에 비친 CLI가 잘려서 다 안 보임 | 0.3.2 | 웹 터미널이 화면 전체가 들어갈 때까지 글자를 줄임 |
| CLI를 똑같이 띄우지 말고 답만, 어전은 최대한 크게 | 0.4.0 | 궁궐이 왼쪽 전체, 오른쪽 '답변'·'사관 일지' 탭, 원래 CLI는 '터미널' 버튼을 누를 때만 |
| 아직 답하지 못한 상소를 쌓아 두고 보여 주면 어떨까(사장 아이디어) | 0.5.0 | 상소함 탭과 궁궐 왼쪽 위 상소 더미(개수 표시) |
0.5.1: AI가 낸 버그
0.5.1은 사장 지적이 아니다. 데모 명령(eojeon demo)이 켜질 때 연결 파일 ~/.eojeon/runtime.json을 덮어쓰고 꺼질 때 지워서, 이미 켜 둔 어전이 eojeon claude와 watch hook을 놓치는 문제가 있었다. 0.5.1부터 데모는 이 파일을 건드리지 않고, 어전은 파일이 없어지면 다시 쓴다. eojeon claude도 이벤트마다 지금 떠 있는 어전을 찾아가서, 어전을 나중에 켜거나 다시 켜도 답과 상소가 보인다. 변경 기록(CHANGELOG)에도 그대로 적었다.
상소함은 무엇을 모으나
- 아직 윤허·불허하지 않은 권한 요청
- Claude가 질문 도구(AskUserQuestion)로 묻고 멈춘 것, 또는 최종 답이 물음표로 끝난 것
윤허·불허를 하거나 다음 교지를 보내면 저절로 빠지고, '치우기'로 지울 수도 있다. ~/.eojeon/pending.json에 저장돼 어전을 다시 켜도 남는다. 윤허·불허 버튼은 지금 터미널에 떠 있는 요청에만 붙는다. 자리를 비운 사이 Claude가 무엇을 기다리고 있는지 돌아와서 한눈에 보는 용도다.
새 명령 정리
| 하고 싶은 것 | 명령 |
|---|---|
| 평소처럼 실행(이 컴퓨터에서만) | npx eojeon-cli |
| 내 터미널의 claude를 어전에 그대로 띄우기 | 어전을 켜 둔 채 다른 터미널에서 npx eojeon-cli claude --continue (claude 옵션은 그대로 넘어감) |
| 폰·태블릿에서도 보기 | npx eojeon-cli --host 0.0.0.0 → 터미널에 찍힌 주소(키 포함)를 폰에서 열기 |
| 접속 키 바꾸기 | npx eojeon-cli --host 0.0.0.0 --new-key |
| 어전 밖 Claude Code도 보기(보기 전용) | npx eojeon-cli watch / 끄기 npx eojeon-cli watch --off |
| Claude 없이 장면만 보기 | npx eojeon-cli demo |
폰에서 열고 답변 탭을 쓰면, 안전한가?
기본값은 바뀌지 않았다. 옵션 없이 켜면 서버는 127.0.0.1에만 열리고 외부로 나가는 요청이 없다.
--host를 붙일 때만 다른 기기에서 열린다. 처음 접속은 접속 키가 든 주소로만 되고, 키가 없으면 403이다.- 키를 가진 기기는 이 컴퓨터의 claude 터미널에 입력까지 할 수 있다. 공용 와이파이에서는
0.0.0.0대신 Tailscale IP 하나만 지정하는 것을 README가 권한다. - 0.4.0부터 '답변' 탭을 위해 내가 쓴 교지(2,000자까지)와 Claude의 최종 답변 글(6,000자까지)이 화면으로 간다. 이 컴퓨터, 또는 접속 키를 가진 기기에만 간다. 파일 내용·도구 출력은 가지 않고, API 키·토큰·비밀번호 모양 문자열은
***로 가린다. watch는 실행할 때만~/.claude/settings.json에 hook을 추가하고, 그 전에 원래 파일을settings.json.eojeon-backup으로 남긴다.watch --off는 어전이 넣은 hook만 지운다.
자주 묻는 질문
평소 쓰는 터미널의 Claude Code를 어전 화면에 띄울 수 있나요?
있다. 어전을 켜 둔 상태에서 다른 터미널에서 claude 대신 npx eojeon-cli claude로 실행하면, 그 터미널 화면이 어전 웹에 그대로 보이고 웹에서 친 글자와 윤허 도장도 그 claude로 들어간다. 어전이 꺼져 있으면 평범한 claude로 실행된다.
어전을 휴대폰에서 볼 수 있나요?
볼 수 있다. 컴퓨터에서 npx eojeon-cli --host 0.0.0.0으로 켜고, 같은 와이파이나 Tailscale에 연결된 폰에서 터미널에 찍힌 주소(접속 키 포함)를 연다. 키 없이는 들어오지 못하고, 옵션을 붙이지 않으면 이 컴퓨터에서만 열린다.
상소함에는 무엇이 쌓이나요?
아직 답하지 않은 권한 요청과, Claude가 질문하고 멈춘 것(질문 도구, 물음표로 끝난 최종 답)이다. 답하거나 다음 교지를 보내면 빠지고, 어전을 다시 켜도 남는다.
답변 탭을 쓰면 내 대화가 밖으로 나가나요?
아니다. 교지와 최종 답변 글은 이 컴퓨터, 또는 --host로 켜고 접속 키를 가진 기기의 화면에만 간다. 비밀 모양 문자열은 가린다.
참고한 링크
- 어전(eojeon) GitHub 저장소
- 어전 변경 기록(CHANGELOG)
- eojeon-cli — npm
- Claude Code 공식 문서 — Hooks
- Claude Code 공식 문서 — Settings
- Tailscale 설치 안내
- 이전 편: 어전 소개
- 이전 편: 어전을 만든 과정
연재 'AI한테 앱 맡김' 전체 보기 · 이 글은 AI(Claude)가 정리했어요.