Hermes Desktop 설정 186개 항목을 실기 및 소스 코드로 전수 조사하여 일본어 가이드를 공개했습니다

TL;DR

• Nous Research의 Hermes Desktop 설정 14개 카테고리, 총 186개 항목을 실기 감사(Audit)와 소스 코드 대조를 통해 검증한 비공식 일본어 가이드를 공개했습니다 → https://hermes.ai-deck.app - 검증은 v0.16.0 / 커밋 d165933에 고정되었습니다. Computer Use를 사용하여 설정 14개 화면의 액세서빌리티 트리(Accessibility Tree)를 채취하였고, 기본값은 설정 API와 소스를 통해 확인했습니다. AI 에이전트의 설정은 안전성과 직결됩니다. 승인 모드(Approval Mode), 시크릿 마스킹(Secret Masking), 프라이빗 URL(Private URL) 등은 반드시 모든 항목을 한 번씩 훑어보시길 권장합니다.

만든 이유 — 소개 기사는 있지만, 레퍼런스가 없다

현재 Hermes Agent가 엄청난 기세로 확산되고 있습니다. 2026년 2월 25일 공개 이후 4개월도 채 되지 않아 GitHub 스타 수는 약 19만 개에 달합니다 (2026년 6월 10일 기준). 6월 초에는 공식 데스크톱 앱인 Hermes Desktop이 macOS / Windows / Linux용으로 공개되어, 터미널을 사용하지 않는 계층에게도 단숨에 전달되기 시작했습니다.

일본어 정보도 늘어나고 있습니다. 하지만 내역을 살펴보면 「설치해서 만져보았다」 계열의 소개 기사가 대부분입니다. 그 다음 단계인——설정 화면을 열고 「승인 모드의 Smart와 Manual은 무엇이 다른가?」 「게이트웨이(Gateway)란 무엇인가?」라며 손을 멈춘 사람들을 위한 수용처가 보이지 않았습니다.

공식 문서(Official Documentation)는 영어와 간체 중국어뿐이며, 일본어판은 없습니다. 게다가 개발 속도가 빨라 문서가 화면의 모든 항목을 따라가지 못하고 있습니다. 즉, 「공식을 읽으면 알 수 있다」가 성립하지 않는 것입니다.

일반적인 앱이라면 의미를 알 수 없는 토글(Toggle)이 있어도 크게 곤란하지 않습니다. 하지만 AI 에이전트의 설정은 사정이 다릅니다. 셸 커맨드(Shell Command) 자동 승인, 내부 네트워크로의 액세스, 시크릿(Secret) 취급——안전성과 직결되는 항목들이 당연하다는 듯이 나열되어 있습니다. 의미를 모르는 채 기본값을 바꾸는 것은, 자세를 모르는 상태에서 고중량 운동을 하는 것과 같습니다. 잠시는 움직이겠지만, 언젠가는 허리를 다치게 됩니다.

그렇다면, 설정만큼은 모든 항목을 근거와 함께 찾아볼 수 있는 장소를 만들자. 그렇게 결정하고, 수중에 있는 v0.16.0 빌드를 대상으로 검증을 시작했습니다.

만든 것

Hermes Desktop 가이드 (비공식): https://hermes.ai-deck.app

• 설정 14개 카테고리 (모델 / 채팅 / 외관 / 워크스페이스 / 안전성 / 메모리와 컨텍스트 / 음성 / 상세 / 프로바이더 / 게이트웨이 / 툴과 키 / MCP / 아카이브된 채팅 / 정보)를 모두 페이지화
• 각 항목에 화면 표시 · 내부 키 · 제품 기본값 · 권장값을 기재 - 전체 설정 항목 인덱스는 16개 표 · 186개 행
• 시작하기 / 기본 조작 / 트러블슈팅 섹션도 있지만, 핵심은 설정 레퍼런스(Reference)입니다.

대상은 처음으로 Hermes Desktop을 설치하는 사람부터, 모든 항목의 기본값과 근거를 확인하고 싶은 사람까지입니다.

어떻게 검증했는가 — 버전 고정 · 실기 감사 · 소스 대조

기본값이나 권장값을 게재하는 이상, 「어떤 버전에서, 무엇을 근거로」 했는지를 말할 수 없다면 의미가 없습니다. 세 가지 규칙으로 진행했습니다.

1. 버전을 고정한다

대상은 v0.16.0, 커밋 d165933이며, 실기 확인일은 2026-06-07입니다. 확인 시점에 앱에는 더 새로운 업데이트 알림이 와 있었지만, 확인되지 않은 업데이트 내용은 섞지 않고 실제로 기동하여 확인한 커밋에 고정했습니다. 근거의 상세 내용은 버전과 조사 근거 페이지에 정리해 두었습니다.

2. 실기를 Computer Use로 감사한다

설정 사이드바를 위에서부터 순서대로, 14개 화면과 서브 메뉴 4개를 열어갑니다. 채취하는 것은 화면 표시와 액세서빌리티 트리(Accessibility Tree)뿐입니다. 토글도 입력란도 저장 버튼도 조작하지 않습니다. 읽기만 하는 감사입니다.

실기를 보지 않으면 알 수 없는 것들이 실제로 있었습니다. 예를 들어 「툴과 키(Tools and Keys)」 화면은 내부 키 끝의 _API_KEY나 _TOKEN을 생략하여 표시합니다. GATEWAY_PROXY_KEY는 화면상에서 GATEWAY PROXY로 표시됩니다. 소스만 읽어서는 화면 표기와 대조할 수 없고, 화면만 봐서는 내부 키를 알 수 없습니다. 양쪽을 36개 행에 걸쳐 대조하여 겨우 표로 만들 수 있었습니다.

3. 기본값은 소스와 API로 확인한다

화면에 표시되는 것은 「현재 값」이지 「기본값 (Default value)」이 아닙니다. 기본값은 설정 API의 DEFAULT_CONFIG와 /api/config/defaults의 반환 경로, 외관 계열은 localStorage 로드 시의 폴백 (Fallback), 그리고 동일 커밋의 소스 코드와 일본어 번역 파일을 대조하여 확정했습니다. 실제 화면과 일반 문서가 모순되는 경우에는 대상 빌드의 실제 화면과 소스 코드를 우선시했습니다.

설정을 읽으면 설계 사상이 보인다

186개 항목을 차례대로 파헤치다 보면, 이 앱이 「자율성과 안전성의 트레이드오프 (Trade-off)를 사용자에게 위임하는」 설계라는 것을 알 수 있습니다. 상징적인 항목을 3가지만 들겠습니다.

승인 모드는 manual / smart / off의 3단계. 기본값은 manual이며, 에이전트가 실행하는 명령을 사람이 확인합니다. smart는 보조 모델이 리스크를 판정하여 자동 승인을 지원합니다. off는 승인 프롬프트 자체를 생략합니다. 단, 치명적인 파괴적 조작에 대한 하드 블록 (Hard block) 등 일부 방어 기제는 남습니다. 남는다고는 해도 사람의 확인을 거치지 않으므로, off가 「안전」과 동의어는 아닙니다.

파일 체크포인트 (기본값 off). 켜두면 파일 변경 전에 실제 프로젝트의 .git과는 별개의 섀도우 Git 스토어 (Shadow Git store)에 스냅샷을 생성합니다. 에이전트에게 코드를 만지게 하려면 켜두는 것을 추천합니다.

시크릿 숨기기 (기본값 on). API 키나 토큰으로 보이는 문자열을 툴 출력이 대화 컨텍스트 (Context)나 로그에 들어가기 전에 마스킹 (Masking)합니다. 다만 완전한 유출 방지를 보장하는 기능은 아니므로, 이것에만 전적으로 의존하지 말고 평문 시크릿을 로그나 파일에 두지 않는 운용도 필요합니다.

이 3가지만 보더라도, 「일단 전부 자동화」하는 쪽으로 치우치지 않고 어디까지 맡길지를 사용자에게 선택하게 하는 사상을 읽을 수 있습니다. 역으로 말하면, 선택을 해야 하는 만큼 사용하는 쪽에는 설정을 이해할 재료가 필요합니다. 그 재료를 모아두는 곳으로서 이 가이드를 만들었습니다.

「언제 정보인지」를 알 수 있도록 한다

개발 속도가 빠른 도구의 문서는 신선도 관리가 전부라고 생각합니다. 그래서 운용 규칙도 처음에 정했습니다.

• 모든 페이지는 대상 버전과 확인일을 메타데이터로 가진다.
• 실제 기기 및 소스로 확인 완료된 페이지는 verified, 제품 업데이트 후 차분 확인이 필요한 것은 needs-review로 명시한다.
• 앱 업데이트 후에는 버전 기록 → 화면 다시 촬영 → 색인과 대조 → 기본값 재취득의 순서로 재조사한다.

비공식 가이드가 공식 문서보다 나을 수 있는 점이 있다면 바로 여기라고 생각합니다. 모든 항목의 망라와 「이 기술은 언제, 무엇을 근거로 작성되었는가」의 명시입니다.

입구는 여기부터

모든 페이지를 순서대로 읽을 필요는 없습니다. 현재 상황에 맞춰 접근하기 쉬운 곳부터 확인해 보세요.

상황	입구
이제 막 사용을 시작한다	Hermes Desktop이란 → 설치 → 초기 설정
...

설정 화면에서 의미를 알 수 없는 항목을 만난다면 사이트 내 검색을 이용해 보세요. 당신의 환경에서 「화면 표시가 가이드와 다르다」는 지적은 무엇보다 큰 도움이 되므로, X (@nagataku_ai)로 알려주시면 감사하겠습니다.

Discussion