AI & 코딩

코딩 없이 완성하는 나만의 자율형 AI: Hermes AI 클로드 코워크(Claude Cowork) 설치 및 세팅 완벽 가이드

디지털가드너 (Digital Gardener) 2026. 7. 4. 13:22

최근 인공지능 업계의 가장 뜨거운 화두는 단연 '자율형 AI 에이전트(Autonomous AI Agent)'입니다. 단순한 질의응답을 넘어, 사용자 대신 계획을 세우고 코드를 작성하며 문서를 요약하는 등 실질적인 업무를 수행하는 개인 비서의 역할을 하고 있습니다. 그중에서도 Hermes AI(Hermes Agent)는 복잡한 파이썬이나 자바스크립트 코드 대신, 우리가 일상적으로 사용하는 언어(자연어)와 마크다운(Markdown) 문서만으로 봇의 성격과 행동 지침을 정의할 수 있는 매우 직관적이고 강력한 프레임워크입니다.

하지만 아무리 직관적인 프레임워크라도 초기 환경을 설정하고 폴더를 구성하며 필수 패키지를 설치하는 과정은 비개발자에게 높은 진입장벽으로 다가옵니다. 이때 구원투수처럼 등장하는 것이 바로 클로드 코워크(Claude Cowork)입니다. 클로드 코워크는 사용자의 PC 로컬 폴더에 직접 접근하여 파일을 읽고 쓸 수 있는 기능을 제공합니다. 즉, AI에게 "여기에 Hermes AI를 설치해 줘"라고 말하기만 하면, AI가 스스로 코드를 짜고 폴더를 만들어 완벽한 실행 환경을 구축해 내는 것입니다.

이 글에서는 개발 지식이 전혀 없어도 클로드 코워크를 활용해 Hermes AI를 내 PC에 설치하고, 나만의 맞춤형 에이전트로 세팅하는 모든 과정을 상세하게 안내합니다.

1. 성공적인 설치를 위한 필수 준비물

본격적인 설치에 앞서 몇 가지 준비가 필요합니다. 환경을 완벽하게 갖추어 두면 이후의 과정은 클로드가 모두 알아서 처리합니다.

  • 클로드 데스크톱 앱 (Claude Desktop App): 코워크(로컬 파일 시스템 접근) 기능은 웹 브라우저가 아닌 데스크톱 애플리케이션에서만 동작합니다. 공식 홈페이지에서 앱을 다운로드하여 설치하고, 해당 기능을 지원하는 유료 플랜(Claude Pro 등) 계정으로 로그인해야 합니다.
  • 독립된 작업 폴더: 바탕화면이나 문서 폴더 등 접근하기 쉬운 곳에 Hermes_Agent_Project와 같이 영문으로 된 빈 폴더를 하나 생성합니다. 이 폴더가 에이전트가 살아 숨 쉴 '집'이 됩니다.
  • LLM API Key: Hermes AI가 뇌 역할을 하기 위해 사용할 AI 모델의 API 키가 필요합니다. 앤스로픽(Anthropic)의 Claude API, 오픈AI(OpenAI), 혹은 딥시크(DeepSeek) 등 원하는 모델의 API 키를 발급받아 메모장에 임시로 저장해 둡니다.

2. 클로드 코워크에 작업 공간 권한 부여하기

준비가 완료되었다면 가장 먼저 클로드 코워크가 내 PC의 특정 폴더에서 작업할 수 있도록 허락해 주어야 합니다. 보안상 매우 중요한 단계입니다.

  1. 설치된 Claude Desktop 앱을 실행합니다.
  2. 입력창 하단 또는 메뉴에 위치한 Cowork(혹은 폴더/로컬 연결) 아이콘을 클릭합니다.
  3. 폴더 선택 창이 나타나면, 앞서 만들어둔 Hermes_Agent_Project 빈 폴더를 선택합니다.
  4. 이제 클로드는 이 특정 폴더 안에서 자유롭게 텍스트 문서를 만들고, 코드를 작성하며, 폴더 구조를 생성할 수 있는 권한을 얻게 되었습니다. (주의: 드라이브 전체 권한을 주는 것은 보안상 권장하지 않으며, 반드시 해당 프로젝트 폴더만 지정해야 합니다.)

3. 프롬프트 엔지니어링: AI에게 완벽한 지시 내리기

이제 빈 폴더를 바라보고 있는 클로드에게 Hermes AI의 뼈대를 만들어 달라고 지시할 차례입니다. 여기서 핵심은 '얼마나 구체적으로 지시하느냐'입니다. 대충 "설치해 줘"라고 하기보다는, Hermes의 핵심 구조를 짚어주며 프롬프트를 작성하는 것이 완벽한 결과물을 얻는 비결입니다.

클로드 대화창에 아래와 같은 형식으로 프롬프트를 입력합니다.

"현재 연결된 폴더에 자연어 기반의 프레임워크인 Hermes Agent 초기 실행 환경을 완벽하게 세팅해 줘.

  1. 먼저 실행에 필요한 패키지 파일(예: Python 기반이라면 requirements.txt, Node.js 기반이라면 package.json)을 생성해 줘.
  2. API 키를 담을 수 있는 .env 파일의 템플릿을 만들어 줘.
  3. 가장 중요한 Hermes의 3대 핵심 마크다운 파일인 SOUL.md, AGENTS.md, MEMORY.md의 초안을 작성해 줘.
  4. 나는 이 에이전트를 '매일 아침 글로벌 경제 뉴스를 수집하고 한국어로 요약하여 리포트를 작성하는 금융 비서' 용도로 사용할 계획이야. 이 목적에 맞게 3대 마크다운 파일의 내용을 채워줘."

이렇게 입력하고 엔터를 누르면, 마치 마법처럼 클로드 코워크가 폴더 안에 파일들을 차례대로 생성해 나가는 과정을 실시간으로 지켜볼 수 있습니다.

4. Hermes AI의 심장: 3대 마크다운 파일 완벽 해부

클로드 코워크가 파일 생성을 마쳤다면, 이제 폴더 안으로 들어가 생성된 파일들을 확인하고 내 입맛에 맞게 수정할 차례입니다. Hermes AI는 코딩이 아닌 이 3개의 마크다운 파일로 작동하므로, 각 파일의 역할을 정확히 이해하는 것이 필수적입니다. 일반적인 텍스트 편집기나 VS Code 등으로 열어 확인할 수 있으며, 물론 코워크 대화창에서 클로드에게 수정을 지시할 수도 있습니다.

A. SOUL.md (에이전트의 영혼과 자아)

이 파일은 AI 에이전트의 성격, 말투, 가치관, 그리고 근본적인 페르소나를 정의합니다.

  • 작성 팁: "너는 10년 차 월스트리트 애널리스트야. 매우 객관적이고 냉철한 어조로 말하며, 추측성 정보는 배제하고 오직 사실과 데이터에 기반해서만 답변해야 해."와 같이 구체적인 역할극을 부여합니다. 이 파일이 잘 작성되어야 봇이 엉뚱한 대답을 하는 환각(Hallucination) 현상을 막을 수 있습니다.

B. AGENTS.md (에이전트의 업무 매뉴얼)

에이전트가 실제로 수행해야 할 단계별 업무 지침서입니다. 인간 신입사원에게 업무 매뉴얼을 주듯 상세히 적어야 합니다.

  • 작성 팁:
    1. 1단계: 블룸버그, 로이터 등 주요 금융 사이트의 최신 헤드라인을 수집한다.
    2. 2단계: 수집된 뉴스 중 '금리 인상', '인플레이션' 키워드가 포함된 기사만 필터링한다.
    3. 3단계: 필터링된 기사를 3줄 이내의 한국어로 요약하고, 불릿 포인트 형태의 마크다운 리포트로 출력한다. 이처럼 논리적인 순서(Step-by-step)로 작성해야 Hermes가 길을 잃지 않고 임무를 완수합니다.

C. MEMORY.md (에이전트의 기억과 규칙)

이 파일은 에이전트가 작업을 수행하면서 반드시 지켜야 할 제약 조건이나, 과거의 피드백을 기억하는 장소입니다. Hermes는 스스로 이 파일을 수정하며 학습(Self-Reflection)할 수 있는 능력이 있습니다.

  • 작성 팁: "모든 결과물은 반드시 한국어로 출력할 것", "특정 언론사의 정치적 편향성이 담긴 칼럼은 배제할 것"과 같은 절대적인 규칙(Rule)을 명시해 둡니다.

5. 환경 변수 설정 및 최종 실행

마크다운 파일 세팅이 끝났다면, 에이전트가 작동할 수 있도록 생명력을 불어넣을 차례입니다.

API 키 연동 (.env 설정)

클로드가 만들어둔 .env (또는 .env.example을 복사하여 .env로 이름 변경) 파일을 엽니다. 파일 안에는 봇이 사용할 API 키를 입력하는 공간이 마련되어 있습니다.

Plaintext
 
CLAUDE_API_KEY=sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxx

앞서 준비해 둔 본인의 실제 API 키를 = 뒤에 따옴표 없이 빈칸 없이 붙여넣고 저장합니다. 이 키는 로컬 PC에만 저장되므로 안전합니다.

실행 명령어 입력

모든 준비가 끝났습니다. 이제 다시 클로드 코워크 대화창으로 돌아가 이렇게 묻습니다.

"모든 세팅과 API 키 입력이 끝났어. 이제 이 폴더에서 Hermes Agent를 구동하려면 터미널에 어떤 명령어를 입력해야 하는지 알려줘."

클로드는 현재 구성된 환경(Python 기반인지, Node.js 기반인지)을 파악하여 알맞은 명령어를 제시해 줄 것입니다. (예: pip install -r requirements.txt 후 python main.py 실행 등). 데스크톱에 내장된 터미널(명령 프롬프트, PowerShell, 또는 Mac의 Terminal)을 열고 해당 폴더 경로로 이동한 뒤, 안내받은 명령어를 그대로 복사해서 붙여넣고 실행합니다.

6. 에러 발생 시의 현명한 대처법 (트러블슈팅)

에이전트를 실행하다 보면 빨간색 글씨로 에러 메시지가 뜨며 멈추는 경우가 발생할 수 있습니다. 패키지 버전 충돌, 오타, 환경 변수 누락 등 원인은 다양합니다. 하지만 개발 지식이 없더라도 전혀 당황할 필요가 없습니다. 우리에게는 코워크가 있기 때문입니다.

에러가 발생하면 터미널에 출력된 에러 메시지를 마우스로 드래그하여 복사합니다. 그리고 클로드 코워크 대화창에 다음과 같이 붙여넣습니다.

"실행하려고 하니까 터미널에서 이런 에러 메시지가 떴어: [복사한 에러 메시지 붙여넣기]. 원인이 무엇인지 파악하고, 내 폴더에 있는 코드를 직접 수정해서 문제를 해결해 줘."

코워크는 로컬 파일에 접근할 수 있는 권한이 있으므로, 에러 메시지를 분석한 뒤 문제가 발생한 파이썬 스크립트나 환경 설정 파일을 스스로 열어서 수정한 뒤 저장까지 완료해 줍니다. "수정 완료했습니다. 다시 실행해 보세요"라는 답변이 오면, 아까 입력했던 실행 명령어를 다시 입력하기만 하면 됩니다. 이 과정은 완벽하게 작동할 때까지 무한 반복할 수 있는 최고의 디버깅 방식입니다.

7. 한 걸음 더: MCP(Model Context Protocol) 커넥터 활용

Hermes AI를 단독으로 실행하여 결과물을 얻는 것도 훌륭하지만, 최근 각광받는 MCP(Model Context Protocol) 기술을 활용하면 그 잠재력을 극한으로 끌어올릴 수 있습니다. MCP는 서로 다른 AI 도구와 로컬 데이터 소스들을 표준화된 규격으로 연결해 주는 기술입니다.

클로드 코워크에게 다음과 같이 요청해 봅니다.

"내가 방금 세팅한 이 Hermes Agent를 MCP 서버 형태로 실행해서, 내 클로드 데스크톱 앱과 실시간으로 연동되게 만들어 줘."

이 세팅이 완료되면, 별도의 터미널 창에서 Hermes를 실행할 필요 없이 평소 사용하는 클로드 앱 대화창 안에서 "Hermes야, 오늘 금융 리포트 작성해서 나한테 보여줘"라고 자연스럽게 지시할 수 있게 됩니다. 클로드의 압도적인 추론 능력과 Hermes의 자율적이고 체계적인 업무 수행 능력이 하나로 결합되어, 내 컴퓨터 안에 완벽히 통제 가능한 '초지능 비서 팀'을 꾸리게 되는 것입니다.

단순한 챗봇을 넘어, 나만의 업무 프로세스를 완벽하게 이해하고 자동으로 문서를 생성하며 학습하는 자율형 AI의 세계. 클로드 코워크와 Hermes AI의 결합을 통해 지금 바로 그 혁신적인 생산성의 차이를 경험해 보시길 바랍니다.

저작자표시 비영리 변경금지 (새창열림)