과거의 AI 코딩 보조 도구가 프롬프트를 입력하고 결과 코드를 복사,붙여넣는 단발성 챗 인터페이스에 가까웠다면, 최근의 “AI 코딩 에이전트” 는 모델을 중심으로 파일 시스템, 터미널, 브라우저, 테스트 러너, 버전 관리 시스템, 외부 API가 결합된 하나의 실행 환경으로 발전하고 있습니다.
이제 AI 코딩 에이전트는 단순히 코드를 생성하는 도구가 아니라, 요구사항을 분석하고 작업을 작은 단위로 나누며, 필요한 파일을 읽고 수정하고, 테스트와 린트를 실행하고, 실패 로그를 바탕으로 다시 수정하는 반복형 워크플로 엔진에 가까워지고 있습니다.
하지만 이러한 자율성은 모델 자체의 지능만으로 만들어지지 않습니다.
실제 성능은 모델을 둘러싼 하네스, 도구 연결 방식, 권한 정책, 메모리, 스킬 시스템, 평가 루프, 관측 가능성에 크게 좌우됩니다.
같은 LLM을 사용하더라도 어떤 하네스를 입히느냐에 따라 에이전트의 안정성, 재현성, 보안성, 작업 완성도는 크게 달라집니다.
이 wiki는 AI 코딩 에이전트를 단순한 “LLM 앱”이 아니라, 모델과 하네스가 결합된 실행 시스템으로 바라봅니다.
특히 AI 하네스, Skills, MCP, 런타임 에이전트, 그리고 Hermes Agent 같은 실제 구현체를 중심으로 AI 코딩 에이전트가 어떻게 동작하고, 어떻게 설계/운영되어야 하는지 정리합니다.
해당 wiki가 다루는 범위 #
1. AI 하네스 #
아무리 강력한 LLM이라도 외부 세계와 연결될 통로가 없다면 고립된 추론 엔진에 머뭅니다.
하네스는 모델을 감싸고 있는 소프트웨어 인프라 전체를 의미합니다.
이 파트에서는 다음 내용을 다룹니다.
- AI 하네스란 무엇인가
- AI 코딩 에이전트의 5대 구성요소
- Claude Code 사용하기
- CLAUDE.md 작성법
- settings.json으로 권한과 실행 환경 제어하기
- Skills와 Memory
- Claude Code Skill 만들기
- Skill을 Plugin으로 배포하기
- Hooks로 안전한 자동화 만들기
2. 유용한 Skills & MCP #
AI 코딩 에이전트가 안정적으로 일하려면 단순히 도구가 많아서는 부족합니다.
어떤 순서로 작업하고, 어떤 기준으로 성공을 판단하며, 실패했을 때 어떻게 복구할지에 대한 절차적 지식이 필요합니다.
이것이 Skill의 역할입니다.
반면 MCP는 에이전트가 외부 시스템과 연결되는 표준 인터페이스입니다.
파일 시스템, 데이터베이스, 브라우저, 검색, 사내 문서, CI/CD 파이프라인 같은 외부 도구를 에이전트가 일관된 방식으로 사용할 수 있게 해줍니다.
이 파트에서는 다음 내용을 다룹니다.
- 작성 예정
3. Hermes Agent #
Hermes Agent는 CLI와 메시징 게이트웨이를 함께 제공하는 오픈소스 런타임 에이전트입니다.
터미널에서 직접 사용할 수도 있고, Telegram, Slack, Discord 같은 메시징 플랫폼과 연결해 원격 에이전트처럼 운영할 수도 있습니다.
이 파트에서는 Hermes Agent를 실제 운영 가능한 에이전트 런타임의 사례로 다룹니다.
- 작성 예정
