문서

시작하기#

에이전트로 설치하기#

이 페이지는 사용자를 위해 aipager를 설치하고 설정해 달라는 요청을 받은 AI 코딩 에이전트(Claude Code, 또는 shell을 쓸 수 있는 다른 에이전트)를 위한 거예요. 단계별로 따라 하세요. 여기 나오는 명령은 하나도 질문하지 않고, 대화형 터미널도 필요 없어요.

레퍼런스#

아키텍처#

aipager는 백그라운드에서 실행되는 단일 프로세스 asyncio 프로그램이에요. 세 세계를 이어 줘요. 내 Telegram 채팅, 내가 dtach 아래에서 실행하는 Claude Code 프로세스, 그리고 Claude Code의 hook 시스템이에요. 모든 것이 하나의 event loop를 거쳐요. worker pool도, 데이터베이스도, 프로세스 간 대기열도 없어요.

Hook 이벤트#

Claude Code는 작업의 정해진 순간에 hook 명령을 실행해요. 메시지가 제출됐을 때, 도구가 곧 실행될 때, 도구 실행이 끝났을 때, 작업이 끝났을 때 등이에요. aipager는 이 모든 순간에 hook을 걸고, 그것을 Telegram의 활동으로 바꿔요. 작업 카드, 권한 요청, 답변, 알림, 감사 로그예요.

봇 명령과 화면#

Telegram에서 aipager를 다루는 방법이에요. 입력하는 방법은 네 가지예요. 슬래시 명령, 키보드 버튼, Mini App 대시보드, 그리고 자유 메시지(글, 파일, 음성 메시지)예요.

팀 모드와 그룹#

기본적으로 aipager는 개인 봇이에요. 나와 봇만 있는 개인 채팅 하나이고 다른 사람은 없어요. 팀 모드는 더 많은 사람에게 열어 줘요. 여러 개발자가 함께 세션을 다루는 Telegram 그룹, 다른 사람과 봇의 개인 채팅, 또는 둘 다예요. 채팅마다 자기 멤버가 있고, 멤버마다 거기서 무엇을 할 수 있는지 정하는 역할이 있어요. 메시지 보내기, Claude의 질문과 권한 요청에 답하기, 세션 관리, 또는 보기만 하기예요.

운영하기#

보안 모델#

aipager는 나를 대신해 Claude Code를 실행하고, Telegram에서 조종돼요. 그래서 두 가지 질문이 생겨요:

문제 해결#

흔한 문제와 해결 방법이에요. 잘 모르겠으면 이것을 실행하세요:

문제 신고#

aipager에 버그가 생기면 한 번 눌러서 aipager 개발자에게 문제 신고 보고서를 보낼 수 있어요. 무엇이든 보내기 전에 보고서 전체를 볼 수 있고, 내가 동의하기 전에는 아무것도 내 컴퓨터를 떠나지 않고, 보고서에는 채팅, 메시지, 이름, 경로, token이 절대 들어가지 않아요. 보고서는 정해진 필드 목록으로만 만들어져요. 버전, 횟수, 날짜, 예/아니오 답, 정해진 목록에서 고른 선택지, aipager 자체 코드 안의 위치와 그 버그의 ap1- 이름, 그리고 (내가 썼을 때만) 짧은 메모예요.