Claude Code 종료 후의 개발 환경: Hermes Agent로 AI 에이전트를 통합 관리하기

2026년 6월 25일, Anthropic은 Claude Code 서비스를 완전히 종료했습니다. 개발 워크플로우의 핵심으로 Claude Code를 이용하던 현장에서는 갑작스러운 종료 통지를 받고 대안 선정에 분주하게 움직이고 있습니다. 저 자신도 2022년부터 개인 사업인 '코바야시 WEB 시스템'으로서 제조업의 DX(Digital Transformation) 안건에 종사하며, Claude Code나 Cursor와 같은 AI 코딩 지원 도구를 일상적으로 이용해 왔습니다. 이번 종료는 개발 환경의 재구축을 강요받는 큰 전환점이 되었습니다.

하지만 '단순히 다른 도구로 갈아타는 것'만으로는 동일한 문제가 재발합니다. 여러 AI 에이전트를 일원 관리하고, 프로젝트마다 최적의 플로우를 표준화하는 것——이 과제를 해결하기 위해, 저는 Hermes Agent를 핵심으로 한 통합 환경을 구축했습니다. 본 기사에서는 그 구체적인 구성과 효과를 소개합니다.

1. 왜 '통합 관리'가 필요한가

Claude Code를 사용할 수 없게 된 지금, 개발자에게는 몇 가지 선택지가 있습니다:

• OpenAI Codex CLI (무상 제공이 시작됨)
• Cursor (IDE 통합형)
• OpenCode, Gemini CLI 등

각각 장점이 있지만, 프로젝트의 종류나 팀의 체제에 따라 '어떤 도구를 사용할지'는 빈번하게 바뀝니다. 저의 경우, 다음과 같은 상황에서 구분하여 사용하고 있었습니다:

• 기간 시스템의 개수: Claude Code (대규모 변경의 안전성)
• 랜딩 페이지 제작: Cursor (고속 프로토타이핑)
• 일상 업무 자동화: OpenCode (커스터마이징의 자유도)

문제는 이 '전환 비용'과 '설정의 중복'이었습니다. 각 도구의 설정 파일, 프롬프트, 인증 정보를 개별적으로 관리하는 것은 비효율적이며, 팀 멤버가 서로 다른 도구를 사용할 경우 통일하기도 어렵습니다.

2. Hermes Agent를 통한 통합 아키텍처

Hermes Agent는 Claude Code, Codex, Cursor, OpenCode, Gemini CLI 등 여러 AI 에이전트를 단일 런타임(Runtime)에서 관리하는 오픈 소스 도구입니다. 최대 특징은 **스킬 번들 (Skill Bundle)**이라는 메커니즘을 통해 개발 플로우를 패키지화할 수 있다는 점에 있습니다.

2.1 스킬 번들로 플로우를 표준화하기

Hermes Agent의 스킬 시스템은 프로그레시브 디스클로저 (Progressive Disclosure) 방식을 채택하고 있습니다. 필요할 때만 지식 문서를 읽어들이기 때문에, 토큰 소비를 억제하면서도 다양한 태스크에 특화된 지시를 제공할 수 있습니다.

스킬 번들은 여러 스킬을 하나의 슬래시 명령어로 묶은 YAML 파일입니다. 예를 들어, 백엔드 기능 개발 플로우를 다음과 같이 정의할 수 있습니다.

name: backend-dev
description: 백엔드 기능 개발 — 리뷰, 테스트, PR 워크플로우
skills:
...

이 번들을 /backend-dev 명령어로 등록해 두면, 개발자는 여러 스킬을 개별적으로 호출할 필요 없이 하나의 명령어로 일련의 플로우를 실행할 수 있습니다.

2.2 x1lite 상의 Docker 환경

저는 개발·검증 환경으로서 Beelink의 미니 PC (x1lite)에 Ubuntu 24.04를 설치하고, Docker Compose로 여러 서비스를 일원 관리하고 있습니다. Hermes Agent는 Docker 컨테이너 상에서 상주 실행되고 있으며, 다음과 같은 구성으로 동작하고 있습니다.

services:
  hermes-agent:
    image: hermes-agent:latest
...

포인트는 모든 컨테이너를 동일한 호스트 내에서 완결시키고, 외부 API에 의존하지 않는 로컬 퍼스트 (Local-first) 설계에 있습니다. 이를 통해 개발 시의 레이턴시 (Latency)를 억제하면서 기밀 정보의 유출 리스크를 최소한으로 줄이고 있습니다.

3. Claude Code 종료 후의 이행 플로우

2026년 6월 25일의 종료를 받아들여, 저는 Claude Code에서 Hermes Agent를 경유한 Codex CLI로의 이행을 완료했습니다. 이행의 포인트는 다음 3가지입니다.

• 기술 재사용 (Skill Reuse): 기존 Claude Code용으로 작성한 프롬프트나 워크플로우를 Hermes Agent의 스킬 (Skill)로 재등록
• 번들화 (Bundling): 자주 사용하는 스킬의 조합을 번들화하여 개발자의 부담을 경감
• 폴백 메커니즘 (Fallback Mechanism): Codex CLI를 사용할 수 없는 경우, OpenCode나 Gemini CLI로 자동 폴백 (Fallback) 하는 스킬을 등록

예를 들어, 테스트 주도 개발 (TDD) 스킬 번들은 backend-dev 번들에 포함되어 있습니다. 이 스킬에는 다음과 같은 설정이 포함되어 있습니다.

metadata:
hermes:
fallback_for_toolsets: [web] # web 툴셋을 사용할 수 없을 때 표시
...

이를 통해 개발 환경이 바뀌더라도 동일한 명령어로 동일한 플로우를 실행할 수 있습니다.

4. 토큰 효율 및 비용 절감

Hermes Agent의 점진적 공개 (Progressive Disclosure)와 스킬 번들을 통해 불필요한 컨텍스트 (Context) 로딩을 줄일 수 있습니다. 구체적으로는 다음과 같습니다:

• Level 0: 스킬 목록 (약 3k 토큰)
• Level 1: 스킬 상세 정보 (필요할 때만 로드)
• Level 2: 참조 파일 (특정 파일만 로드)

기존처럼 모든 프롬프트를 매번 컨텍스트에 투입하는 방식과 비교하여, 30~50%의 토큰 절감을 실현하고 있습니다. 이는 한 달에 수십 시간 동안 개발에 AI를 사용하는 저의 경우, 월간 API 이용료를 1만 엔 이상 절감하는 효과가 있습니다.

5. 요약: AI 에이전트의 "선택의 자유"를 되찾다

Claude Code의 종료는 충격적이었지만, 이를 단일 도구에 대한 의존도를 낮추는 계기로 삼을 수도 있습니다. Hermes Agent를 사용한 통합 관리를 통해 다음과 같은 이점을 얻을 수 있습니다:

• 도구 전환이 용이 (번들을 변경하기만 하면 됨)
• 프로젝트별로 최적화된 플로우 공유 가능
• 로컬 환경에서 완결되므로 비용과 프라이버시를 동시에 확보

중소 제조 기업의 DX 지원을 수행하는 Kobayashi Web System에서는 이러한 AI 에이전트 통합 관리를 클라이언트의 개발 환경에도 도입하고 있습니다. "어떤 AI 도구를 사용해야 할지 모르겠다", "개발 플로우가 개인의 역량에 의존(속인화)되어 있다"와 같은 과제를 안고 계신 분들은 꼭 상담해 주시기 바랍니다.

Kobayashi Web System은 제조업의 DX, 웹 제작, 서버 구축, AI 활용을 일관되게 지원합니다.

먼저 편하게 상담해 주세요.

Discussion