제품 목록
ProductsAI 개발 도구2026년 7월 3일
Claude Gateway
로컬 Claude CLI 를 어디서든 호출하는 HTTP API 로 열어 주는 범용 게이트웨이 (Docker·n8n·챗봇 연동)
Node.jsExpressSSEPythonPM2
#Claude CLI#API Gateway#n8n연동#SSE
로컬 Claude CLI 를 어디서든 호출할 수 있는 HTTP API 로 열어 주는 범용 게이트웨이. Docker · n8n · 챗봇 · 웹서비스가 모두 하나의 엔드포인트로 Claude 를 부릅니다.
무엇을 하나요
- HTTP API 노출 — 로컬
claudeCLI 를child_process.spawn()으로 감싸 RESTful API(기본 포트 3456)로 노출합니다. - 다양한 호출 방식 — 단일 메시지(
/chat), 실시간 스트리밍(/chat/stream, SSE), 파일 첨부(/chat/with-file), 맥락 유지 대화(/conversations). - 세션·에이전트 추적 — Claude Code 세션 히스토리 조회·요약, 서브에이전트 도구 사용 로그 추적(
/sessions/*). - 스킬/커맨드·Git 연동 — 스킬·커맨드 스캔/실행(
/skills,/commands), Git 변경 분석(/git/changes). - 운영 자동화 — macOS LaunchAgent 등록/해제(
/launchd/*), Code-Pulse 원클릭 설치(/setup/code-pulse). - Docker 브리지 — 방화벽이 Docker→Host 를 막을 때 Host→Docker 역방향 WebSocket 으로 우회하는
bridge.py포함.
기술 스택
| 영역 | 사용 기술 |
|---|---|
| 언어 | JavaScript(Node.js, CommonJS) + Python 3(bridge) |
| 프레임워크 | Express 4 · cors · uuid |
| 전송 | SSE 스트리밍 · express.json/text 50mb |
| 상태 | 인메모리 Map(대화 히스토리) · 설정은 ~/.code-pulse/gateway-config.json |
| 구조 | server.js + src/routes(11) + src/services(claude.js, skillScanner.js) |
| 실행 | PM2(Makefile) 또는 macOS LaunchAgent |
기술적으로 주목할 점
- CLI 주입 —
claude -p -로 stdin 프롬프트 주입,[System]/[User]/[Assistant]포맷.CLAUDECODE제거로 중첩 세션 루프 방지. - 장시간 작업 대응 — 서버 타임아웃 비활성화로 긴 스킬 실행 지원.
- 역방향 브리지 — macOS 방화벽의 Docker→Host 차단을 Host→Docker 역접속으로 우회.
- 얇은 라우터 · 분리된 서비스 — 비즈니스 로직은 services 로, logger 유틸 강제 컨벤션.