CLI 에이전트를 subprocess로 연결하는 aicmd

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

작성자는 앱에서 Codex나 Claude Code CLI를 하위 프로세스로 실행해 자연어 요청을 셸 명령으로 바꾸는 `aicmd` 패턴을 구현했다. 프롬프트는 표준 입력으로 전달되고 결과는 임시 파일에 저장되며, 앱은 단일 명령인지 검사한 뒤 실행을 사용자 터미널에 남긴다. 기존 CLI 인증을 활용할 수 있지만 사용자의 사전 로그인, 에이전트 콜드 스타트 지연, 불필요한 컨텍스트 유입, 복잡한 응답 파싱, 서비스 약관 문제가 한계로 남는다. `aicmd`는 Codex·Claude Code·Antigravity와 Ollama·llama.cpp·직접 API를 지원하는 오픈소스 참고 구현이다.

실용적 조언

CLI 에이전트를 래퍼에서 호출할 때는 프롬프트를 표준 입력으로 전달하고 응답을 임시 파일이나 명시적 출력 경로에 저장해 파싱 경계를 분명히 하는 편이 적절하다. 생성 결과가 단일 셸 명령인지 먼저 검증한 뒤 실행은 사용자에게 맡기면 자동 실행으로 인한 위험을 줄일 수 있다. Codex 예시처럼 읽기 전용, 임시 실행, 색상 비활성화 옵션을 조합하면 래퍼가 처리할 출력 형식을 더 일정하게 유지할 수 있다.
`claude -p`를 사용할 때 API 키가 설정되어 있는지 확인해야 한다. 키가 있으면 기존 구독이 아니라 API 과금 경로가 선택될 수 있으므로 인증 방식과 비용 경로를 실행 전에 구분해야 한다. 짧은 요청에서 콜드 스타트 지연이 문제가 되면 CLI 호출과 직접 API 또는 로컬 모델 호출을 비교하는 것이 필요하다.

섹션별 상세

작성자는 앱이 `codex exec` 또는 `claude -p`를 하위 프로세스로 실행해 자연어 요청을 셸 명령으로 바꾸는 구조를 구현했다. `printf`로 프롬프트를 표준 입력에 넣고, Codex의 `-` 옵션으로 이를 읽게 한 뒤 `-o /tmp/aicmd-command.txt`로 결과를 저장한다. 앱은 임시 파일의 응답이 단일 명령인지 검사하고, 실행 자체는 사용자의 터미널 입력 위치에 남겨 최종 통제권을 사용자에게 둔다.

bash

printf '%s' "$PROMPT" | codex exec \
  --ignore-user-config \
  --skip-git-repo-check \
  -s read-only \
  --ephemeral \
  --color never \
  -o /tmp/aicmd-command.txt \
  -

프롬프트를 표준 입력으로 Codex에 전달하고, 읽기 전용·임시 실행 옵션으로 생성된 명령을 임시 파일에 저장한다.

터미널 화면에 `aicmd`로 포트 8080의 앱을 종료하고 JavaScript 파일을 수정 시간순으로 조회하는 명령이 표시되어 있다. — Screenshot이미지는 글에서 설명한 자연어 요청과 셸 명령 사이의 변환 결과를 시각적으로 보여준다. `aicmd`가 애플리케이션 종료와 파일 목록 조회처럼 사용자가 바로 실행할 수 있는 단일 터미널 명령을 생성한다는 점이 본문의 CLI 래퍼 구조와 직접 연결된다.

Codex·Claude Code·Antigravity를 별도 대화 앱으로 재구현하지 않고 기존 CLI를 호출하는 방식은 사용자의 로그인이나 구독 인증을 그대로 활용한다. 따라서 래퍼가 별도 계정이나 인증 체계를 관리하지 않아도 되지만, 사용자가 해당 CLI에 먼저 인증되어 있어야 한다. `claude -p`는 API 키가 설정되어 있으면 사용자의 플랜 대신 API를 사용할 수 있으므로 작성자는 키를 해제해야 한다고 적었다.

이 접근은 짧은 명령을 생성하는 도구에서 에이전트 콜드 스타트로 인한 높은 지연을 일으킬 수 있다. 또한 skills, MCP, 전역 `AGENTS.md`처럼 요청에 필요하지 않은 컨텍스트가 함께 들어오고, 이미지 처리처럼 결과 형식이 복잡한 작업에서는 응답 파싱이 어려워진다. 인증 조건과 서비스 약관의 불확실성까지 포함하면, CLI 호출 래퍼는 빠른 직접 API 호출보다 단순성과 호환성에 초점을 둔 선택이다.

작성자의 오픈소스 도구 `aicmd`는 Codex, Claude Code, Antigravity뿐 아니라 로컬 Ollama·llama.cpp 모델과 직접 API 호출도 지원한다. 같은 입력·생성·검증·터미널 삽입 흐름을 여러 백엔드에 적용할 수 있어 이 패턴을 실제 코드로 확인하는 참고 구현이 된다. 다만 글에서 제시한 구체적 명령은 Codex용이며, 다른 백엔드의 결과 형식이나 실행 지연이 동일하다고 단정할 근거는 없다.

용어 해설

하위 프로세스(Subprocess): — Subprocess는 실행 중인 앱이 별도의 프로세스로 다른 프로그램을 구동하는 방식이다. 이 글에서는 앱이 Codex나 Claude Code CLI를 하위 프로세스로 실행하고, 표준 입력으로 프롬프트를 전달한 뒤 결과 파일을 읽어 후속 동작에 사용한다.
표준 입력(Standard Input): — Standard input은 프로그램이 외부에서 입력을 받는 기본 통로다. `codex exec` 명령 뒤의 `-`는 프롬프트를 파일이나 인자가 아니라 표준 입력으로 읽도록 지정하며, 래퍼 앱은 파이프로 요청 내용을 전달한다.
에이전트 콜드 스타트(Agent Cold Start): — 에이전트 콜드 스타트는 CLI 에이전트를 새로 실행할 때 초기화와 컨텍스트 로딩으로 발생하는 지연이다. 이 방식은 요청마다 Codex나 Claude Code 프로세스를 시작하므로, 짧은 명령을 즉시 생성해야 하는 도구에서 지연이 특히 커질 수 있다.
MCP: — MCP는 모델 에이전트가 외부 도구와 데이터 소스에 연결될 때 사용하는 통합 계층이다. 글에서는 전역 `AGENTS.md`, skills와 함께 CLI가 자동으로 불러오는 추가 컨텍스트로 언급되며, 단순한 명령 생성에는 불필요한 정보가 섞일 수 있다는 한계와 연결된다.

언급된 도구

Codex중립

CLI subprocess로 실행되어 자연어 프롬프트를 셸 명령으로 변환한다.

Claude Code중립

Codex와 같은 방식으로 CLI 호출과 응답 파싱에 사용된다.

Antigravity중립

aicmd에서 지원하는 CLI 기반 에이전트 백엔드다.

aicmd추천링크

자연어 요청을 셸 명령으로 바꾸고 결과를 터미널 입력 위치에 넣는 오픈소스 CLI 도구다.

언급된 리소스

튜토리얼aicmd

GitHubaicmd