본문 바로가기
C.W.K.
Stream
Lesson 01 of 04 · published

터미널에서 직접 일하는 에이전트

~18 min · mental-model, agent-vs-chatbot, first-principles

Level 0🌱 입문자
0 XP0/70 lessons0/11 achievements
0/120 XP to next level120 XP to go0% complete

터미널에는 챗봇이 아니라 일하는 에이전트가 들어와

Claude Code, Codex CLI, Gemini CLI를 처음 켜면 채팅창처럼 보여. 하지만 겉모습만 보고 웹 챗과 같은 도구라고 생각하면 핵심을 놓쳐. AI CLI는 실제 파일을 읽고 고치며 셸 명령까지 실행하는 에이전트야. 대화창은 그 일을 지시하고 확인하는 작은 창구일 뿐이지.

구조는 간단해. 대화를 유지하는 프로세스가 있고, 모델은 그 안에서 필요한 도구를 골라 호출해. git status를 확인하고, 파일을 편집하고, npm test를 돌리는 일이 모두 네 컴퓨터에서 실제로 일어나. 모델이 어떤 도구를 쓸지 판단하고, 사용자는 어디까지 허용할지 정해. 그래서 권한 경계가 모든 AI CLI 설계의 중심이야.

이 구조를 알면 지시하는 법도 달라져. 질문을 여러 번 잘게 던질 필요가 없어. "package.json을 읽고 src의 import를 확인해서 쓰지 않는 devDependency를 제거한 뒤 테스트까지 해"처럼 목표와 완료 조건을 한 번에 주면 돼. 읽기, 검색, 수정, 검증은 에이전트가 한 작업 안에서 이어서 처리해.

Code

같은 요청을 받아도 웹 챗과 AI CLI는 이렇게 달라·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
에이전트가 작업을 이어 가는 기본 흐름·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"

External links

Exercise

LLM의 도움 없이 4~6줄로 답해봐. “AI CLI에 권한 체계가 왜 필요하고, 그게 없으면 무슨 일이 생길까?” 답은 ~/notes/ai-cli-mental-model.md에 저장해. 퀘스트를 마친 뒤 다시 읽어보면 생각이 얼마나 달라졌는지 보여서 재밌을 거야.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.