터미널 안에 에이전트가 산다

AI CLI는 "터미널 속 챗봇" 이 아냐

Claude Code, Codex CLI, Gemini CLI 처음 켜면 표면은 챗봇처럼 보여 — 입력하면 답해. 그 프레임이 웹 Claude/ChatGPT 에서 넘어온 사람들이 가장 많이 헷갈리는 부분이야. AI CLI 는 다른 카테고리의 도구야. 진짜 파일에 read 권한, 진짜 디스크에 write 권한, 진짜 셸에 열린 채널을 가진 에이전트지. 채팅창은 그중 제일 작은 부분이고.

핵심 멘탈 모델: 대화를 들고 있는 long-running 프로세스가 있고, 그 대화가 도구 호출을 spawn 할 수 있어. 도구 호출은 전부 네 머신에 실제로 떨어져 — 파일 read, edit, git status, npm test. 모델이 어떤 도구를 쓸지 결정하고, 너는 어떤 도구를 허용할지 결정해. 그 권한 경계가 모든 설계의 중심이고, 이 퀘스트의 모든 CLI 에서 같은 경계가 반복돼.

그러면 prompt 모양도 바뀌어. 챗에서는 질문을 하지. 에이전트한테는 목표를 주고 일하게 둬. "package.json 읽고, src/ 의 import 문에서 안 쓰이는 devDependency 찾아서 제거해" 한 prompt 야 — 에이전트가 read, grep, edit, npm test 까지 돌려서 검증해. 세 prompt 가 아니야. 검증 루프 포함된 한 자율 작업이지.

Code

Same prompt, two completely different tools·bash

# Web chat — text in, text out, you copy-paste the result
# (works on any device, no file access)

# AI CLI — same prompt, but it actually runs:
claude "find unused devDependencies in package.json and remove them"
# Reads: package.json
# Greps: import statements across src/
# Edits: package.json
# Runs:  npm install && npm test
# Reports: which deps were removed and whether tests still pass

The agent loop, conceptually·text

[user]    "fix the failing auth test"
[model]   reads tests/auth.spec.ts          ← tool call 1
[model]   reads src/auth.ts                 ← tool call 2
[model]   runs npm test -- auth             ← tool call 3
[model]   sees the failure, edits src/auth  ← tool call 4
[model]   runs npm test -- auth again       ← tool call 5
[model]   "fixed: bcrypt salt rounds were 0"

터미널 안에 에이전트가 산다

AI CLI는 "터미널 속 챗봇" 이 아냐

Code

External links

Exercise

Progress

댓글 0