[보관] 22 — Hermes 설치 + V2 검증 (Anthropic provider 발견)

시각: 2026-04-27 22:19 ~ 2026-04-28 ~11:30 KST 컨텍스트: Phase 2 Day 0 사용자 외부 작업 가이드 STEP 3 실행

무엇이 있었나

도구 식별:

Hermes Agent by Nous Research (https://hermes-agent.nousresearch.com/, https://github.com/NousResearch/hermes-agent)
공식 install: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
자체 데이터 root: ~/.hermes/ (override 환경변수 $HERMES_HOME)
백엔드 옵션: nous, openrouter, anthropic(API key or Claude Code OAuth), openai-codex(ChatGPT OAuth), 외 다수

설치 흐름 (사용자 직접 실행, 대화형 마법사):

curl | bash → ~/.hermes/hermes-agent/venv/ 에 Python 가상환경 생성, ~/.local/bin/hermes 심볼릭 링크
Quick setup (recommended) 선택
Provider 선택 화면에서 사용자가 OpenAI Codex가 아닌 Anthropic (Claude models — API key or Claude Code) 선택 (“오 클로드 코드로 연결되나보다. 해보자”)
AI(이 세션)가 C1 위반(코덱스 단일 백엔드 깨짐)이라 경고 → 사용자는 다음 화면으로 진행 (메신저 설정)
메신저 = Slack 선택, allowed user IDs 비워둠, launchd 서비스 등록 거절
“Set up gateway as background service?” 도 거절
셸로 빠져나옴

V2 검증 결과 (격리 + provider 설정):

항목	결과
`~/.hermes/` 트리	✓ docs와 일치 (config.yaml, auth.json, SOUL.md, memories/, skills/, cron/, sessions/, logs/ + audio_cache/, image_cache/, pairing/, hooks/, hermes-agent/ venv 소스, slack-manifest.json)
`model.provider` 키 존재	✓ config.yaml에서 설정 가능, 주석에 `openai-codex` 등 유효 값 명시
메모리·스킬 위치	✓ `~/.hermes/memories/`, `~/.hermes/skills/`
외부 누수	△ `~/.local/bin/hermes` 심볼릭 링크 1개 (system bin 아님). LaunchAgents 없음. zshrc에 `~/.local/bin` PATH 한 줄 (hermes가 추가했는지 기존인지 미확정)
실제 active provider	❌ `provider: anthropic`
auth.json 자격증명	`credential_pool.anthropic = [{label: "claude_code", source: "claude_code", auth_type: "oauth"}]` — Claude Code의 기존 OAuth 토큰을 자동 import한 것

Provider가 anthropic으로 끝난 이유: Hermes 설치 마법사가 사용자에게 직접 provider를 고르게 하는데, 사용자가 호기심으로 Anthropic을 선택. AI 경고는 명확히 했지만 사용자 의도는 “Claude Code 백엔드 가능성 탐색”이었던 것으로 확인됨.
C1 위반은 의도적 결정으로 전환 (→ history/23 참조). 단순 실수가 아님.
launchd 서비스 거절: ~/Library/LaunchAgents/에 plist 생성 = ~/.hermes/ 외부 부수효과. 평가 외 시간에 백그라운드 토큰 소모 우려. 필요해지면 수동으로 hermes gateway 실행 가능.
메신저 설정 진행한 이유: Quick setup 마법사는 messaging 단계까지 한 흐름. 평가 본질(에이전트 응답 품질)과 무관하지만 C3(~/.hermes/ 격리)만 깨지지 않으면 Phase 2 진행에 무해 → slack-manifest.json 등도 모두 ~/.hermes/ 내부에 떨어진 것 확인.

Hermes는 즉시 사용 가능 상태. 현재 백엔드는 Claude Code (Anthropic OAuth, source=claude_code, label=claude_code).
Track A 시작 상태로 직결: history/23에서 결정된 새 C1(두-트랙 순차)에서 Track A = Claude Code 백엔드 → 별도 reconfigure 불요.
마이너 사고: 검증 중 AI가 auth.json 풀 내용을 출력해서 OAuth 액세스 토큰이 대화에 노출됨. 사용자 본인 머신의 자격증명이라 외부 유출은 없으나, 다음부터는 키 이름·메타데이터만 출력하고 토큰 값은 마스킹할 것.
미확인: ~/.zshrc의 export PATH="$HOME/.local/bin:$PATH" 한 줄이 hermes 설치가 추가한 건지 기존인지. 영향 미미해서 추적 안 함.
slack-manifest.json이 ~/.hermes/ 루트에 위치 — 워크스페이스에 등록할 Slack 앱 매니페스트. Phase 2에서 Slack 평가 흐름이 필요해지면 사용.
알려진 노이즈: codex CLI에서 stderr failed to record rollout items (history/21 참조)와 별개로 hermes 측 노이즈는 아직 관찰 안 됨.