용어 사전
CLI란? 에이전트는 왜 CLI를 좋아할까요?
CLI는 Command Line Interface의 약자입니다. 버튼을 누르는 대신 명령어를 입력해 제어하는 프로그램입니다. 이미 여러 CLI를 쓰고 있을 겁니다. git, npm, docker 같은 것들입니다.
GUI와 CLI 비교
| GUI(그래픽) | CLI(명령줄) | |
|---|---|---|
| 사용 방법 | 버튼을 누르고 항목을 드래그 | 명령어 입력 |
| 예시 | GitHub Desktop | git push |
| 사람에게 | 보통 시작하기 쉬움 | 명령어를 익히면 더 빠름 |
| 에이전트에게 | 사용하기 어려움(스크린샷과 클릭 필요) | 익숙함(에이전트는 이미 명령어를 입력함) |
에이전트가 CLI를 좋아하는 이유
AI 코딩 에이전트는 하루 종일 터미널에 명령어를 입력합니다. 코드를 실행하고, 패키지를 설치하고, git을 쓰고, 테스트를 돌리는 방법입니다. CLI는 에이전트가 이미 하는 일에 바로 맞습니다. 별도 통합도 필요 없습니다.
Pane이 에이전트에 사용자 지정 프로토콜을 요구하지 않고 runpane을 CLI로 만든 이유입니다. Claude Code, Codex, Aider, bash 스크립트 모두 상관없습니다. runpane panes create를 입력할 수 있다면 Pane을 제어할 수 있습니다.
에이전트 친화적인 CLI의 조건
모든 CLI가 에이전트에게 똑같이 좋은 건 아닙니다. 중요한 조건은 다음과 같습니다.
JSON 출력. 에이전트는 사람이 읽는 표를 안정적으로 파싱하지 못합니다. --json 플래그는 실제로 처리할 수 있는 구조화된 데이터를 줍니다.
명령어 탐색. 에이전트가 명령어 목록을 찾으려고 문서를 읽을 필요는 없어야 합니다. runpane agent-context 같은 명령어는 한 번에 모든 내용을 알려줍니다.
짧은 기본 출력. 에이전트의 컨텍스트 창은 제한돼 있습니다. 명령어가 기본으로 500줄을 쏟아내면 토큰을 낭비합니다. 좋은 CLI는 출력을 짧게 유지하고 --limit 200 같은 플래그로 더 볼 수 있게 합니다.
비대화형 모드. 에이전트는 "계속할까요? (y/n)" 같은 질문에 답할 수 없습니다. --yes 플래그가 있으면 자동화 워크플로에서 확인 단계를 건너뛸 수 있습니다.
설치 전에 확인 가능. 에이전트는 설치하기 전에 CLI가 무엇을 할 수 있는지 확인할 수 있어야 합니다. Pane은 전체 명령어 목록을 공개 URL에 게시합니다. 에이전트가 설치를 결정하기 전에 살펴볼 수 있습니다.
runpane이 이 원칙을 적용하는 방법
# Discovery: what commands exist?
runpane agent-context --json
# Short output: just what's on screen right now
runpane panels screen --panel <id> --limit 80 --json
# Non-interactive: skip the "are you sure?" prompt
runpane panes create --repo active --name "my-task" --yes --json
# Readable before install:
curl -fsSL https://runpane.com/runpane-cli-contract.json관련 문서
- runpane CLI 문서 — 전체 레퍼런스
- runpane CLI 소개 — Pane이 CLI를 만든 이유
- MCP란? — CLI를 보완하는 프로토콜
- 에이전트를 가리지 않는다는 건? — CLI가 이를 가능하게 하는 이유
마지막 업데이트 2026년 6월 24일