Hermes Agent: 무엇이며, 설치하고 구성하는 방법

Claude Code, Codex, Cursor, OpenClaw는 각각 고유한 역할을 하는 AI 에이전트입니다. 서버에서 계속 실행되고, 세션이 바뀌어도 사용자를 기억하며, 택시를 타고 가는 동안 Telegram으로 답변해 주는 에이전트가 필요하다면 Hermes Agent가 적합합니다.

Hermes Agent는 Nous Research의 오픈 프로젝트이며, 많은 사람이 생각하는 것보다 설치하기 훨씬 쉽습니다. 이 글에서는 Hermes Agent가 무엇인지, 비용은 얼마인지, Windows, macOS 또는 Linux에 설치하는 방법, 모델과 Telegram 봇을 연결하는 방법을 살펴봅니다. 모든 내용은 공식 문서를 바탕으로 합니다.

Hermes Agent란 무엇인가요? 쉽게 설명하면#

Hermes는 Claude Code나 Codex와 같은 범주의 AI 에이전트입니다. 답변만 작성하는 것이 아니라 파일을 열고, 터미널 명령을 실행하고, 브라우저를 사용합니다. 차이는 작동 방식에 있습니다. Claude Code는 Anthropic 모델에 연결되어 있는 반면, Hermes는 Claude와 GPT부터 사용자 하드웨어에서 실행되는 로컬 모델까지 어떤 모델 제공업체와도 함께 사용할 수 있습니다.

프로젝트는 아직 젊습니다. GitHub 저장소는 2025년 7월 22일에 만들어졌습니다. 그럼에도 2026년 8월 22일 기준 별이 234,000개 이상, 포크가 47,000개에 달해 이 분야에서 가장 빠르게 성장하는 오픈 프로젝트 중 하나입니다. 코드는 MIT 라이선스로 완전히 공개되어 있으므로 로열티 없이 읽고 수정하고 제품에 사용할 수 있습니다.

이러한 ‘자기 개선’의 기반에는 스킬과 메모리라는 두 가지 메커니즘이 있습니다. 스킬은 에이전트가 복잡한 작업을 마친 뒤 기록해 두고 다음번에 적용하는 절차입니다. 메모리는 사용자와 환경에 관한 사실을 담은 파일로, 새 대화를 시작할 때마다 불러옵니다. 두 메커니즘은 아래 별도 섹션에서 다룹니다.

Hermes Agent는 Claude Code, Codex와 어떻게 다른가요?#

주요 차이를 표로 정리하면 다음과 같습니다.

표에서 핵심을 알 수 있습니다. Claude Code는 가장 강력한 모델이 필요하고 저장소에서 작업하는 경우에 적합합니다. 이 분야에서는 Anthropic이 여전히 모델과 도구의 조합 면에서 가장 뛰어납니다. Hermes는 에이전트를 ‘항상 켜 둬야’ 할 때 적합합니다. 서버에서 실행해 매일 아침 정해진 작업을 수행하고, Telegram으로 답하며, 어제의 대화를 기억합니다.

기본 도구를 비교하고 있다면 Claude Code 설치 방법, OpenAI Codex란 무엇인가, 2026년 AI 코딩 도구 현황에 관한 별도 가이드를 참고하세요.

2026년 Hermes Agent 비용은 얼마인가요?#

가장 간편한 선택지는 Hermes 개발팀의 기본 구독인 Nous Portal입니다. 300개가 넘는 모델과 웹 검색, 이미지 생성, 음성 합성, 클라우드 브라우저 같은 즉시 사용 가능한 서비스도 포함합니다. 2026년 8월 22일 기준 요금제는 다음과 같습니다.

많은 사람이 놓치는 두 번째 선택지는 새 구독에 가입할 필요가 없다는 점입니다. Hermes는 OAuth, 즉 이미 보유한 계정을 통해 로그인할 수 있습니다. ChatGPT 및 Codex 구독, Claude Max, xAI의 SuperGrok, Qwen, MiniMax, GitHub Copilot을 지원합니다. 설정에서 제공업체를 선택하고 브라우저에서 로그인을 확인하면 기존에 지불하던 금액 그대로 이용할 수 있습니다.

세 번째 선택지는 직접 보유한 API 키입니다. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba를 비롯해 약 12개의 제공업체가 있습니다. 키를 입력하면 해당 계정으로 사용량이 직접 청구됩니다.

네 번째 선택지는 금전적 비용은 없지만 하드웨어가 필요합니다. Ollama 또는 LM Studio를 통해 로컬 모델을 사용하는 방법입니다. 강력한 컴퓨터가 있고 데이터를 외부로 보내고 싶지 않다면 적합합니다. 한 가지 조건이 있습니다. 모델의 컨텍스트 창이 최소 64,000토큰이어야 합니다. 그렇지 않으면 Hermes가 해당 모델로 시작하지 않습니다. 에이전트가 긴 작업을 처리하려면 충분한 작업 메모리가 필요하기 때문입니다.

해외 서비스의 결제 조건은 여기서 다루지 않습니다. 별도의 규칙이 있는 별도 주제이며, Claude Code를 예로 든 이 가이드에서 설명합니다.

Windows에 Hermes Agent 설치하는 방법#

터미널이 낯설다면 설치 파일부터 사용하세요. hermes-agent.nousresearch.com 웹사이트에서 macOS 12+, Windows 10/11, Linux용 다운로드 버튼을 찾을 수 있습니다. 다운로드한 파일은 앱 두 개를 한꺼번에 설치합니다. hermes 명령줄 도구와 채팅, 파일, 설정을 갖춘 일반 창 형태의 Hermes Desktop입니다.

명령어 사용이 익숙하다면 PowerShell에서 설치하세요.

1. PowerShell 열기

   Win 키를 누르고 PowerShell을 입력한 다음 실행합니다. 관리자 권한은 필요하지 않습니다.

2. 설치 프로그램 실행

   iex (irm https://hermes-agent.nousresearch.com/install.ps1)
   

   스크립트가 Python 3.11, Node.js 22, uv 패키지 관리자, ripgrep, ffmpeg 등 필요한 항목을 모두 다운로드합니다. Git이 없으면 별도로 저장되고 시스템 프로그램에 영향을 주지 않는 격리된 MinGit 빌드를 설치합니다.

3. 터미널을 다시 시작하고 확인

   hermes doctor
   

   이 명령은 설치된 항목과 빠진 항목, 해결 방법을 보여 줍니다. 초록색 체크 표시가 보이면 설치가 완료된 것입니다.

이 방법으로 설치하면 파일은 %LOCALAPPDATA%\hermes에 저장됩니다. WSL2를 사용한다면 다음 섹션의 Linux 명령도 그 안에서 사용할 수 있습니다. 편한 방법을 선택하세요.

macOS와 Linux에 Hermes Agent 설치하는 방법#

노트북이나 서버 어디서든 명령 하나로 Hermes를 설치합니다. 전체 과정은 다음과 같습니다.

1. Git이 설치되어 있는지 확인

   git --version
   

   명령이 버전 번호를 반환하면 다음 단계로 넘어갑니다. Linux에서는 curl과 xz-utils도 확인하세요. Debian과 Ubuntu에서는 sudo apt install curl xz-utils로 설치합니다.

2. 설치 프로그램 실행

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
   

   스크립트는 저장소를 ~/.hermes/hermes-agent에 복제하고 가상 환경을 만든 다음 ~/.local/bin에 hermes 명령을 설치합니다. GUI와 브라우저 자동화가 필요 없는 서버에는 가벼운 옵션이 있습니다. 끝에 bash -s -- --skip-browser를 추가하세요.

3. 셸을 다시 불러오고 시작

   source ~/.zshrc   # macOS에서; Linux에서는 대개 다음을 사용: source ~/.bashrc
   hermes
   

root로 설치하면 파일은 /usr/local/lib/hermes-agent와 /usr/local/bin/hermes 같은 시스템 경로에 저장됩니다. 여러 계정이 사용하는 서버에 편리합니다. 설정, 키, 메모리는 여전히 각 사용자의 개인 ~/.hermes 폴더에 저장됩니다.

Linux용 Hermes Desktop에 관한 참고 사항입니다. Debian과 Ubuntu에서 앱을 빌드하려면 build-essential 패키지의 컴파일러가 필요합니다(sudo apt install build-essential). 명령으로 Hermes를 설치했다면 별도 설치 프로그램은 필요 없습니다. hermes desktop을 실행하면 기존 설정, 세션, 스킬을 그대로 사용해 앱이 시작됩니다.

Hermes Agent에 모델 연결하기#

모델은 Hermes의 엔진입니다. 에이전트가 스스로 생각하는 것이 아니라 사용자가 선택한 모델에 연결합니다. 따라서 설치 후 첫 단계는 연결할 대상을 선택하는 것입니다.

hermes model

설정 마법사에서 제공업체, 로그인 방식, 모델을 묻습니다. 선택지는 다양하며 주요 항목은 다음과 같습니다.

Nous Portal을 선택하면 명령 하나로 모든 설정을 처리합니다.

hermes setup --portal

브라우저에서 로그인 페이지가 열립니다. 확인을 마치면 Nous를 제공업체로 설정하고 Tool Gateway를 활성화합니다. 이 기능으로 서비스마다 별도 키를 사용하지 않고 웹 검색, 이미지 생성, 음성 합성을 이용할 수 있습니다.

Hermes는 키와 설정을 별도로 저장하므로 이 점을 처음부터 이해해야 합니다. API 키와 토큰 같은 비밀 정보는 ~/.hermes/.env에 저장됩니다. 일반 설정은 ~/.hermes/config.yaml에 있습니다. 이 파일을 직접 수정할 필요는 없습니다. hermes config set이 각 값을 올바른 파일에 자동으로 저장합니다.

Ailoot 문서에서 도구 가이드 찾기

전체 설정 마법사는 hermes setup입니다. 세 가지 모드가 있습니다. Nous Portal을 통한 빠른 설정, 제공업체와 도구를 하나씩 직접 설정하는 전체 설정, 그리고 필수 항목만 남기고 모두 비활성화해 필요한 기능만 켜는 Blank Slate입니다.

Hermes Agent가 작동하는지 확인하는 방법#

모델을 선택한 뒤 대화를 시작합니다.

hermes          # 기본 인터페이스
hermes --tui    # 마우스 지원과 팝업 창을 갖춘 최신 인터페이스

환영 배너에 선택한 모델, 활성화된 도구, 스킬이 표시됩니다. 이제 “안녕, 넌 누구야?”라고 묻는 대신 결과가 눈에 보이는 작업을 요청하세요. “디스크에서 가장 큰 폴더 다섯 개를 보여 줘” 또는 “현재 폴더를 살펴보고 기본 프로젝트 파일이 무엇인지 알려 줘”처럼 말입니다. 에이전트가 터미널 명령을 실행하고 의미 있는 답을 돌려준다면 기본 설정은 작동하는 것입니다.

마지막 확인 항목은 세션입니다. 대화를 종료한 뒤 다시 돌아오세요.

hermes --continue   # 또는 짧게: hermes -c

같은 대화가 이어져야 합니다. 이는 세션 메모리가 디스크에 기록되는지 확인합니다. 나중에 봇과 예약 작업이 이 기능에 의존합니다.

문제가 생기면 다음 순서를 따르세요. hermes doctor(일반 진단), hermes model(모델과 로그인을 다시 확인), hermes setup(설정 재구성), hermes sessions list와 hermes --continue(세션 확인), hermes gateway status(gateway 상태 확인). 이 순서를 따르면 몇 분 안에 “전부 고장 났다”는 상태에서 명확한 상황으로 돌아갈 수 있습니다.

Hermes Agent의 스킬과 메모리란 무엇인가요?#

Hermes 스킬은 이름, 설명, 단계별 절차가 담긴 SKILL.md 파일입니다. 문서 조립, pull request 열기, 메일 발송 준비 방법 등이 여기에 포함될 수 있습니다. 에이전트는 모든 스킬의 짧은 설명을 읽고 작업에 맞는 경우에만 전체 내용을 불러옵니다. 따라서 스킬 100개를 설치해도 모든 요청이 길어지지 않습니다. 표준은 agentskills.io에 공개되어 있으며, 같은 파일을 다른 에이전트에서도 사용할 수 있습니다.

스킬은 ~/.hermes/skills/ 폴더에 저장됩니다. 세 가지 방식으로 추가할 수 있습니다. 앱과 함께 기본 스킬 세트가 설치되고, 카탈로그에서 hermes skills install로 준비된 스킬을 추가할 수 있으며, 복잡한 작업을 마친 뒤 에이전트가 새 스킬을 직접 작성합니다. 각 스킬은 자동으로 슬래시 명령이 됩니다. gif-search 스킬을 설치하면 모든 채팅에서 /gif-search를 사용할 수 있습니다. 카탈로그에서 설치할 때 보안 검사를 수행해 다른 사람의 절차에 악성 명령이 포함되지 않도록 합니다.

메모리는 더 간단합니다. ~/.hermes/memories/에 파일 두 개가 있습니다. MEMORY.md는 에이전트가 환경과 결론에 관해 작성하는 메모로 최대 2,200자입니다. USER.md는 응답 방식, 선호와 비선호 등을 담은 사용자 프로필로 최대 1,375자입니다. 대화를 시작할 때마다 두 파일이 시스템 프롬프트에 추가되므로 에이전트는 사용자에 관한 정보를 알고 대화를 시작합니다. 메모리가 지나치게 늘어나지 않도록 한도는 의도적으로 엄격하게 설정되어 있으며, 무엇을 보관하고 버릴지는 에이전트가 결정합니다.

스킬과 메모리는 맥락을 기억하고 절차를 축적해 설치한 날보다 매주 눈에 띄게 더 잘 작동하는 에이전트를 만드는 데 도움이 됩니다. 스킬을 고르는 방법과 에이전트가 자료를 무작정 쌓아 두는 것을 방지하는 방법은 Claude Code를 예로 든 이 가이드를 참고하세요. 원칙은 동일합니다.

Hermes Agent를 Telegram에 연결하는 방법#

Telegram은 Hermes에서 가장 인기 있는 채널이며 연동 기능도 잘 갖춰져 있습니다. 텍스트, 음성 메시지와 전사, 이미지와 파일, 그룹에서의 답장을 지원합니다. 설정 방법은 다음과 같습니다.

1. BotFather에서 봇 만들기

   Telegram에서 @BotFather를 열고 /newbot을 보낸 다음 이름과 bot으로 끝나는 고유한 사용자 이름을 정합니다. 123456789:ABCdef...와 같은 토큰을 받게 됩니다. 봇의 키이므로 비밀번호처럼 보관하세요. 토큰이 유출되면 같은 BotFather에 /revoke를 보내 폐기하세요.

2. 사용자 ID 찾기

   숫자 ID(예: 123456789)를 확인하세요. 계정 번호이며 사용자 이름과 혼동하지 마세요. 접근 목록에 필요합니다.

3. gateway 설정 마법사 실행

   hermes gateway setup
   

   Telegram을 선택하고 토큰과 ID를 붙여 넣습니다. 마법사가 설정을 저장합니다. ~/.hermes/.env에 TELEGRAM_BOT_TOKEN=... 및 TELEGRAM_ALLOWED_USERS=123456789를 입력해 같은 작업을 직접 할 수도 있습니다.

4. gateway 시작

   hermes gateway
   

   몇 초 안에 봇이 온라인 상태가 됩니다. 봇에 메시지를 보내 응답을 확인하세요.

기본적으로 접근은 차단되어 있습니다. 봇은 목록에 있는 ID에만 응답합니다. 새 사용자에게 페어링 코드를 줄 수 있으며, 코드는 1시간 동안 유효하고 이후 만료됩니다. 대기 중이거나 승인된 사용자 목록은 hermes pairing list로 확인할 수 있습니다.

그룹 채팅에서 흔히 놓치는 함정이 하나 있습니다. 기본적으로 Telegram 봇의 개인정보 보호 모드가 켜져 있어 그룹에서 명령과 자기 메시지에 대한 답장만 볼 수 있습니다. 봇이 모든 메시지를 읽게 하려면 @BotFather(Bot Settings - Group Privacy)에서 모드를 끄거나, 더 간단하게 봇을 그룹 관리자로 지정하세요.

기본적으로 gateway는 Telegram 서버를 직접 폴링합니다. 항상 켜져 있는 가정용 컴퓨터나 서버라면 문제가 없습니다. 수신 트래픽이 없을 때 컴퓨터를 절전 상태로 전환하는 클라우드 플랫폼에서는 webhook 모드를 사용할 수 있습니다. 이 모드에서는 Telegram이 사용자의 주소로 메시지를 보냅니다.

설치 후 Hermes Agent로 할 수 있는 일#

다음 순서로 활성화하세요.

1. 예약 작업. gateway에는 내장 스케줄러가 있습니다. “매일 아침 8시에 내 관심사에 관한 뉴스 요약을 만들어 Telegram으로 보내 줘.”와 같이 일반 문장으로 일정을 설정하면 같은 채팅으로 결과가 도착합니다.
2. Hermes Desktop. hermes desktop 명령을 실행하면 macOS, Windows, Linux용 앱이 열리고 같은 에이전트를 사용할 수 있습니다. 응답 스트리밍, 채팅 옆 파일 미리보기, 문서 끌어다 놓기, 컨텍스트 카운터를 지원합니다. 세션이 공유되므로 터미널에서 시작해 창에서 이어갈 수 있습니다.
3. 웹 패널. hermes dashboard를 실행하면 브라우저에서 채널, 메모리, webhook, 프로필을 관리하는 패널이 열립니다. Hermes를 서버에서 실행할 때 유용합니다.
4. 하위 에이전트. 큰 작업을 격리된 보조 에이전트에 맡길 수 있습니다. 각자 별도의 대화와 터미널을 사용하므로 사용자의 컨텍스트를 소비하지 않습니다.
5. 음성. 음성 모드는 터미널, Telegram, Discord에서 작동합니다. 작업을 말로 전달하고 음성 응답을 받을 수 있습니다.
6. 코드 편집기. ACP 프로토콜을 통해 Hermes를 VS Code, Zed, JetBrains에 연결해 편집기 안에서 에이전트로 사용할 수 있습니다.

hermes tools로 도구를 하나씩 켜고 끌 수 있어 에이전트가 필요하지 않은 도구까지 전부 실행할 필요가 없습니다. 다른 컴퓨터로 옮길 때는 hermes backup으로 전체 설치를 아카이브로 묶고 hermes import로 새 위치에 풀면 됩니다.

Hermes Agent는 누구에게 적합하고, 누가 기다리는 편이 나을까요?#

문서를 정리하고, 프로토타입을 만들고, 연락 업무를 관리하거나 아침 뉴스 요약을 준비하는 등 에이전트에게 시킬 일을 알고 있다면 Hermes를 설치해 볼 만합니다. 중요한 것은 도구 자체가 아니라 에이전트에게 맡기는 작업입니다. 이 주제는 AI 에이전트에게 맡길 작업 가이드에서 별도로 다룹니다.

다음 두 경우에는 적합하지 않을 수 있습니다. 첫째, ‘가입하면 바로 작동할 것’이라고 기대하는 경우입니다. Hermes는 설치한 뒤 모델에 연결해야 합니다. 명령 하나면 되지만 터미널을 열어야 합니다. 둘째, 적합한 모델이 없고 구독이나 API 키를 알아보고 싶지 않은 경우입니다.

그 외의 사람은 작게 시작하면 됩니다. 설치하고 모델을 선택한 뒤 문제없이 대화 한 번을 마치세요. 다음으로 Telegram 봇을 추가하고, 그 뒤에 예약 작업과 하위 에이전트를 설정하세요.

Hermes Agent에 관해 사람들이 자주 묻는 질문#

Ailoot에서 더 많은 자료를 확인할 수 있습니다.