작업 중인 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는 휴대폰에서 모니터링, 조정, 승인, 검토를 하며 작업을 이어가는 곳입니다.

설정하기:

세 가지 모드(언제 무엇을 쓰는지)

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는 현재 턴을 중단하고 새 턴을 시작합니다. "실행을 영원히 멈추는" 것은 아니고, 현재 턴을 바꾸는 것입니다.

단계별 방법: 휴대폰에서 안전하게 조정하는 워크플로

  1. 수정이 작다면 Steer immediately를 시도합니다.
  2. 스티어링이 지원되지 않으면(또는 확실하지 않으면) 작업 중 전송을 Pending until ready로 두고 메시지를 큐에 넣습니다. 지금 반영해야겠다고 판단되면 큐의 메시지에서 Steer now를 씁니다.
  3. 실행이 분명히 잘못된 일을 하고 있어 멈춰야 한다면: Interrupt.

문제 해결

증상: 스티어링을 기대했는데 큐에 들어갔다

가능한 원인:

  • 이 런타임이나 백엔드는 스티어링을 지원하지 않는다

해결:

  • 이 세션에서는 대기 큐 워크플로로 다룬다

증상: 중단할 때마다 에이전트가 작업을 다시 한다

가능한 원인:

  • 안정적인 새 목표를 주지 않고 자주 중단하고 있다

해결:

  • 명확한 수정을 하나 보내고 실행되게 둔다. 추가 생각은 대기 큐에 넣는다

자주 묻는 질문

스티어링은 항상 쓸 수 있나요?

아니요. 백엔드나 런타임의 지원 여부에 달려 있습니다.

스티어링을 쓸 수 없다면 대기 큐가 안전한 동작입니다.

관련 가이드

mobilesessionssteeringworkflows
마지막 업데이트: 2026-10-26