1Byte Systems

가이드 · 1B Terminal

AI 에이전트 알림을 휴대폰으로 받기

코딩 에이전트는 권한을 묻거나, 작업을 끝내거나, 오류를 만나면 멈추지만 아무도 보고 있지 않습니다. 1B Terminal과 몇 분의 설정이면 그런 순간이 답장할 수 있는 알림으로 Android 휴대폰에 도착합니다.

설정은 2026년 11월 4일에 각 도구의 공식 문서와 대조해 확인했습니다.

에이전트의 질문을 놓치는 이유

나를 기다리는 에이전트는 아무것도 하지 않습니다. 1B Terminal은 그 사실을 꼭 알려 줍니다.

  • 멈추고 기다립니다

    Claude Code, Codex, OpenCode 등의 에이전트는 명령을 실행하거나 파일을 편집하기 전에 잠시 멈춥니다. 화면을 보고 있지 않으면 돌아올 때까지 작업이 멈춰 있습니다.

  • 휴대폰이 알아챕니다

    1B Terminal은 터미널 벨과 에이전트 알림(OSC 9, OSC 777)을 보고 있지 않은 모든 세션에 대해 Android 알림으로 바꿉니다. tmux 안에서도 마찬가지입니다. 버전 1.2.0부터 앱이 자체 tmux 세션에서 allow-passthrough를 알아서 켭니다.

  • 알림에서 답장

    모든 알림에는 답장, Enter, y 버튼이 있습니다. 앱을 열지 않고 답을 입력하거나 음성으로 말하고, Enter로 확인하거나 '예'라고 답할 수 있습니다.

  • 에이전트가 알림을 보내지 않아도

    알림을 전혀 보내지 않는 프로그램이라도, 한동안 작업한 뒤 출력이 멈추면 1B Terminal이 알려 줄 수 있습니다. 작업을 마쳤거나 나를 기다리고 있을 가능성이 큽니다.

1B Terminal에서 설정하기

휴대폰에서 다섯 단계면 됩니다. 굵게 표시한 이름은 앱(버전 1.2.0)에 보이는 그대로입니다.

  1. 1B Terminal 설치

    Android 휴대폰(Android 8.0 이상)에서 Google Play로 받으세요. 계정을 만들 필요가 없습니다.

    Google Play에서 받기

  2. 서버 추가

    호스트에서 +를 눌러 새 호스트를 열고 주소, 사용자 이름, 키 또는 비밀번호를 입력한 뒤 저장하세요. 한 번 연결해서 서버의 지문을 확인하세요.

  3. 호스트에서 tmux 켜기

    호스트 편집 화면의 세션에서 연결 시 tmux에 접속을 켜세요. 연결이 끊겨도 에이전트는 서버에서 계속 실행되고, 1B Terminal은 그 알림이 tmux를 통과하도록 합니다. 서버에 tmux가 설치되어 있어야 합니다.

  4. 에이전트용 서버 준비

    설정 › AI 에이전트 › 에이전트용 서버 준비를 여세요(세션의 ⋮ 메뉴에도 있습니다). 다음 섹션의 설정이 복사할 수 있게 표시됩니다. 앱은 서버의 파일을 절대 바꾸지 않습니다. 직접 추가하세요.

  5. 알림 허용

    Android 13 이상에서는 앱이 요청할 때 알림을 허용하세요. 설정 › 알림에서 세션에서 확인이 필요하면 알림을 켜 두고, 원하면 출력이 멈추면 알림을 켜고, 버튼을 쓰려면 알림에서 답장을 켜 두세요.

이제 에이전트를 시작하고 다른 앱으로 전환하거나 휴대폰을 잠그세요. 에이전트가 나를 필요로 하면 알림이 옵니다. 누르면 그 세션으로 돌아갑니다.

에이전트별로 바꿀 설정

각 도구의 공식 문서에 나오는 설정만, 직접 확인할 수 있도록 링크와 함께 소개합니다.

Claude Code

Claude Code는 기본적으로 인식하지 못하는 터미널에는 아무것도 보내지 않습니다. 문서에는 “Other terminals: nothing”이라고 되어 있습니다. 어떤 터미널에서든 터미널 벨을 울리도록 설정하면 1B Terminal이 그 벨을 알림으로 바꿉니다.

파일: ~/.claude/settings.json
{
  "preferredNotifChannel": "terminal_bell"
}

Claude Code에서 /config를 열고 Local notifications로 가서 터미널 벨을 선택해도 됩니다.

tmux를 직접 시작하는 경우

연결 시 tmux에 접속을 쓰면 1B Terminal이 자체 세션에서 이미 알림을 통과시킵니다. 대신 tmux를 직접 시작한다면 Claude Code 문서의 다음 줄을 추가하고 tmux source-file ~/.tmux.conf로 다시 불러오세요.

파일: ~/.tmux.conf
set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

세션 상태: Claude Code v2.1.295 이상은 각 세션이 작업 중인지 나를 기다리는지 알려 주고(OSC 7501), 1B Terminal은 이를 세션 탭에 표시합니다. Claude Code를 tmux 밖에서 실행할 때만 작동합니다.

공식 문서: code.claude.com/docs/en/terminal-config · code.claude.com/docs/en/settings-reference ·

Codex

Codex는 알림을 OSC 9 알림으로 보낼 수 있고, 1B Terminal은 이를 내용과 함께 표시합니다. 사용자 설정 파일에 다음 줄을 추가하세요.

파일: ~/.codex/config.toml
[tui]
notifications = true
notification_method = "osc9"
notification_condition = "always"

“always”로 하면 Codex는 터미널에 포커스가 있을 때도 알립니다. 1B Terminal은 보고 있는 세션에 대해서는 절대 알리지 않으므로 중복 알림은 오지 않습니다.

공식 문서: learn.chatgpt.com/docs/config-file/config-reference ·

OpenCode

OpenCode의 주의 알림은 기본적으로 꺼져 있습니다. tui.json에서 켜세요.

파일: tui.json
{
  "$schema": "https://opencode.ai/tui.json",
  "attention": {
    "enabled": true,
    "notifications": true
  }
}

OpenCode 문서에는 그 파일의 위치가 나와 있지 않습니다. 다만 OPENCODE_TUI_CONFIG 변수로 파일을 지정할 수 있다고 되어 있습니다. OpenCode는 터미널에 포커스가 없을 때만 알리며, 1B Terminal은 내가 세션을 떠나면 이를 OpenCode에 알려 줍니다.

공식 문서: opencode.ai/docs/tui ·

Antigravity CLI

Google의 Antigravity CLI는 agy로 실행됩니다. 문서에 알림 설정이 설명되어 있지 않으므로, 출력이 멈추면 1B Terminal이 알리도록 하세요.

공식 문서: github.com/google-antigravity/antigravity-cli ·

그 밖의 에이전트

설정 › 알림에서 출력이 멈추면 알림을 켜세요. 바쁘게 돌던 세션이 출력을 멈추면 1B Terminal이 알려 줍니다. 프로그램이 끝났거나 답을 기다리고 있을 가능성이 큽니다.

자주 묻는 질문

tmux가 꼭 필요한가요?

아니요. 알림은 일반 SSH 세션에서도 작동하며, 앱이 백그라운드에서 연결을 유지합니다. tmux를 권하는 이유는 연결이 끊겨도 에이전트가 서버에서 계속 일하고, 다시 연결하면 1B Terminal이 같은 세션으로 돌아가기 때문입니다.

iPhone에서도 되나요?

아니요. 1B Terminal은 Android(8.0 이상)에서만 사용할 수 있습니다.

1Byte Systems로 전송되는 것이 있나요?

아니요. 연결은 SSH로 휴대폰에서 서버로 바로 이어지고, 알림은 휴대폰에서 만들어집니다. 중간에 1Byte 서버도, 계정도 없습니다.

보고 있는 세션의 알림은 왜 오지 않나요?

의도한 것입니다. 1B Terminal은 보고 있지 않은 세션에 대해서만, 세션마다 최대 5초에 한 번 알립니다.

앱을 열지 않고 답장할 수 있나요?

네, 알림의 답장, Enter, y 버튼으로 할 수 있습니다. 앱 잠금이 켜져 있으면 숨겨집니다.

1B Terminal 받기

Android 휴대폰에서 AI 에이전트와 일하기 위한 SSH 터미널. 키, tmux, 에이전트에 맞춘 키 줄, 그리고 확실히 도착하는 알림.