Claude부터 Codex까지, AI 코딩 비서 하나로 제어하는 법 – AgentAPI 완전정복

안녕하세요.

오늘은 다양한 AI 코딩 도우미를 하나의 인터페이스로 제어할 수 있는 혁신적인 오픈소스 도구, AgentAPI에 대해서 소개드립니다. Claude, Aider, Goose, Codex 같은 다양한 AI 코드 보조 툴을 쓰다 보면 각각 다르게 작동하고, 따로 실행해야 하며, 인터페이스도 제각각이라 불편했던 경험 있으실 겁니다. AgentAPI는 이러한 문제를 통합된 HTTP API라는 방식으로 말끔히 해결해주는 도구입니다. 오늘 글에서는 이 AgentAPI가 무엇인지, 어떻게 활용할 수 있는지, 설치부터 실전 활용까지 상세히 풀어보겠습니다.

---

AgentAPI란 무엇인가?

AgentAPI는 Claude, Goose, Aider, Codex 같은 대표적인 AI 코딩 도우미들을 하나의 HTTP API로 제어할 수 있도록 해주는 오픈소스 입니다. 기존에는 각 코딩 에이전트를 실행하고, 입력하고, 결과를 받아보는 과정이 따로따로였죠. 하지만 AgentAPI를 이용하면 이러한 과정을 통합 인터페이스로 단순화할 수 있습니다.

 

Claude, Aider, Goose, Codex 같은 다양한 AI 코드 보조 툴을 통합된
인터페이스로 제어가 가능합니다.

🔧 지원하는 코딩 에이전트 

AgentAPI는 다음과 같은 대표 AI 코딩 에이전트를 지원합니다:

• Claude: Anthropic에서 만든 대화형 AI로, 코드 작성과 설명에 강점
• Aider: Git 기반 변경 이력을 중심으로 코드를 수정하고 설명
• Goose: 시뮬레이션과 코딩 명령 실행 중심의 에이전트
• Codex: OpenAI의 코드 특화 모델로, 자연어를 코드로 변환

이처럼 에이전트마다 특화된 기능이 다르기 때문에, AgentAPI를 통해 여러 에이전트를 하나의 포맷으로 제어하는 것이 훨씬 효율적입니다.

---

AgentAPI의 핵심 활용 사례

💡 어디에 쓸 수 있을까?

• 통합 채팅 인터페이스 제작: 다양한 AI 에이전트와 대화를 주고받는 단일 인터페이스 개발 가능
• Pull Request 리뷰 자동화: 특정 키워드나 변경사항 감지 시 자동으로 코드 리뷰 요청
• 에이전트 간 제어 시스템 구축: 하나의 MCP 서버에서 다른 코딩 에이전트를 제어

예를 들어, PR이 열리면 Aider를 통해 자동 리뷰를 제출하거나, Claude를 호출하여 코드 설명을 받아보는 식의 워크플로우를 만들 수 있습니다.

---

설치 방법과 실행 가이드

⚙️ 설치는 두 가지 방식으로

• ✔️ Release 바이너리 다운로드: GitHub Release 페이지에서 최신 버전 다운로드
• ✔️ 소스코드 빌드: 터미널에서 다음 명령 실행

  go install github.com/coder/agentapi@latest

🍏 macOS 설치 이슈 해결

macOS에서 "확인되지 않은 개발자" 경고가 나올 경우, 다음 경로에서 실행 허용:

시스템 설정 → 개인정보 보호 및 보안 → '어쨌든 열기'

---

AgentAPI 기본 사용법

🚀 서버 실행하기

AgentAPI는 커맨드라인을 통해 에이전트를 서버 형태로 실행할 수 있습니다:

agentapi server -- claude

이렇게 실행하면, 로컬 포트 3284에서 HTTP API 서버가 작동하며 Claude와의 대화가 가능합니다.

🧪 명령어 예시

• 메시지 전송:

  curl -X POST localhost:3284/message \
    -H "Content-Type: application/json" \
    -d '{"content": "Hello, agent!", "type": "user"}'

• 대화 히스토리 조회:

  curl localhost:3284/messages

---

AgentAPI의 작동 원리

🔍 터미널 기반 세션 분석

AgentAPI는 실제 터미널 환경에서 에이전트를 실행하고, 사용자 입력에 따라 출력되는 결과를 스냅샷으로 캡처합니다.

이후 출력 내용을 비교(diff)하여 새로 추가된 텍스트만 추출하고, 이를 하나의 응답 메시지로 분리합니다. 이를 통해 실시간으로 에이전트와 대화하듯 데이터를 주고받을 수 있게 됩니다.

🧼 불필요한 UI 요소 제거

터미널에는 보통 입력창, 안내 문구 등 불필요한 TUI(Text-based UI) 요소가 섞여 있는데, AgentAPI는 이를 자동으로 걸러냅니다.

예를 들어:

• 사용자가 입력한 명령어 → 자동 제거
• 에이전트 입력창 표시(예: >, ------) → 자동 제거

---

OpenAPI 문서와 API UI 활용

📘 문서 확인 주소

AgentAPI는 Swagger 기반 OpenAPI 문서를 제공합니다:

• 📄 http://localhost:3284/openapi.json - 스키마 JSON
• 🧭 http://localhost:3284/docs - UI 기반 문서

API를 직접 테스트하고 문서를 보며 개발을 진행할 수 있어 매우 편리합니다.

 

---

앞으로의 로드맵

🛤️ 예고된 기능들

• MCP 프로토콜 지원
• Agent2Agent 제어 기능

장기적으로는 주요 에이전트들이 SDK를 제공할 가능성이 있지만, 표준화되지 않는 한 AgentAPI는 통합 어댑터의 역할을 계속 수행할 것입니다.

---

결론: AgentAPI가 필요한 이유

다양한 AI 코딩 에이전트를 사용하는 개발자라면, 각각 따로 실행하고 제어하는 것이 번거롭습니다. 특히 여러 작업을 동시에 처리할 때는 통합된 인터페이스가 절실하죠. AgentAPI는 이러한 문제를 HTTP API 방식으로 해결하며, 실험적이지만 강력한 통합 제어 도구로 자리 잡고 있습니다. API 하나로 Claude와 이야기하고, Aider에게 리뷰를 맡기고, Goose에 시뮬레이션을 요청할 수 있는 시대가 온 것입니다.

코딩 생산성을 높이고, 자동화된 개발환경을 구성하고 싶은 분들께 AgentAPI는 훌륭한 출발점이 될 것입니다.

---

출처

https://github.com/coder/agentapi

GitHub - coder/agentapi: HTTP API for Claude Code, Goose, Aider, and Codex