Hermes Agent 설치와 설정

설치

# Linux / macOS / WSL2 / Termux
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes

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

`source ~/.bashrc`를 건너뛰지 마세요. 설치 스크립트가 실행 파일 위치를 셸 설정에 기록하는데, 다시 불러오지 않으면 같은 터미널 창에서 `hermes`를 쳐도 명령을 찾지 못합니다. "설치는 됐는데 실행이 안 된다"의 가장 흔한 원인입니다. zsh를 쓴다면 본인 셸 설정 파일을 다시 불러오거나 새 터미널 창을 여세요.

첫 설정

설치가 끝나면 `hermes`만 입력해도 대화를 시작할 수 있습니다. 첫 대화 전에 설정을 마치고 싶다면 공식 README가 안내하는 대로 `hermes setup`을 실행합니다. 설정 항목은 연결할 모델과 서비스에 따라 달라지므로 이 부분은 공식 문서를 기준으로 하시고, 우리가 자료에서 확인하지 못한 필드는 추측해 적지 않았습니다.

hermes         # 바로 대화 시작
hermes setup   # 설정을 먼저 마치고 시작

설치 후 먼저 할 일

1. 읽기 전용이면서 검증 가능한 작업을 하나 던져 환경을 어떻게 이해하는지 봅니다. 자율 에이전트의 첫 실행은 언제나 이렇게 시작해야 합니다.
2. 실행 경계를 확인합니다. 어떤 디렉터리에 접근할 수 있는지, 명령을 실행할 수 있는지. 자율 에이전트에서는 기능 목록보다 이것이 먼저입니다.
3. 목표가 사실 프로그래밍이라면 역할을 나눕니다. Hermes는 도구 경계를 넘나드는 자동화, 저장소 안의 코드 수정은 Claude Code나 OpenCode에 맡기는 식입니다.

자주 막히는 지점

• 설치 후 명령을 못 찾음 → 거의 항상 `source ~/.bashrc` 누락입니다. 새 터미널을 열어도 해결됩니다.
• Windows에서 스크립트가 막힘 → PowerShell과 CMD를 구분하세요. 프롬프트 앞에 `PS`가 있으면 PowerShell입니다.
• 무엇을 시켜야 할지 모르겠음 → 이 도구는 코딩 전용이 아닙니다. 반복 작업 자동화처럼 범위가 넓은 일에서 강점이 드러납니다.