Context Vault

OpenACP — 메신저에서 AI 코딩 에이전트 사용하기

6 min read

OpenACP — 메신저에서 AI 코딩 에이전트 사용하기

Self-hosted 브릿지로 28+ AI 코딩 에이전트(Claude Code, Codex, Gemini, Cursor 등)를 Telegram, Discord, Slack에서 사용. ACP(Agent Client Protocol) 기반, MIT 라이선스.

Key Points

  • 28+ AI 코딩 에이전트를 Telegram/Discord/Slack에서 직접 사용
  • ACP 기반 세션 관리 — 터미널/IDE 없이 모바일에서 코딩 가능
  • 실시간 스트리밍, 권한 승인/거부, 음성 메시지 지원
  • REST API로 CI/CD 연동 가능 (GitHub Actions, 이슈 트래커 등)
  • Self-hosted — 자체 머신, 자체 키, 자체 데이터
  • npm 패키지 @openacp/cli, macOS/Linux/Windows 지원

Content

아키텍처

You (Telegram / Discord / Slack)
  ↓
OpenACP (bridge + session manager)
  ↓
AI Agent (Claude Code, Codex, Gemini, Cursor, ...)
  ↓
Your Codebase

MCP(Model Context Protocol)가 모델에 도구/데이터를 제공하는 표준이라면, OpenACP는 ACP로 전체 코딩 에이전트 세션을 관리 — 시작, 스트리밍, 권한 처리, 결과 라우팅. 두 프로토콜은 상호보완적.

설치

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Open-ACP/OpenACP/main/scripts/install.sh | bash

Windows (PowerShell):

powershell -c "irm https://raw.githubusercontent.com/Open-ACP/OpenACP/main/scripts/install.ps1 | iex"

npm (Node.js 20+ 필요):

npm install -g @openacp/cli
openacp  # → 인터랙티브 설정 마법사

주요 기능

메신저 플랫폼:

플랫폼상태특징
TelegramStableForum topics별 세션, 스트리밍, 권한 버튼, 음성
DiscordStableThread 기반 세션, 슬래시 명령, 버튼 인터랙션
SlackStableSocket Mode, 채널 기반 세션, 스레드 조직

코어 기능:

  • 28+ AI 에이전트 — Claude Code, Codex, Gemini CLI, Cursor, Copilot, Cline, Goose, Amp, Junie, Kilo, Qwen Code 등 (ACP Registry 기반)
  • 세션 관리 — 대화별 자동 생성, 자동 명명, 재시작 후에도 유지
  • 권한 제어 — 버튼으로 에이전트 액션 승인/거부, 오토어프루브 규칙 설정 가능
  • 실시간 스트리밍 — 에이전트 생각, 툴 호출, 출력 실시간 표시
  • 에이전트 전환 — /switch로 대화 중간에 에이전트 변경, 히스토리 자동 이관

개발자 도구:

  • 터널 & 포트 포워딩 (Cloudflare, ngrok, bore, Tailscale)
  • 내장 파일 뷰어 (Monaco Editor, 구문 하이라이트, diff)
  • 세션 전송 (/handoff) — 터미널 ↔ 채팅 간 세션 이동
  • 음성 메시지 (Groq STT + Edge TTS)
  • 사용량 추적 (토큰 수, 비용 리포트, 월별 예산 한도)

지원 에이전트 (ACP Registry 기반)

에이전트타입설명
Claude CodenpxAnthropic의 Claude 코딩 에이전트
Gemini CLInpxGoogle의 Gemini CLI
Codex CLInpxOpenAI의 코딩 어시스턴트
GitHub CopilotnpxGitHub의 AI 페어 프로그래머
CursorbinaryCursor 코딩 에이전트
Clinenpx자율형 코딩 에이전트
GoosebinaryBlock의 오픈소스 AI 에이전트
Ampbinary프론티어 코딩 에이전트
JuniebinaryJetBrains AI 코딩 에이전트
Qwen Codenpx알리바바 Qwen 어시스턴트
openacp agents                     # 전체 에이전트 목록
openacp agents install <name>      # 레지스트리에서 설치

유스케이스

  • 원격 코딩 — 휴대폰에서 Claude Code로 버그 수정, PR 리뷰, 배포
  • 팀 가시성 — Discord 채널에서 에이전트 작업 실시간 공유
  • 멀티 에이전트 워크플로 — Claude Code로 기획 → Codex로 구현 → Gemini로 리뷰, 한 채팅 스레드에서
  • CI/CD 연동 — REST API로 GitHub Actions나 이슈 트래커에서 에이전트 세션 트리거
  • 로컬 LLM — Ollama, LM Studio 기반 자체 호스팅 모델 사용 가능

CLI 주요 명령

openacp                        # 시작 (첫 실행 = 설정 마법사)
openacp start / stop / restart # 데몬 관리
openacp status                 # 데몬 상태 확인
openacp config                 # 설정 편집
openacp doctor                 # 시스템 진단
openacp api new [agent] [workspace]  # API로 세션 생성
openacp tunnel add <port>      # 터널 추가

제한사항

  • 초기 개발 단계 — 마이너 버전 간 breaking changes 가능
  • 단일 사용자 설계 — 멀티유저/팀 기능은 계획 중
  • 에이전트는 OpenACP와 동일 머신에서 실행
  • Windows 데몬 미지원 (macOS/Linux만)

그래프 뷰