시작 안내

내 컴퓨터와 연결하는
가장 짧은 순서.

PC 프로그램, 모바일 앱, 그리고 한 번의 연결 승인.

모바일 앱도 함께 필요합니다.

Android 앱은 Google Play에서 받을 수 있습니다. PC 프로그램과 모바일 앱을 설치한 뒤 QR 코드로 연결하세요.

컴퓨터에 설치하세요.

운영체제를 고르고 컴퓨터의 터미널에서 명령을 실행하세요. 네트워크 연결이 필요합니다.

Terminal · zsh / bash

curl -fsSL https://github.com/da-itda/terminal-itda/releases/latest/download/install.sh | sh

Apple Silicon·Intel 지원. 사용자 폴더에 설치합니다.

설치 프로그램은 OS·CPU 확인과 다운로드 체크섬 검증 후 사용자 폴더에 설치하고 설정을 안내합니다. Claude Code·Codex·herdr 설치나 업데이트는 먼저 물어보며, herdr는 선택입니다.

PC 배포 파일 보기

앱으로 QR을 스캔하세요.

앱이 공개되면 설치하고 로그인하세요. PC 설정 중 표시된 QR을 앱으로 스캔하고, 컴퓨터에서 연결할 기기를 확인한 뒤 승인하세요.

PC 설정→앱에서 스캔→PC에서 승인

새 QR이 필요하면 컴퓨터에서 아래 명령을 실행하세요. 일반 카메라가 아닌 앱 안의 스캐너를 사용합니다.

terminal-itda pair

대화를 고르고 이어가세요.

컴퓨터와 사용 가능한 Claude Code·Codex 대화를 선택하세요. 지원 작업 도구에 그 대화가 열려 있으면 그곳에서 이어갑니다. 새 작업은 선택한 폴더의 세션에서 시작할 수 있습니다.

컴퓨터는 켜 두고 잠자기와 네트워크 상태를 확인하세요. AI 도구 로그인은 컴퓨터에서 먼저 완료하세요.

호환 범위

사용 환경에 따라 확인할 것들.

macOS

Apple Silicon·Intel 빌드를 제공합니다. 백그라운드 서비스는 launchd를 사용합니다.

Windows

Windows 10 1809 이상. PowerShell에서 설치하세요. 같은 네트워크의 직접 연결을 위해 방화벽 요청을 허용하세요. 일부 바탕화면·첫 설치 확인은 진행 중입니다.

Linux

amd64·arm64를 지원합니다. 백그라운드 자동 실행에는 systemd 사용자 서비스가 필요합니다.

herdr / Orca / cmux

사용하는 작업 도구를 별도로 설치하세요. cmux는 설정에서 자동화를 허용해야 합니다. Orca의 새 작업은 등록된 프로젝트에서 열립니다. 도구·OS에 따라 지원 기능이 다릅니다.

PRO

KEEP AWAKE

노트북 덮개를 닫고도 이어가기.

잠들지 않기는 기본 꺼짐인 Pro 기능입니다. PC 0.14.0 이상과 호환 앱에서, 컴퓨터가 계속 깨어 있어야 할 때 켜세요.

Mac 권한을 한 번 설정하세요.
처음 설치할 때 덮개 권한을 허용하거나 Mac에서 아래 명령을 실행하세요. 잠자기 설정 변경을 위해 관리자 승인을 요청합니다.
```
terminal-itda awake setup
```
앱에서 잠들지 않기를 켜세요.
컴퓨터의 ⋮ 메뉴 → 잠들지 않기 켜기를 선택하세요. 컴퓨터 옆의 켜짐·전원/배터리·온도 표시를 확인하세요.
덮개를 닫고 폰에서 이어가세요.
설정된 MacBook은 외부 모니터나 전원 어댑터 없이도 사용할 수 있습니다. 핫스팟 등 네트워크 연결을 유지하고 열이 빠져나갈 수 있는 곳에 두세요.

기기별 지원

MacBook은 덮개 닫힘 실사용을 확인했습니다. Windows는 덮개 전원 설정을 사용하며, 기기·Modern Standby 등 전원 정책에 따라 제한될 수 있고 노트북 덮개 실기 확인은 남아 있습니다. Linux는 systemd-inhibit와 해당 시스템의 권한·전원 관리 지원이 필요합니다.

자동 해제

읽을 수 있는 배터리 정보가 배터리 사용 중 20% 이하이거나, 지원되는 온도 정보가 높은 열을 감지하면 잠들지 않기를 해제하고 폰으로 알립니다. 시스템마다 확인 가능한 센서가 다르므로 통풍과 상태를 확인하세요.

AI에게 설치를 부탁하려면

설치 안내를 AI에게 전달하세요.

코딩 에이전트에게 붙여넣기

이 컴퓨터에 terminal-itda를 설치해 주세요. https://github.com/da-itda/terminal-itda 의 공식 설치 안내와 운영체제를 확인하고, 설치할 항목을 설명한 뒤 설치·상태를 확인해 주세요. AI 도구 설치·업데이트는 먼저 물어보고, 앱 로그인·QR 스캔·PC 기기 승인은 제가 하도록 안내해 주세요.

업데이트와 관리

업데이트, 상태 확인, 연결 해제.

terminal-itda update

PC 프로그램을 업데이트합니다. 데몬 재시작 시 실행 중 세션이 끝날 수 있으니 작업을 먼저 확인하세요.

terminal-itda status

백그라운드 서비스와 연결 상태를 확인합니다.

terminal-itda devices

연결한 기기를 확인합니다. devices remove 뒤에 번호나 이름을 넣어 연결을 해제하세요.

terminal-itda uninstall

PC 프로그램과 백그라운드 서비스 설정을 제거합니다.