🤖HermesBlog
Hermes Official Tutorials · 파트 28/9/2026

5분 만에 시작하는 첫 AI 대화

Tutorial 2: Your First AI Conversation in 5 Minutes — easy-to-understand guide based on official docs

Hermes tutorial

5분 만에 시작하는 첫 AI 대화

Hermes Agent 튜토리얼 시리즈에 다시 오신 것을 환영합니다! 튜토리얼 1에서 기본적인 설정을 마쳤죠. 이제 진짜로 AI와 대화를 나눠볼 차례입니다. 딱 5분이면 됩니다.

도구를 설치해놓고 “음, 설치했는데… 이제 뭐 하지?“라고 생각해본 적 있으신가요? 그렇다면 이 튜토리얼이 딱입니다. 0에서 시작해 실제로 작동하는 AI 대화까지 가장 빠른 길을 안내해드리고, 문제가 생겼을 때 어떻게 해야 하는지도 정확히 알려드릴게요.

가장 중요한 원칙

본격적으로 시작하기 전에, 여러분의 시간을 아껴줄 딱 한 가지 조언을 드릴게요:

Hermes가 기본 채팅을 완료하지 못한다면, 기능을 더 추가하지 마세요.

먼저 깔끔한 대화 하나를 성공시키세요. 그다음에야 게이트웨이, 스킬, 음성 같은 화려한 기능을 하나씩 얹어도 됩니다. 제 말을 믿으세요.

1단계: Hermes Agent 설치하기

아직 Hermes를 설치하지 않았다면, 가장 쉬운 방법은 공식 웹사이트에서 Hermes Desktop 설치 프로그램을 받는 것입니다. macOS와 Windows에서 작동하며, CLI와 데스크톱 앱을 모두 설치해줍니다.

커맨드 라인이 더 편하다면? 터미널에서 이렇게 실행하세요:

Linux / macOS / WSL2 / Android (Termux):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (PowerShell):

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

설치가 끝난 후, 셸을 새로고침하세요:

source ~/.bashrc   # 또는 source ~/.zshrc

2단계: 제공자(Provider) 선택하기 (중요한 결정)

이 단계가 가장 중요한 설정입니다. 다음 명령어를 실행하세요:

hermes model

그러면 대화형으로 제공자를 선택하는 과정이 시작됩니다. 간단 요약표는 다음과 같습니다:

제공자 설명 설정 방법
Nous Portal 구독형, 설정 불필요 OAuth 로그인, API 키 불필요
OpenAI Codex ChatGPT/Codex 구독 디바이스 코드 인증
Anthropic Claude 모델 OAuth (Max 플랜) 또는 API 키
OpenRouter 다양한 모델, 키 하나로 통합 API 키 입력
Fireworks AI OpenAI 호환 API FIREWORKS_API_KEY 설정
Z.AI GLM 모델 GLM_API_KEY 설정
Kimi / Moonshot Moonshot 모델 KIMI_API_KEY 설정

초보자 팁: 가장 쉬운 길을 원한다면 Nous Portal을 사용하세요. 구독 하나로 300개 이상의 모델을 쓸 수 있고, 모든 설정을 명령어 하나로 끝낼 수 있습니다:

hermes setup --portal

이 명령어 하나로 로그인, Nous 제공자 설정, 툴 게이트웨이(웹 검색, 이미지 생성 등) 활성화까지 한 번에 해결됩니다.

3단계: 설정 모드 선택하기

새로 설치한 상태에서 hermes setup을 실행하면 세 가지 옵션이 표시됩니다:

  • 빠른 설정 (Quick Setup, Nous Portal) — 무료 OAuth 로그인, API 키 불필요. 추천하는 빠른 경로입니다.
  • 전체 설정 (Full Setup) — 모든 제공자와 도구를 직접 하나씩 설정 (자신의 키를 준비하세요).
  • 깔끔한 시작 (Blank Slate) — 최소한의 기능(제공자, 모델, 파일 작업, 터미널)만 켜고 나머지는 모두 꺼진 상태로 시작. 최소한의 완전 통제형 에이전트를 원한다면 딱 좋습니다.

이 튜토리얼에서는 몇 분 안에 대화를 시작하고 싶다면 빠른 설정을 선택하세요. 처음부터 모든 걸 직접 만들고 싶은 성향이라면 깔끔한 시작을 선택하세요.

4단계: 첫 대화 나누기

제공자 설정이 끝났다면, 그냥 채팅을 시작하면 됩니다:

hermes

끝입니다. 프롬프트가 나타나면 “안녕! 뭐 할 수 있어?“라고 입력해보세요. 마법이 펼쳐지는 걸 볼 수 있을 거예요.

문제가 생겼다면?

다음과 같이 문제를 해결해보세요:

  1. 설치가 안 되나요? 설치 가이드에서 사전 요구사항을 확인하세요.
  2. 채팅이 응답하지 않나요? hermes model을 다시 실행해서 제공자가 올바르게 설정되었는지 확인하세요.
  3. 커스텀 엔드포인트를 사용 중인가요? 엔드포인트 URL, 모델 이름, 컨텍스트 길이를 다시 한번 확인하세요.
  4. 휴대폰에서 사용 중인가요? Android 관련 팁은 전용 Termux 가이드를 참고하세요.

영상으로 배우고 싶나요?

Onchain AI Garage 팀이 설치, 설정, 기본 명령어에 대한 훌륭한 영상 튜토리얼을 만들었습니다. YouTube에서 Hermes Agent 튜토리얼 & 활용 사례 재생목록을 확인해보세요.

다음은 무엇인가요?

다음 튜토리얼에서는 더 많은 도구 추가하는 방법, 봇용 게이트웨이 설정하는 방법, 그리고 Hermes를 24시간 365일 나만을 위해 일하게 만드는 방법을 다룰 예정입니다. 하지만 지금은 — 대화를 나눠보세요. 그럴 자격이 충분하니까요.

📖 공식 문서

この記事は Hermes Agent の공식 문서に基づいています:공식 문서 › getting-started/quickstart