Pydantic AI? Codex CLI? LangChain? 머리 아픈 AI 에이전트 생태계, 이 글 하나로 영구 종결합니다

by

최근 개발자 커뮤니티나 테크 뉴스를 보면 하루가 멀다 하고 새로운 AI 에이전트 도구들이 쏟아져 나옵니다.

“오픈AI 코덱스(Codex)가 업데이트됐다”, “이제는 랭체인(LangChain) 대신 Pydantic AI를 써야 한다”, “클로드 코드가 알아서 코딩을 다 해준다” 등등… 쏟아지는 정보 속에서 이런 생각 해보신 적 없으신가요?

“그래서 도대체 내 프로젝트엔 뭘 설치해서 써야 하는 건데?”

사실 많은 분들이 ‘내가 당장 터미널에 띄워놓고 쓸 코딩 비서(통합 CLI 에이전트)’와 ‘내 서비스에 자율적인 AI 기능을 부여하기 위해 기반으로 삼는 개발 뼈대(프레임워크/SDK)‘를 혼동하고 계십니다.

목적과 추상화 수준이 완전히 다른 도구들인데도 이름에 ‘AI’나 ‘에이전트’가 공통으로 붙어있다 보니 머리가 아파지는 것이죠.

만약 단순한 버그 수정이나 다중 파일 리팩토링을 원하는데 무턱대고 복잡한 에이전트 구축 프레임워크를 공부하고 있거나, 반대로 타입 안전성이 보장된 사내 맞춤형 AI 시스템을 구축해야 하는데 단순한 터미널 비서를 쥐고 씨름하고 있다면 엄청난 시간 낭비를 하고 있는 셈입니다.

그래서 준비했습니다. 더 이상의 구글링은 필요 없습니다. 여러분의 아까운 시간을 지켜드리기 위해, 현재 가장 주목받는 AI 에이전트 생태계를 ‘내가 바로 쓸 툴(CLI)‘과 ‘내가 개발할 때 쓸 툴(프레임워크)‘로 명확히 나누어 완벽하게 해부해 드리겠습니다.

AI Agent 환경의 개념적 분류

인프라 프레임워크 및 프로그래밍 방식 SDK

Pydantic AI, Google ADK(Agent Development Kit) 및 Claude Agent SDK와 같은 프레임워크는 맞춤형 에이전트 애플리케이션을 구축하기 위한 기본 계층 역할을 합니다.

이러한 도구는 개발자에게 상태 관리, 도구 오케스트레이션 및 타입 안전 데이터 검증을 처리하는 데 필요한 기본 요소를 제공합니다.

이들은 독립형 제품이 아니라 기존 소프트웨어 스택에 통합되어 자율적인 기능을 부여하는 라이브러리입니다.

통합 CLI 에이전트 및 터미널 어시스턴트

Claude Code, Gemini CLI 및 OpenAI Codex CLI는 “에이전트 어시스턴트” 범주를 나타냅니다. 이들은 개발자가 터미널에서 직접 사용할 수 있도록 설계된 바로 사용 가능한 명령줄 인터페이스(CLI) 도구입니다.

이 도구들은 로컬 파일 시스템, 셸 환경 및 버전 관리 시스템에 직접 접근할 수 있어 단순한 버그 수정부터 복잡한 아키텍처 리팩토링에 이르는 작업을 수행할 수 있습니다.

그래픽 오케스트레이션 및 데스크톱 환경

Claude Desktop은 CLI 에이전트의 강력한 성능과 그래픽 사용자 인터페이스(GUI)의 직관적인 특성 사이의 가교 역할을 합니다.

이 도구는 에이전트 진행 상황을 모니터링하고, 나란히 비교하는 방식(side-by-side diffs)을 통해 코드 변경 사항을 검토하며, 샌드박스 또는 클라우드 환경에서 장기 실행 작업을 관리하기 위한 시각적 계층을 제공합니다.

범주기술주요 초점주요 언어생태계 통합
프레임워크/SDKPydantic AI타입 안전 오케스트레이션Python모델 구애받지 않음
프레임워크/SDKGoogle ADK모듈식 배포Python, Go, JavaGoogle Cloud/Vertex AI
프레임워크/SDKClaude Agent SDK프로그래밍 방식 에이전트TypeScript/Node.jsAnthropic
CLI 에이전트Claude Code코드베이스 추론터미널/ShellAnthropic
CLI 에이전트Gemini CLI근거 기반 연구터미널/ShellGoogle/Gemini
CLI 에이전트OpenAI Codex CLI속도 및 자동화터미널/ShellOpenAI/GPT-5.4
GUI 환경Claude Desktop시각적 상호 작용Windows/macOSAnthropic

회사별 AI 프레이워크와 CLI 에이전트

Anthropic: Claude Agent SDK, Claude Code, Claude Desktop

Claude Agent SDK: 프로그래밍 방식 제어 및 마이그레이션

Claude Code SDK를 계승한 Claude Agent SDK는 개발자가 Claude Code와 동일한 기능을 가진 에이전트를 구축할 수 있게 해주는 프로그래밍 방식의 인터페이스입니다.

  • 특징: 일반 사용자가 실행하는 완제품 ‘프로그램’이 아니라, 개발자가 자신만의 맞춤형 자율 AI 시스템이나 에이전트를 직접 개발할 때 사용하는 코드 라이브러리(SDK)입니다.
  • 설치 방법: 개발 중인 특정 프로젝트 폴더 안에서 npm install @anthropic-ai/claude-agent-sdk 명령어를 통해 패키지로 설치합니다.

Claude Code: 터미널 기반의 자율 팀원

Claude Code는 에이전트 코딩 어시스턴트로 기능하는 CLI 도구입니다.

  • 특징: 개발자가 자신이 사용하는 터미널(명령 프롬프트, iTerm 등)에서 직접 명령어를 입력하며 코딩 작업을 자동화할 수 있는 명령줄 인터페이스(CLI) 도구입니다.
  • 설치 방법: 터미널에서 npm install -g @anthropic-ai/claude-code 명령어를 입력하거나, Homebrew, WinGet 등을 통해 시스템에 전역(global)으로 별도 설치합니다.
  • 참고사항: 데스크톱 앱과 별개로 자신의 터미널에서 직접 실행하려면 반드시 따로 설치해야 합니다

Claude Desktop: 에이전트 워크플로우 시각화

Claude Desktop은 Claude Code를 구동하는 엔진을 위한 그래픽 인터페이스를 제공합니다.

  • 특징: 터미널 환경이 익숙하지 않거나 시각적인 피드백(실시간 변경 사항 비교, 미리보기 등)을 선호하는 사용자를 위한 PC 설치형 그래픽 프로그램입니다.
  • 설치 방법: Anthropic 웹사이트에서 OS에 맞는 설치 파일(.dmg, .exe)을 다운로드하여 설치합니다.
  • 참고사항: 데스크톱 앱에는 Claude Code 엔진이 내장되어 있습니다. 따라서 데스크톱 앱 내부의 ‘Code’ 탭만 사용할 계획이라면 Node.js나 Claude Code CLI를 별도로 설치할 필요가 없습니다

Google: Google ADK 및 Gemini CLI

Google Agent Development Kit (ADK): 모듈식 오케스트레이션

Google ADK는 AI 에이전트의 개발 및 배포를 단순화하기 위해 구축된 오픈 소스 프레임워크입니다.

모델에 구애받지 않지만 Gemini 3 시리즈에 고도로 최적화되어 있으며 Vertex AI와 깊이 통합되어 있습니다.

ADK는 전통적인 소프트웨어 엔지니어링처럼 에이전트 개발을 취급하며, 에이전트 아키텍처를 구축, 관리 및 확장하기 위한 기본 요소를 제공합니다.

ADK 내의 주요 혁신은 복잡한 대화를 위한 상태 저장(stateful) 인터페이스를 제공하는 Gemini Interactions API입니다.

모든 요청에 전체 대화 기록을 전송해야 하는 표준 추론 API와 달리, Interactions API를 사용하면 개발자가 previous_interaction_id를 사용하여 상호 작용을 체인으로 연결할 수 있어 장기 작업에 대한 토큰 소비 및 대기 시간을 크게 줄일 수 있습니다.

또한 ADK는 음성 및 비디오의 양방향 스트리밍을 가능하게 하는 Gemini Live API를 지원하여 에이전트가 실시간 멀티모달 입력을 처리하고 응답할 수 있도록 합니다.

Gemini CLI: 터미널 기반 연구 및 근거

Gemini CLI는 접근성과 실시간 정보를 우선시하는 오픈 소스 터미널 에이전트입니다.

개인 개발자를 위한 넉넉한 무료 등급을 제공하며, 터미널 프롬프트에서 Gemini 모델로의 직접적인 경로를 제공합니다.

Gemini CLI의 결정적인 강점은 Google 검색 근거와의 통합입니다.

이를 통해 에이전트는 훈련 데이터에 없었던 실시간 정보, 문서 및 보안 권고 사항을 가져올 수 있습니다.

또한 Gemini CLI는 거대한 100만 토큰 컨텍스트 창을 지원하여 단일 턴에서 방대한 코드베이스나 복잡한 데이터세트를 수집하고 추론할 수 있게 해줍니다.

VS Code 사용자를 위해 Gemini CLI는 컴패니언 확장을 설치하는 “IDE 통합” 명령을 제공합니다.

이를 통해 CLI는 열려 있는 파일 및 선택한 텍스트를 컨텍스트를 인식하게 되어, IDE 내에서 기본 비교(diff) 보기 및 나란히 코드 검토를 트리거할 수 있습니다.

OpenAI : Codex와 Codex CLI

GPT-5.4 Codex: 고급 추론 및 자율성

이 모델은 추론, 코딩 및 자율 실행에 최적화되어 있으며, 기본 컴퓨터 사용 기능을 갖춘 최초의 범용 모델입니다.

  • 개념: OpenAI에서 개발한 코딩과 추론에 특화된 AI 모델 그 자체 또는 이를 활용하는 전체 서비스 생태계를 뜻합니다.
  • 특징: GPT-5.4 Codex, GPT-5.3 Codex, codex-mini 등의 구체적인 AI 모델 라인업으로 존재합니다.
  • 활용 형태: 이 ‘Codex’라는 지능은 터미널뿐만 아니라 ChatGPT 웹 인터페이스 내부의 에이전트, 전용 데스크톱 앱(Mac/Windows용), IDE(VS Code 등) 확장 프로그램 등 다양한 형태로 사용자에게 제공됩니다

Codex CLI: 스마트 터미널 어시스턴트

  • 개념: OpenAI Codex 모델의 능력을 개발자의 터미널(명령 프롬프트) 환경에서 직접 사용할 수 있도록 만들어진 오픈 소스 기반의 ‘명령줄 인터페이스(CLI) 프로그램’입니다.
  • 특징: 컴퓨터에 직접 설치해서 사용하며, 로컬 파일 시스템과 셸 환경에 접근하여 코드를 수정하거나, 자동화 루틴(skills.md 등)을 실행하고 빠른 속도로 작업을 처리하는 데 특화되어 있습니다

AI 프레임워크 비교 : Pydantic AI, Google ADK, Claude Agent SDK, LangGraph

프레임워크환경 지원주요 이점도구 통합
Pydantic AIPython 중심타입 안전성 및 내구성 있는 실행Logfire, DBOS
Google ADK멀티 플랫폼깊은 Vertex AI 시너지Live API, Search Grounding
Claude Agent SDKNode.js/TypeScriptClaude Code 도구 접근MCP Server, React Ink

에이전트 기반 AI 애플리케이션을 구축하려는 개발자를 위해 현재 가장 주목받는 4가지 주요 프레임워크의 특징과 알맞은 사용 시나리오는 아래와 같습니다.

1. Pydantic AI: 타입 안전성과 프로덕션급 신뢰성 (Python)

  • 특징: 생성형 AI 앱 개발에 “FastAPI를 사용하는 것 같은 편안함”을 제공하기 위해 설계된 모델 독립적 프레임워크입니다.
  • 장점: Python의 타입 힌트와 Pydantic 검증을 활용하여 LLM의 출력이 엄격한 데이터 스키마를 준수하도록 보장합니다. 또한 DBOS 등과 연동하여 API 장애나 서버 재시작 시에도 에이전트의 작업 진행 상황을 보존하는 ‘내구성 있는 실행(Durable execution)’을 지원합니다.
  • 추천: 구조화된 출력과 런타임 검증, 안정성이 필수적인 백엔드 시스템 구축 시.

2. Google ADK: 구글 생태계 통합과 실시간 멀티모달 (Python, TypeScript, Go, Java 등)

  • 특징: 제미나이(Gemini) 모델과 Google Cloud(Vertex AI) 생태계에 고도로 최적화된 모듈식 오픈 소스 프레임워크입니다.
  • 장점: Gemini Live API를 지원하여 지연 시간이 짧은 실시간 양방향 음성 및 비디오 스트리밍 에이전트를 쉽게 구축할 수 있습니다. 또한 ‘Interactions API’를 통해 서버 측에서 대화 상태를 관리해주어, 매번 전체 대화 기록을 전송할 필요 없이 긴 작업의 토큰 소비를 대폭 줄여줍니다.
  • 추천: GCP 인프라 위에서 실시간 음성/영상 처리 및 구글 검색 근거(Grounding)가 결합된 앱 구축 시.

3. Claude Agent SDK: 강력한 도구 제어와 자율성 (TypeScript/Node.js)

  • 특징: Anthropic의 코딩 어시스턴트인 Claude Code의 기능을 개발자가 프로그래밍 방식으로 직접 구현할 수 있게 해주는 SDK입니다.
  • 장점: 모델 컨텍스트 프로토콜(MCP)을 지원하여 Slack, Google Drive, Jira 등 외부 데이터 소스와 플러그인에 연결하기 좋습니다. 특히 안전한 샌드박스 내에서 에이전트가 직접 파이썬 코드를 작성해 도구를 오케스트레이션하는 ‘프로그래밍 방식 도구 호출(Programmatic Tool Calling)’을 통해 불필요한 컨텍스트 오염을 막고 고도의 자율성을 발휘합니다.
  • 추천: 터미널, 로컬 파일 시스템, 외부 SaaS를 직접 조작하는 고도화된 사내 맞춤형 자율 업무/코딩 시스템 구축 시.

4. LangGraph: 복잡한 오케스트레이션과 생태계

  • 특징: 여러 서브 에이전트를 조율하는 ‘딥 에이전트(Deep Agents)’ 워크플로우를 구축하는 데 널리 사용되는 프레임워크입니다.
  • 장점: 유연성이 뛰어나며, LangSmith 및 Arize 등 외부 관측성(Observability) 및 가드레일 도구와의 연동 생태계가 매우 훌륭하게 지원됩니다.
  • 단점: 도구 호출이 동기적(sync)으로 이뤄져야 하거나 네이티브 구조화된 출력 지원이 상대적으로 매끄럽지 못해 개발자가 직접 재포맷해야 하는 번거로움이 있을 수 있습니다.
  • 추천: LLM 스스로가 도구와 서브 에이전트를 유연하게 선택하는 자율성 중심 프로젝트나 강력한 모니터링 생태계 연동이 필요한 경우.

참고자료

  1. Inside Claude Code: A Deep Dive into Anthropic’s Agentic CLI Assistant – Medium, https://medium.com/@dingzhanjun/inside-claude-code-a-deep-dive-into-anthropics-agentic-cli-assistant-a4bedf3e6f08
  2. Claude Code vs. Codex vs. Gemini Code Assist: 2026 dev review – Educative.io, https://www.educative.io/blog/claude-code-vs-codex-vs-gemini-code-assist
  3. Claude Code overview – Claude Code Docs, https://code.claude.com/docs/en/overview
  4. Pydantic AI – Pydantic AI, https://ai.pydantic.dev/
  5. Overview of Agent Development Kit | Vertex AI Agent Builder – Google Cloud Documentation, https://docs.cloud.google.com/agent-builder/agent-development-kit/overview
  6. google-gemini/gemini-cli: An open-source AI agent that … – GitHub, https://github.com/google-gemini/gemini-cli
  7. @anthropic-ai/claude-agent-sdk – npm, https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk
  8. Gemini CLI – Google Cloud Documentation, https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli
  9. What’s Claude Code? : r/ClaudeAI – Reddit, https://www.reddit.com/r/ClaudeAI/comments/1ixave9/whats_claude_code/
  10. Get started with the desktop app – Claude Code Docs, https://code.claude.com/docs/en/desktop-quickstart
  11. Use Claude Code Desktop – Claude Code Docs, https://code.claude.com/docs/en/desktop
  12. Overview – Pydantic AI, https://ai.pydantic.dev/models/overview/
  13. Gemini – Agent Development Kit (ADK) – Google, https://google.github.io/adk-docs/agents/models/google-gemini/
  14. Codex changelog – OpenAI for developers, https://developers.openai.com/codex/changelog/
  15. GPT-5.4 Review: Is It Worth Leaving GPT-5.3 Codex Behind? – Turing College, https://www.turingcollege.com/blog/gpt-5-4-review-vs-gpt-5-3-codex
  16. Claude Agent SDK | Promptfoo, https://www.promptfoo.dev/docs/providers/claude-agent-sdk/
  17. Anthropic Academy: Claude API Development Guide, https://www.anthropic.com/learn/build-with-claude?use_case=ea
  18. How to Use Claude Code: A Guide to Slash Commands, Agents, Skills, and Plug-ins, https://www.producttalk.org/how-to-use-claude-code-features/
  19. Computer use tool – Claude API Docs, https://platform.claude.com/docs/en/agents-and-tools/tool-use/computer-use-tool
  20. Agent Development Kit (ADK) vs. PydanticAI Comparison – SourceForge, https://sourceforge.net/software/compare/Agent-Development-Kit-ADK-vs-PydanticAI/
  21. Building agents with the ADK and the new Interactions API – Google Developers Blog, https://developers.googleblog.com/building-agents-with-the-adk-and-the-new-interactions-api/
  22. Gemini Live API Toolkit in ADK – Agent Development Kit (ADK) – Google, https://google.github.io/adk-docs/streaming/
  23. Comparing Claude Code, OpenAI Codex, and Google Gemini CLI: Which AI Coding Assistant is Right for Your Deployment Workflow? – DeployHQ, https://www.deployhq.com/blog/comparing-claude-code-openai-codex-and-google-gemini-cli-which-ai-coding-assistant-is-right-for-your-deployment-workflow
  24. Gemini CLI vs Claude Code vs Codex: Choosing the Right AI Coding CLI – Inventive HQ, https://inventivehq.com/blog/gemini-vs-claude-vs-codex-comparison
  25. The AI Command Line War: Claude Code vs Gemini CLI vs Codex CLI – DEV Community, https://dev.to/sivasai_nadella_941a8d122/the-ai-command-line-war-claude-code-vs-gemini-cli-vs-codex-cli-4fk5
  26. Gemini CLI + VS Code: Native diffing and context-aware workflows – Google Developers Blog, https://developers.googleblog.com/gemini-cli-vs-code-native-diffing-context-aware-workflows/
  27. OpenAI’s Codex is now on Windows – The New Stack, https://thenewstack.io/openais-codex-is-now-on-windows/
  28. Codex CLI vs Gemini CLI vs Claude Code: Which is the Best? – Analytics Vidhya, https://www.analyticsvidhya.com/blog/2025/08/codex-cli-vs-gemini-cli-vs-claude-code/
  29. Agents – Pydantic AI, https://ai.pydantic.dev/agent/
  30. pydantic_ai.agent – Pydantic AI, https://ai.pydantic.dev/api/agent/
  31. Pydantic AI | DBOS Docs, https://docs.dbos.dev/integrations/pydantic-ai
  32. Introducing advanced tool use on the Claude Developer Platform – Anthropic, https://www.anthropic.com/engineering/advanced-tool-use
  33. Code execution tool – Claude API Docs, https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool
  34. Comparing Agent Frameworks: PydanticAI, LangChain 1.0 and Google ADK, https://levelup.gitconnected.com/comparing-agent-frameworks-pydanticai-langchain-1-0-and-google-adk-4d2d46d927f0
  35. Which Multi‑Agent Framework Should Run Your Enterprise AI? | by Marc Puig | Medium, https://medium.com/@mpuig/which-multi-agent-framework-should-run-your-enterprise-ai-abdc8e09ad89

Leave a Comment


This website stores cookies on your computer. These cookies are used to provide a more personalized experience and to track your whereabouts around our website in compliance with the European General Data Protection Regulation. If you decide to to opt-out of any future tracking, a cookie will be setup in your browser to remember this choice for one year.

Accept or Deny

Content

→ 목차