Hermes Agent 설치 및 보안 설정 방법
안녕하세요 novice-22입니다.
이번 글은 Nous Research의 Hermes Agent를 Windows에 설치하고 기본 설정을 잡은 과정을 정리한 글입니다. Claude·DeepSeek API 연결과 보안 설정에 대해 작성하였습니다.
1. Hermes Agent
내 PC나 서버에서 돌아가는 개인 AI 에이전트다. Claude, DeepSeek, 로컬 모델 등을 앱 하나에서 바꿔가며 쓸 수 있고, 기억·도구 실행·메신저 연동·예약 작업을 지원한다. Claude Code와 달리 구독이 아니라 API 키로만 쓴다.
명령을 직접 실행하는 에이전트라 기본 설정 그대로 쓰면 위험할 수 있다. 이 글의 핵심은 3장 보안 설정이다.
출처
2. 설치와 모델 연결
2-1 설치
공식 사이트에서 Hermes Desktop을 받아 설치하고, 첫 실행 화면에서 Install Hermes locally를 고른다. 온보딩에서는 레이아웃은 Elite(터미널·파일·diff 패널 표시), 앱 연결과 플러그인은 건너뛰고, 사용 통계 공유는 No thanks를 골랐다.
Linux/WSL2/서버라면 스크립트로 설치한다.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes model2-2 Anthropic OAuth 해제
Settings → Providers → Accounts에 PC의 Claude Code 로그인이 자동으로 연결돼 있었다.
Anthropic OAuth: Required Extra Usage Credits to Use Subscription ✓ Connected이 방식은 claude.ai의 추가 사용량(종량제)에서 차감되므로 해제하고 API 키를 쓴다.
2-3 API 키 입력
Settings → Providers → API keys
| 제공사 | 내용 |
|---|---|
| Anthropic | Console에서 서비스 계정으로 발급한 키. base URL은 비워둔다 |
| DeepSeek | platform.deepseek.com에서 발급한 키. 선불이라 소액만 충전 |
DeepSeek는 중국 서버에서 처리되니 민감한 자료는 보내지 않는다.
2-4 모델
| 메뉴 | 설정 |
|---|---|
| Model → Main model | Anthropic / claude-sonnet-5-5 / Reasoning Medium |
| Model → Auxiliary models | 제목·요약 등 잡일은 claude-haiku-5-5, Approval·Vision·Review는 메인 모델 유지 |
목록에 모델이 없으면 칸에 직접 입력하면 된다. 대화 중에는 입력창에서 모델을 바로 바꿀 수 있다.
3. 보안 설정
| 메뉴 | 설정 | 이유 |
|---|---|---|
| Safety → Approval Mode | Manual | 기본값 Smart는 일부 명령을 자동 실행한다 |
| Safety → Command Allowlist | 비워둠 | 여기 적은 명령은 승인 없이 실행된다 |
| Workspace → Working Directory | 전용 폴더 | 기본값은 홈 전체(.ssh, .aws 포함) |
| Workspace → Repository Discovery | 끄기 | 홈 폴더 전체 Git 저장소 스캔 방지 |
| Passwords & Logins | 비워둠 | 한 번 입력한 로그인은 저장돼 자동 사용된다 |
| Browser → Real Browser Profile | 끄기 | 켜면 크롬의 쿠키·로그인을 그대로 쓴다 |
| Browser → Private URLs | 끄기 | localhost, 내부망 접근 차단 |
| Memory → Provider | Built-in only | 기억을 이 PC에만 저장 |
전용 폴더는 이렇게 만들었다. 다른 프로젝트가 필요하면 복사하지 않고 교차점으로 연결하면 원본이 그대로 업데이트된다.
mkdir $env:USERPROFILE\hermes-workspace
cmd /c mklink /J "$env:USERPROFILE\hermes-workspace\my-tool" "$env:USERPROFILE\Projects\my-tool"그 외 Appearance에서 Model Pricing은 켜고 Guided Tours는 껐다. Notifications의 Approval needed는 꼭 켜둔다.
출처
4. 겪은 문제와 해결
4-1 첫 대화가 처리되지 않는다
온보딩 대화에서 Your message was interrupted before processing started가 떴다. 모델 키를 연결하기 전이라 생긴 문제로, 키와 모델을 설정한 뒤 새 세션(Ctrl + N)을 열어 해결했다.
4-2 백엔드 설치가 다시 진행된다
앱을 다시 열자 설치 화면이 또 나왔다. 앞에서는 앱 화면만 설치되고 백엔드가 완전히 설치되지 않았던 것으로 보인다. 끝까지 설치한 뒤에도 키와 설정은 그대로 남아 있었다.
5. 마무리
설치는 간단했고 시간이 걸린 쪽은 기본값을 되돌리는 작업이었다. 작업 폴더는 홈 전체, 승인은 Smart, Claude는 구독 OAuth로 자동 연결돼 있었다. 명령을 직접 실행하는 에이전트라면 설치 직후 Providers와 Safety부터 확인하는 게 좋다.