Claude Code와 Codex를 휴대폰에서 승인하기
pushward agent는 Claude Code와 Codex에 연결됩니다. 컴퓨터에서 자리를 비우면 에이전트의 권한 요청이나 질문이 잠금 화면에 카드로 도착합니다. 탭 한 번이면 세션이 이어집니다.pushward agent는 Claude Code와 Codex에 연결됩니다. 컴퓨터에서 자리를 비우면 에이전트의 권한 요청이나 질문이 알림 창에 실시간 업데이트로 도착합니다. 탭 한 번이면 세션이 이어집니다.
휴대폰 옆 터미널에서 실행 중인 Claude Code: Claude가 bun run test 실행을 요청하고, 카드가 휴대폰에 도착해 Allow를 받고, 테스트가 통과하고, 한 카드에서 세 질문에 답한 뒤 완료 알림이 도착합니다.
brew install mac-lucky/tap/pushward
pushward agent install claude
pushward agent install codex
pushward auth loginscoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth loginWindows에서는 훅에 Claude Code 2.1.295 이상이 필요합니다.
작동 방식
-
훅 설치
pushward agent install은 Claude Code나 Codex에 훅을 추가하고 기존 훅은 그대로 둡니다. Codex에서는 /hooks로 한 번 신뢰해 주세요.
-
자리 비우기
macOS와 Windows에서는 컴퓨터를 사용하는 동안, Linux와 SSH로 접속한 Mac에서는 에이전트의 터미널에 입력하는 동안 요청이 터미널에 남고 아무것도 전송되지 않습니다. 90초 동안 입력이 없으면 훅은 자리를 비운 것으로 봅니다.
-
휴대폰에서 답하기
탭한 답은 터미널에서 답한 것처럼 세션으로 돌아갑니다. 25분 안에 답이 없으면 요청은 터미널로 돌아갑니다.
휴대폰에 도착하는 것


자리에 있으면 아무것도 전송되지 않습니다
훅은 무엇이든 보내기 전에 최근 90초 안에 컴퓨터를 사용했는지 확인합니다. 요청이 휴대폰에서 기다리는 동안 돌아오면 카드는 끝나고 요청은 터미널로 돌아갑니다.
macOS
키보드와 마우스가 얼마나 오래 쉬었는지 읽습니다. SSH로 접속하면 Linux처럼 에이전트의 터미널을 대신 읽습니다.
Windows
마찬가지로 키보드와 마우스의 유휴 시간을 읽습니다. SSH로는 읽을 것이 없어서 모든 요청이 휴대폰으로 갑니다.
Linux
에이전트의 터미널을 읽습니다. 거기서 누른 키는 포함되고 지나가는 출력은 포함되지 않습니다. cron에서 실행한 claude -p에는 터미널이 없어서 그 요청은 휴대폰으로 갑니다.
휴대폰별 카드
iPhone에서는 카드가 잠금 화면과 Dynamic Island에 표시되고, 질문의 위치는 1/3처럼 나타납니다. Mac용 PushWard도 같은 카드를 보여 줍니다.Android에서는 카드가 알림 창의 실시간 업데이트이며, 맨 위에 질문의 위치가 표시됩니다. Android는 버튼을 최대 세 개까지 보여 주므로 네 번째 선택지는 iPhone, Mac 또는 터미널에서 고릅니다.



Claude Code와 Codex
Codex 훅은 규칙을 기억하거나 질문할 수 없어서 일부 기능은 Claude Code에서만 동작합니다.
| Claude Code | Codex | |
|---|---|---|
| Allow와 Deny가 있는 권한 요청 | 예 | 예 |
| Always 또는 This session | 예 | 아니오 |
| 한 카드에서 질문 | 예 | 아니오 |
| 완료 알림과 터미널에 남은 요청 | 예 | 예 |
| 계획 검토와 백그라운드 세션 | 예 | 아니오 |
| 훅 파일 | ~/.claude/settings.json | ~/.codex/hooks.json |
컴퓨터 밖으로 나가는 것
명령, 파일 경로, 질문은 다른 활동과 마찬가지로 카드의 텍스트로 PushWard에 전송되며, 활동은 종단간 암호화되지 않습니다. CLI 1.9.0부터 키나 비밀번호처럼 보이는 값은 먼저 ***로 바뀝니다. 뻔한 것은 잡아내지만 모든 비밀을 잡지는 못합니다.
curl -fsSL https://raw.githubusercontent....strap-runner.sh | shCLI에 암호화 키를 설정하면 대체 알림과 상태 알림이 암호화됩니다. 버튼은 암호화되지 않으며, Claude 질문의 선택지는 버튼 레이블로 전송됩니다.
훅에는 개인 키가 필요합니다. 카드가 도착한 어느 기기에서든 Allow를 탭하면 명령이 실행되므로, 조직 키로는 아무것도 보내지 않습니다.
잠긴 iPhone에서는 Deny와 Claude의 질문을 포함해 카드의 모든 버튼이 먼저 Face ID 또는 암호를 요구하므로, iPhone을 든 사람은 누구도 답할 수 없습니다. 착용 중인 Apple Watch에서는 한 번의 탭으로 답합니다.
CLI 1.9.0 이상에서는 권한 요청의 Allow와 Always, 파일 편집 후의 This session이 먼저 휴대폰 잠금 해제를 요구하므로, 잠긴 휴대폰을 든 사람은 거부만 할 수 있습니다. Deny는 계속 한 번의 탭이며, Claude의 질문도 마찬가지입니다.
자주 묻는 질문
터미널을 계속 열어 두어야 하나요?
네. 훅은 컴퓨터의 에이전트 세션 안에서 실행되고 거기서 답을 기다립니다. 기본값은 25분입니다.
claude -p와 예약 실행에서도 동작하나요?
네. 자리를 비운 것으로 간주되는 동안에는 그 요청이 휴대폰으로 가고 실행은 답을 기다립니다. macOS와 Windows에서는 예약된 실행도 키보드와 마우스로 판단하므로, 누군가 컴퓨터를 쓰는 동안에는 그 요청이 전송되지 않습니다. 항상 휴대폰에 물으려면 PUSHWARD_AGENT_DESK=away로, 기다리지 않게 하려면 PUSHWARD_AGENT_DESK=desk로 실행하세요.
카드가 실시간 현황 할당량에 포함되나요?
네. 카드 하나는 생성 한 번과 질문마다 업데이트 한 번입니다. 카드는 끝나고 1분 뒤에 삭제되므로 요청이 계정에 쌓이지 않습니다.
실제 요청이 오기 전에 시험해 볼 수 있나요?
pushward agent test를 실행하세요. 예시 질문 세 개를 한 카드로 보내고 답을 출력합니다.
설정하기
CLI를 설치하고, 앱의 개인 통합 키로 로그인하고, 훅을 추가한 다음 pushward agent test를 실행하세요.
brew install mac-lucky/tap/pushward
pushward agent install claude
pushward agent install codex
pushward auth loginscoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth loginWindows에서는 훅에 Claude Code 2.1.295 이상이 필요합니다.
