본문으로 건너뛰기

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 login
scoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth login

Windows에서는 훅에 Claude Code 2.1.295 이상이 필요합니다.

App Store에서 다운로드 하기Google Play에서 다운로드

작동 방식

  1. 훅 설치

    pushward agent install은 Claude Code나 Codex에 훅을 추가하고 기존 훅은 그대로 둡니다. Codex에서는 /hooks로 한 번 신뢰해 주세요.

  2. 자리 비우기

    macOS와 Windows에서는 컴퓨터를 사용하는 동안, Linux와 SSH로 접속한 Mac에서는 에이전트의 터미널에 입력하는 동안 요청이 터미널에 남고 아무것도 전송되지 않습니다. 90초 동안 입력이 없으면 훅은 자리를 비운 것으로 봅니다.

  3. 휴대폰에서 답하기

    탭한 답은 터미널에서 답한 것처럼 세션으로 돌아갑니다. 25분 안에 답이 없으면 요청은 터미널로 돌아갑니다.

휴대폰에 도착하는 것

  • 잠금 화면의 Claude Code 권한 카드가 명령 실행을 요청하며, Bash 행에 git push origin main이 있고 Allow, Always, Deny 버튼이 있습니다.
    Android 잠금 화면에 실시간 업데이트로 표시된 Claude Code 권한 카드가 acme-api에서 Bash로 git push origin main 실행을 요청하며, Allow, Always, Deny 버튼이 있습니다.
잠금 화면의 Claude Code 권한 카드가 명령 실행을 요청하며, Bash 행에 git push origin main이 있고 Allow, Always, Deny 버튼이 있습니다.
Android 잠금 화면에 실시간 업데이트로 표시된 Claude Code 권한 카드가 acme-api에서 Bash로 git push origin main 실행을 요청하며, Allow, Always, Deny 버튼이 있습니다.

자리에 있으면 아무것도 전송되지 않습니다

훅은 무엇이든 보내기 전에 최근 90초 안에 컴퓨터를 사용했는지 확인합니다. 요청이 휴대폰에서 기다리는 동안 돌아오면 카드는 끝나고 요청은 터미널로 돌아갑니다.

  • macOS

    키보드와 마우스가 얼마나 오래 쉬었는지 읽습니다. SSH로 접속하면 Linux처럼 에이전트의 터미널을 대신 읽습니다.

  • Windows

    마찬가지로 키보드와 마우스의 유휴 시간을 읽습니다. SSH로는 읽을 것이 없어서 모든 요청이 휴대폰으로 갑니다.

  • Linux

    에이전트의 터미널을 읽습니다. 거기서 누른 키는 포함되고 지나가는 출력은 포함되지 않습니다. cron에서 실행한 claude -p에는 터미널이 없어서 그 요청은 휴대폰으로 갑니다.

휴대폰별 카드

iPhone에서는 카드가 잠금 화면과 Dynamic Island에 표시되고, 질문의 위치는 1/3처럼 나타납니다. Mac용 PushWard도 같은 카드를 보여 줍니다.Android에서는 카드가 알림 창의 실시간 업데이트이며, 맨 위에 질문의 위치가 표시됩니다. Android는 버튼을 최대 세 개까지 보여 주므로 네 번째 선택지는 iPhone, Mac 또는 터미널에서 고릅니다.

휴대폰에서 답하는 Claude Code 승인 카드, 세 가지 질문이 차례로
Dynamic Island에서 펼친 Claude Code 카드: 3개 중 1번째 질문이 새 세션 캐시에 어떤 저장소를 쓸지 묻고, Postgres, SQLite, Redis 버튼이 있습니다.
휴대폰에서 답하는 Claude Code 승인 카드, 세 가지 질문이 차례로

Claude Code와 Codex

Codex 훅은 규칙을 기억하거나 질문할 수 없어서 일부 기능은 Claude Code에서만 동작합니다.

Claude CodeCodex
Allow와 Deny가 있는 권한 요청예예
Always 또는 This session예아니오
한 카드에서 질문예아니오
완료 알림과 터미널에 남은 요청예예
계획 검토와 백그라운드 세션예아니오
훅 파일~/.claude/settings.json~/.codex/hooks.json

컴퓨터 밖으로 나가는 것

명령, 파일 경로, 질문은 다른 활동과 마찬가지로 카드의 텍스트로 PushWard에 전송되며, 활동은 종단간 암호화되지 않습니다. CLI 1.9.0부터 키나 비밀번호처럼 보이는 값은 먼저 ***로 바뀝니다. 뻔한 것은 잡아내지만 모든 비밀을 잡지는 못합니다.

카드에 표시되는 긴 명령
Bash curl -fsSL https://raw.githubusercontent....strap-runner.sh | sh

CLI에 암호화 키를 설정하면 대체 알림과 상태 알림이 암호화됩니다. 버튼은 암호화되지 않으며, Claude 질문의 선택지는 버튼 레이블로 전송됩니다.

훅에는 개인 키가 필요합니다. 카드가 도착한 어느 기기에서든 Allow를 탭하면 명령이 실행되므로, 조직 키로는 아무것도 보내지 않습니다.

자주 묻는 질문

터미널을 계속 열어 두어야 하나요?

네. 훅은 컴퓨터의 에이전트 세션 안에서 실행되고 거기서 답을 기다립니다. 기본값은 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 login
scoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth login

Windows에서는 훅에 Claude Code 2.1.295 이상이 필요합니다.

App Store에서 다운로드 하기Google Play에서 다운로드
코딩 에이전트 설정하기