당신의 에이전트는 모델이 아니다: 하네스 대 추론 서비스 설명
사람들은 종종 Claude를 하나의 개체처럼 이야기하지만, AI 에이전트는 서로 다른 세 가지 계층으로 이루어진 스택입니다. 이 차이를 알면 디버깅 시간을 몇 시간씩 절약할 수 있습니다. 문제가 발생했을 때 모델, 서비스, 또는 주변 로직 중 무엇을 탓해야 할지 알아야 하기 때문입니다.
세 가지 계층
- 모델 — 입력 토큰을 출력 토큰으로 변환하는 수학적 함수입니다. 예: Sonnet, Opus, Gemini.
- 추론 서비스 — 모델을 실행하고 사용량을 추적하는 호스팅 서비스입니다. 예: AWS Bedrock, Anthropic의 API.
- 하네스 — 입력을 형성하고 출력을 해석하며 외부 세계와 상호작용하는 로직입니다. 여기에는 MCP와 Skills가 포함되며, 모델은 이를 본질적으로 알지 못합니다.
종합하면, 에이전트 시스템은 모델을 실행하는 추론 서비스를 호출하는 하네스입니다. 그게 전부입니다.
실제 사례 분석
| 에이전트 시스템 | 하네스 | 추론 서비스 | 모델 |
|---|---|---|---|
| Claude Desktop | UI + MCP + 로컬 로직 | Anthropic의 추론 서비스 | Sonnet / Opus / Haiku |
| Claude CLI | 도구 파싱 + 파일 I/O | Anthropic의 추론 서비스 | Sonnet / Opus / Haiku |
| Cursor | 컨텍스트 어셈블리 + 도구 라우팅 | Cursor의 추론 계층 | Sonnet / GPT / Gemini |
| 커스텀 LangChain 에이전트 | 프롬프트 템플릿 + 도구 정의 | Bedrock, OpenAI 등 | 선택한 모델 |
같은 모델(예: Sonnet)도 하네스에 따라 다르게 동작할 수 있습니다. 하네스가 입력을 형성하고 출력을 해석하기 때문입니다. 그래서 Claude CLI에서는 잘 작동하는 프롬프트가 Cursor에서는 작동하지 않을 수 있습니다.
이 멘탈 모델로 디버깅하기
- 잘못된 답변? 하네스를 살펴보세요. 충분한 컨텍스트를 제공하지 않을 수 있습니다.
- 너무 느리거나 비용이 많이 드나요? 추론 서비스를 확인하세요. 가격과 성능은 여기에 있습니다.
- 예상치 못한 출력? 모델이 잘못된 것인지, 아니면 하네스가 잘못된 입력을 주는 것인지 확인하세요.
이 기사는 또한 모델이 더 똑똑해짐에 따라 일부 하네스 로직(예: MCP 또는 Skills)이 쓸모없어질 수 있다고 지적합니다. 따라서 지금 하네스를 구축하는 방식은 오래 가지 않을 수 있습니다.
다음에 "내 모델이 X를 했어"라고 말할 때, 잠시 멈추고 물어보세요: 그것이 모델 때문인지, 아니면 그것을 조정하는 하네스 때문인지?
📖 전체 원문 읽기: HN AI Agents
👀 See Also

은하수를 여행하는 에이전트 AI를 위한 안내서 — 전체 개요
LLM 작동 원리, RL 학습, 추론, RAG 메모리, 멀티 에이전트 시스템, MCP 및 Skills 같은 도구를 다루는 종합적인 Reddit 게시물입니다. 전체 논문 링크 포함.

OpenClaw에서 Gemini CLI write_file을 찾을 수 없음 문제 해결: 두 가지 수정 필요
OpenClaw 에이전트가 google-gemini-cli를 사용할 때 잘못된 tools.profile과 서브프로세스의 --approval-mode auto_edit 플래그 누락으로 인해 파일을 쓸 수 없습니다(write_file / default_api_write_file 없음). 해결 방법: 프로필을 full로 설정하고 cliBackends 설정을 통해 플래그를 주입합니다.

OpenClaw의 게이트웨이와 스킬: 채팅을 넘어 자동화된 실행으로 나아가기
OpenClaw의 게이트웨이는 Telegram과 WhatsApp과 같은 채널을 실제 세계의 작업을 실행하는 스킬에 연결합니다. 이러한 작업에는 테스트 실행, API 호출, 파일 관리 등이 포함되며, cron 작업을 통해 예약된 백그라운드 자동화가 가능합니다.

OpenClaw와 WhatsApp Cloud API 통합
한 개발자가 Meta의 공식 클라우드 API를 사용하여 OpenClaw가 WhatsApp과 직접 통신하도록 설정했으며, 이 설정 과정을 문서화하여 다른 사람들이 흩어진 문서를 피할 수 있도록 도왔습니다.