작업 중인 Claude Code나 Codex 세션을 휴대폰에서 조정하는 방법(스티어링)
에이전트가 턴 중간일 때 수정 사항을 보내는 방법. 스티어링이 되는 경우, 큐로 넘어가는 경우, 실행을 헛돌게 하지 않는 방법을 설명합니다.
- CLI
- 0.2.17
- 프리뷰 ref
- a2c45c8
흔한 타이밍 문제입니다.
세션이 턴 중간이고 에이전트가 일하고 있습니다. 그런데 지금 바꿔야 할 것이 눈에 띕니다(디렉터리가 틀림, 파일이 틀림, 계획이 틀림).
노트북 앞이라면 세션 방향을 빠르게 바꿀 수 있습니다.
휴대폰에서는 잘못 대응하기 쉽습니다.
- 후속 메시지를 보냈는데 큐에 들어가 너무 늦게 반영되거나
- 너무 세게 중단해서 실행을 헛돌게 하거나
- 끝까지 기다렸다가 실수의 대가를 치르거나
모바일에서 예측 가능하게 조정하는 방법을 소개합니다.
요약
- 현재 턴에 반영되어야 할 작은 수정이라면: Steer immediately(지원될 때).
- 스티어링이 지원되지 않으면(또는 순서대로, 편집 가능한 메시지를 원하면): Pending until ready를 씁니다.
- 지금 하는 일을 멈추고 새 맥락에서 다시 시작해야 한다면: Interrupt를 씁니다.
일반적인 방법과 트레이드오프
-
끝까지 기다리기: 안전하지만, 범위 실수를 너무 늦게 알아채는 경우가 많습니다.
-
후속 메시지를 보내고 기대하기: 이미 피해가 난 뒤에 반영되기도 합니다.
-
휴대폰에서 SSH: 되긴 하지만 모바일로 터미널 작업을 하게 됩니다.
-
Happier: 코딩 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다. 스티어링과 중단 동작이 명확하고 대기 큐로의 대체 경로도 있어서, 상황에 맞는 수단을 고를 수 있습니다. 트레이드오프: 스티어링은 지원 여부에 달려 있습니다. 백엔드나 런타임이 지원하지 않으면 앱이 강제할 수 없습니다.
Happier가 처음이라면(무엇이고 어디서 받는지)
Happier는 Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트를 위한 오픈 소스 컴패니언 앱(모바일 / 웹 / 데스크톱)입니다.
세션은 여전히 신뢰하는 머신(노트북 / 서버 / 개발 머신)에서 실행됩니다. Happier는 휴대폰에서 모니터링, 조정, 승인, 검토를 하며 작업을 이어가는 곳입니다.
설정하기:
- 휴대폰에서 Happier 사용하는 방법
- GitHub: https://github.com/happier-dev/happier
- 설치 / 다운로드: https://github.com/happier-dev/happier#how-it-works
- Discord(커뮤니티와 지원): https://discord.gg/W6Pb8KuHfg
세 가지 모드(언제 무엇을 쓰는지)
1) Steer immediately
작은 수정을 현재 턴에 반영하고 싶을 때 씁니다.
앱에서 다음을 엽니다.
- Settings → Session → Message sending → When the agent is busy (steer-capable)
- Steer immediately를 고릅니다
실제 동작:
- 백엔드가 실행 중 스티어링을 지원하면 Happier가 메시지를 진행 중인 턴에 넣습니다
- 그렇지 않으면 일반적인 "작업 중 전송" 동작으로 돌아갑니다
2) Pending until ready
이럴 때 씁니다.
- 순서를 지키고 싶다(생각이 여러 개)
- 실행 전에 편집하고 싶다
- 현재 턴을 흔들고 싶지 않다
Pending until ready를 고르고 Pending (N) 시트에서 편집, 순서 변경, 즉시 전송을 합니다.
0.2.16부터 큐에 든 메시지에는 Steer now도 있습니다. 턴을 중단하지 않고 그 메시지를 에이전트에 전달하며, 에이전트가 유휴 상태일 때도 됩니다. 메시지가 나가기 전에 스티어링을 쓸 수 없게 되면 다음 안전한 입력 시점까지 기다립니다. Send now는 기존처럼 중단하는 동작입니다. 스티어링 문서를 참고하세요.
3) Interrupt
지금 일어나는 일을 정말로 멈춰야 할 때 씁니다.
Interrupt는 현재 턴을 중단하고 새 턴을 시작합니다. "실행을 영원히 멈추는" 것은 아니고, 현재 턴을 바꾸는 것입니다.
단계별 방법: 휴대폰에서 안전하게 조정하는 워크플로
- 수정이 작다면 Steer immediately를 시도합니다.
- 스티어링이 지원되지 않으면(또는 확실하지 않으면) 작업 중 전송을 Pending until ready로 두고 메시지를 큐에 넣습니다. 지금 반영해야겠다고 판단되면 큐의 메시지에서 Steer now를 씁니다.
- 실행이 분명히 잘못된 일을 하고 있어 멈춰야 한다면: Interrupt.
문제 해결
증상: 스티어링을 기대했는데 큐에 들어갔다
가능한 원인:
- 이 런타임이나 백엔드는 스티어링을 지원하지 않는다
해결:
- 이 세션에서는 대기 큐 워크플로로 다룬다
증상: 중단할 때마다 에이전트가 작업을 다시 한다
가능한 원인:
- 안정적인 새 목표를 주지 않고 자주 중단하고 있다
해결:
- 명확한 수정을 하나 보내고 실행되게 둔다. 추가 생각은 대기 큐에 넣는다
자주 묻는 질문
스티어링은 항상 쓸 수 있나요?
아니요. 백엔드나 런타임의 지원 여부에 달려 있습니다.
스티어링을 쓸 수 없다면 대기 큐가 안전한 동작입니다.