빠른 시작

개요

설치가 끝났다면 이제 Hermes Agent가 실제로 응답하는지 확인합니다. 이 빠른 시작은 도움말을 열고, 모델을 고르고, 첫 대화를 시작한 뒤, 세션을 다시 이어가는 순서로 구성했습니다.

macOS, Linux, Windows WSL2에서는 같은 bash 흐름으로 따라가면 됩니다. Windows native PowerShell에서는 PowerShell 블록을 따로 실행합니다. 두 환경을 섞으면 경로와 환경 변수가 달라져 원인을 찾기 어려워집니다.

첫 실행

먼저 도움말을 열어 명령이 제대로 잡혔는지 확인합니다.

macOS, Linux, WSL2 터미널에서는 아래 명령을 실행합니다.

source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null || true
hermes --help

Windows native PowerShell에서도 같은 명령을 사용합니다.

hermes --help

명령 목록과 옵션 설명이 보이면 설치된 실행 파일을 정상적으로 찾은 상태입니다.

모델 선택

처음 실행할 때는 설정 마법사를 먼저 엽니다. 이 단계에서 기본 환경을 정리한 뒤 사용할 모델을 고릅니다.

hermes setup
hermes model

PowerShell에서도 같은 순서로 실행합니다.

hermes setup
hermes model

Nous Portal을 쓰는 경우에는 포털 설정과 상태 확인을 함께 볼 수 있습니다.

hermes setup --portal
hermes portal status

첫 대화

기본 대화형 CLI를 엽니다.

hermes

터미널 UI를 쓰고 싶다면 다음 명령을 실행합니다.

hermes --tui

처음에는 짧은 요청으로 시작하는 편이 좋습니다.

현재 작업 폴더의 파일 구성을 간단히 설명해줘.

프로젝트 폴더에서 실행했다면 다음 요청도 잘 맞습니다.

이 폴더에서 처음 읽어야 할 파일 3개를 골라 이유를 설명해줘.

대화창이 열리고 응답이 돌아오면 첫 대화는 성공한 것입니다.

세션 이어가기

대화를 종료한 뒤 새 터미널을 열고 직전 세션을 다시 엽니다.

hermes --continue

짧게 입력하려면 아래 명령을 사용합니다.

hermes -c

PowerShell에서도 같은 방식으로 확인합니다.

hermes --continue

직전 대화 흐름이 이어지면 세션 재개가 정상적으로 작동한 것입니다.

성공 상태 확인

처음 설치한 뒤에는 아래 흐름이 한 번씩 통과하면 충분합니다.

macOS, Linux, WSL2:

hermes --help
hermes setup
hermes model
hermes
hermes --continue

Windows native PowerShell:

hermes --help
hermes setup
hermes model
hermes
hermes --continue

여기까지 되면 흐름이 잘 잡힌 상태입니다.

• hermes --help에서 명령 목록이 보입니다.
• hermes setup에서 설정 화면이 열립니다.
• hermes model에서 사용할 모델을 고를 수 있습니다.
• hermes 또는 hermes --tui에서 대화가 시작됩니다.
• hermes --continue에서 직전 세션이 이어집니다.

확장 기능은 나중에 켜기

Gateway, skills, MCP, cron은 기본 대화가 안정된 뒤에 붙이는 편이 좋습니다. 처음부터 모두 켜면 문제가 생겼을 때 설치 문제인지, 모델 설정 문제인지, 외부 연동 문제인지 구분하기 어렵습니다.

기본 흐름이 통과한 뒤에는 다음 명령으로 확장 기능을 살펴볼 수 있습니다.

hermes gateway setup
hermes skills search kubernetes

문제가 생겼을 때

증상	확인할 일	명령
hermes 명령을 찾을 수 없음	실행 경로가 잡혔는지 확인합니다.	command -v hermes
응답이 오지 않음	모델과 API 키 설정을 다시 확인합니다.	hermes model
세션 재개가 안 됨	같은 사용자와 같은 터미널 환경에서 실행했는지 확인합니다.	hermes --continue
PowerShell에서 화면이 깨짐	WSL2 터미널에서 다시 실행합니다.	wsl -d Ubuntu

실패가 반복되면 기능을 더 켜지 말고 표의 위쪽부터 다시 확인합니다. 특히 Windows에서는 Windows WSL2와 Windows native PowerShell 중 어느 쪽에서 실행하는지 먼저 고정해야 합니다.

PowerShell에서 실행 파일 경로를 확인하려면 다음 명령을 사용합니다.

Get-Command hermes

다음 글

기본 실행 흐름을 확인했다면 CLI에서 자주 쓰는 명령과 세션 제어 방식을 이어서 봅니다.

참고 자료

• Hermes Agent 빠른 시작
• Hermes Agent 모델 설정