책에 포함된 노트Hermes Agent 사용법: 설치부터 메모리·자동화·운영까지 한 권으로 끝내기

6. 도구 사용법: 터미널, 파일, 웹 검색, 브라우저

2026-04-18Views 165약 9분

6. 도구 사용법: 터미널, 파일, 웹 검색, 브라우저

도구 사용법: 터미널, 파일, 웹 검색, 브라우저

답을 잘하는 것보다, 일을 실제로 처리하는 것이 중요하다

Hermes의 진짜 매력은 말을 예쁘게 하는 데 있지 않다. 도구를 써서 실제 작업을 끝내는 능력에 있다. 터미널에서 명령을 실행하고, 파일을 읽고 고치고, 웹에서 정보를 찾고, 필요하면 브라우저를 열어 버튼까지 눌러 준다. 그래서 Hermes는 "대화형 AI"에 머무르지 않고, 점점 "일하는 에이전트"에 가까워진다.¹

쉽게 말해 보자. 일반 챗봇이 똑똑한 조언가라면, Hermes는 조언도 하고 직접 손발도 움직이는 조수다. "어떻게 해야 해?"에 답하는 데서 끝나지 않고, "제가 해볼게요"로 이어진다. 이 차이가 생각보다 크다.

이번 장에서는 Hermes의 대표 도구인 터미널, 파일, 웹 검색, 브라우저를 어떻게 이해하고, 어떤 상황에서 꺼내 들며, 어떻게 안전하게 써야 하는지를 차근차근 살펴본다.

도구와 도구셋, 먼저 감을 잡자

Hermes에는 여러 도구가 들어 있다. 하지만 항상 모든 도구를 다 켜 두는 것이 정답은 아니다. 공식 설정 흐름에서도 hermes tools로 어떤 도구를 활성화할지 조정할 수 있고, 플랫폼별로 허용 범위를 달리 둘 수 있다.¹

여기서 도구는 개별 능력이다. 예를 들어 "명령 실행", "파일 읽기", "웹 검색", "브라우저 클릭" 같은 것들이다. 반면 도구셋은 이런 능력을 묶어 놓은 작업 상자라고 생각하면 쉽다. 예를 들어 로컬 개발 작업에는 터미널과 파일 도구가 잘 어울리고, 조사 업무에는 웹 검색과 브라우저 도구가 잘 어울린다.

실무에서는 이 도구셋 감각이 중요하다. 이유는 단순하다. 에이전트가 더 많은 도구를 가질수록 더 많은 일을 할 수 있지만, 동시에 더 많은 실수를 낼 여지도 생기기 때문이다. 그래서 잘 쓰는 사람일수록 "무엇을 할 수 있나?"보다 먼저 "이번 일에 무엇만 허용할까?"를 생각한다.

가장 기본적인 감각은 이렇다.

터미널은 실행과 점검에 강하다.
파일은 읽기, 수정, 검색, 패치에 강하다.
웹 검색은 빠른 조사와 출처 수집에 강하다.
브라우저는 로그인, 클릭, 입력처럼 상호작용이 필요한 웹 작업에 강하다.

이 네 가지를 구분해서 쓰기 시작하면 Hermes의 효율이 확 올라간다.

터미널 도구: Hermes의 손과 발

터미널 도구는 가장 직관적이면서도 가장 강력하다. 디스크 사용량을 확인하고, 테스트를 돌리고, 빌드를 실행하고, 로그를 살피고, 서버 상태를 점검할 때 Hermes는 결국 셸 명령을 대신 실행한다.¹

Hermes의 터미널은 단순히 "명령 한 줄 실행기"가 아니다. 공식 문서와 코드 해설을 보면 여러 실행 백엔드 위에서 동작하며, 작업별 격리와 재사용 가능한 환경을 지원한다.² 쉽게 말해, 한 번 쓰고 휘발되는 버튼이 아니라 맥락을 가진 작업 공간에 가깝다.

예를 들어 이런 요청이 잘 맞는다.

"현재 디스크 사용량을 확인하고 용량을 많이 쓰는 디렉터리 5개를 보여줘."

"이 프로젝트에서 테스트를 돌리고 실패한 항목만 요약해줘."

"로그 파일에서 ERROR만 찾아서 최근 50줄을 정리해줘."

이럴 때 중요한 건 "무슨 명령을 쳐야 하지?"를 사람이 떠올리지 않아도 된다는 점이다. Hermes가 목적에 맞는 명령을 조합하고, 결과를 다시 읽기 좋은 말로 바꿔 준다.

다만 편하다고 해서 방심하면 안 된다. 터미널은 생산성의 지름길이지만, 실수도 가장 빨리 현실이 된다. 예를 들어 삭제, 이동, 권한 변경, 서비스 재시작 같은 작업은 실제 시스템 상태를 바꾼다. Hermes는 위험한 명령 패턴에 대해 승인 절차를 두고, 파괴적인 명령을 조용히 실행하지 않도록 설계되어 있다.³

터미널 도구를 잘 쓰는 습관은 의외로 단순하다.

먼저 읽기 전용 점검부터 시킨다.
변경 작업은 실행 전 명령 미리보기를 요청한다.
가능하면 로컬 대신 Docker나 SSH 같은 격리 백엔드를 쓴다.¹
운영 서버에서는 "수정"보다 "진단 → 제안 → 승인 후 실행" 순서를 지킨다.

한마디로, 터미널 도구는 망치가 아니라 전동 공구다. 일은 빨라지지만, 장갑은 꼭 끼고 써야 한다.

파일 도구: 읽고, 찾고, 고치고, 패치한다

Hermes의 파일 도구는 단순한 파일 열람을 넘어선다. 공식 해설 기준으로 파일 읽기, 쓰기, 검색, 패치 같은 특화된 작업을 수행할 수 있고, 터미널 도구와 함께 쓰일 때 특히 강력하다.²

이 도구가 빛나는 순간은 크게 두 가지다. 하나는 코드베이스를 이해할 때, 다른 하나는 안전하게 수정할 때다.

예를 들어 프로젝트를 처음 열었을 때 이런 요청이 좋다.

"src 디렉터리를 훑고 엔트리포인트 파일과 설정 파일을 찾아 구조를 설명해줘."

이 요청은 파일 도구의 정석이다. Hermes는 코드를 읽고, 중요한 파일을 짚고, 어디서부터 보면 좋을지 길을 내준다. 사람이 폴더를 하나씩 클릭하며 헤매는 시간을 줄여 준다.

수정 작업에서도 파일 도구는 유용하다.

"config.yaml에서 포트 설정이 어디 있는지 찾고, 변경이 필요한 이유를 설명한 뒤 수정안을 보여줘."

이렇게 요청하면 Hermes가 무작정 덮어쓰는 대신, 무엇을 바꾸는지와 왜 바꾸는지를 함께 보여주게 만들 수 있다. 좋은 사용자는 언제나 "바꿔"보다 "어디를 왜 바꾸는지 먼저 보여줘"를 더 자주 말한다.

특히 파일 작업에서 기억할 점은, Hermes가 빨라질수록 사용자는 더 구체적으로 말해야 한다는 것이다. "이 코드 좀 고쳐줘"보다 "이 함수의 예외 처리만 개선하고, 외부 동작은 바꾸지 마"가 훨씬 안전하다. 범위를 좁히면 결과도 좋아진다.

파일 도구를 실전에서 잘 쓰는 요령은 이렇다.

수정 전에는 대상 파일 경로를 분명히 지정한다.
가능하면 diff나 변경 요약을 먼저 보여 달라고 한다.
여러 파일을 만질 때는 우선순위를 정한다.
설정 파일과 비밀키 파일은 일반 코드보다 더 보수적으로 다룬다.

Hermes가 코드를 고칠 수 있다는 사실보다 더 중요한 것은, 어떤 단위로 고치게 할 것인가를 사용자가 통제하는 것이다.

웹 검색 도구: 빠른 조사에 가장 먼저 꺼내는 카드

웹 작업이라고 해서 무조건 브라우저부터 여는 것은 아니다. 공식 브라우저 문서도 단순 정보 수집이라면 브라우저보다 웹 검색이나 추출 도구를 우선 쓰는 편이 더 빠르고 저렴하다고 안내한다.⁴

이 말은 아주 실용적이다. 웹 검색 도구는 "페이지와 싸우는" 도구가 아니라 "정보를 모으는" 도구다. 그래서 다음 같은 작업에 특히 잘 맞는다.

최신 문서나 릴리스 노트 찾기
여러 출처를 비교해 핵심만 요약하기
특정 기술의 공식 문서 위치 찾기
뉴스, 블로그, API 문서의 최신 변화 정리하기

예를 들어 "Hermes의 브라우저 백엔드 옵션을 최신 문서 기준으로 비교해줘" 같은 요청은 웹 검색이 먼저다. 검색으로 공식 문서를 찾고, 필요한 부분만 읽어 요약하면 끝난다. 이 단계에서 굳이 브라우저를 열 필요는 없다.

좋은 검색 요청은 대개 조건이 붙어 있다. 예를 들면 "공식 문서 우선", "최근 3개월 자료 우선", "가격표 제외", "비교 표로 정리" 같은 식이다. Hermes는 검색을 잘하지만, 검색 방향까지 대신 알아서 완벽히 정해 주지는 않는다. 방향타는 사용자가 쥐고 있어야 한다.

또 하나 중요한 점은 출처 감각이다. 검색 결과는 빨리 모을 수 있지만, 빠르다고 다 믿으면 안 된다. 공식 문서, 릴리스 노트, 저장소 README, 유지보수자가 쓴 글을 우선하고, 오래된 블로그 글은 참고 자료 정도로 다루는 편이 좋다.

웹 검색 도구는 이렇게 생각하면 쉽다. "현장에 나가기 전, 지도를 펴는 단계"다. 빠르고 넓게 볼 때는 검색이 최고다.

브라우저 도구: 클릭과 입력이 필요한 순간의 해결사

브라우저 도구는 웹 검색보다 한 단계 더 적극적이다. 검색이 "찾아 읽기"라면, 브라우저는 "들어가서 움직이기"다. Hermes는 페이지로 이동하고, 스냅샷을 읽고, 버튼을 클릭하고, 입력창에 타이핑하고, 스크롤하고, 키를 누르고, 필요하면 스크린샷을 분석할 수 있다.⁴

이때 Hermes가 페이지를 이해하는 방식도 흥미롭다. 문서에 따르면 페이지는 접근성 트리 기반의 텍스트 스냅샷으로 표현되고, 상호작용 가능한 요소에는 @e1, @e2 같은 참조 ID가 붙는다.⁴ 사람 눈에는 웹페이지지만, Hermes에게는 "조작 가능한 구조화된 지도"처럼 보이는 셈이다.

그래서 브라우저 도구는 이런 상황에 잘 맞는다.

로그인 후에만 보이는 페이지 확인
검색창 입력, 필터 선택, 버튼 클릭
자바스크립트로 동적으로 로드되는 콘텐츠 읽기
폼 작성, 단계별 가입 절차, 대시보드 탐색
시각적 요소가 중요한 페이지에서 스크린샷 분석

반대로 단순한 문서 읽기만 필요하다면 브라우저는 조금 과하다. 브라우저는 강력하지만, 그만큼 느리고 복잡하다. 클릭이 필요한 상황이 아니라면 웹 검색이 더 낫다.

Hermes의 브라우저 환경도 꽤 유연하다. 공식 문서 기준으로 Browserbase, Browser Use, Firecrawl 같은 클라우드 브라우저 제공자를 쓸 수 있고, Camofox 같은 로컬 안티디텍션 모드, 로컬 Chrome CDP 연결, 로컬 Chromium 기반 모드도 지원한다.⁴ 즉, "웹페이지를 자동으로 만진다"는 같은 목표라도 뒤에서 움직이는 엔진은 여러 가지다.

특히 /browser connect로 내 Chrome에 붙는 방식은 재미있고 실용적이다. 이미 로그인해 둔 브라우저 세션을 그대로 활용할 수 있어서, 클라우드 브라우저에서 매번 새로 인증하느라 진이 빠지는 일을 줄여 준다.⁴ 브라우저가 내 눈앞에 보이기 때문에 "지금 대체 뭘 누르고 있지?" 하는 불안도 덜하다.

브라우저 도구를 잘 쓰는 핵심은 두 가지다. 첫째, 페이지 상태를 자주 확인하게 하기다. 둘째, 시각 정보가 중요하면 스냅샷만 믿지 말고 스크린샷 분석도 쓰게 하기다. 웹은 보기보다 변덕스럽다. 버튼 위치가 바뀌고, 팝업이 뜨고, 무한 스크롤이 끼어들고, 콘솔 에러가 숨어 있는 일이 흔하다. 공식 문서가 browser_console과 browser_vision 같은 도구를 함께 제공하는 이유도 바로 여기에 있다.⁴

웹 검색과 브라우저, 언제 무엇을 쓸까

많은 초보자가 이 둘을 헷갈린다. 하지만 기준은 생각보다 명확하다.

찾아서 읽기면 웹 검색이다.
들어가서 눌러야 하면 브라우저다.

예를 들어 "공식 문서에서 설치 방법 찾아줘"는 웹 검색에 가깝다. 반면 "로그인 후 대시보드에서 오늘 주문 수를 확인해줘"는 브라우저다. 버튼, 폼, 세션, 자바스크립트, 개인 계정이 걸리기 시작하면 브라우저 차례라고 보면 된다.

헷갈릴 때는 Hermes에게 이렇게 말하면 좋다.

"먼저 웹 검색으로 공식 자료를 찾고, 상호작용이 필요할 때만 브라우저를 열어줘."

이 한 문장만 붙여도 불필요하게 무거운 작업을 줄일 수 있다. 도구를 똑똑하게 쓰는 사람은 더 강한 도구를 먼저 꺼내지 않는다. 더 가벼운 도구로 끝낼 수 있는지부터 확인한다.

실전에서 자주 쓰는 조합

Hermes는 도구 하나만 잘 써도 유용하지만, 진짜 힘은 조합에서 나온다. 많이 쓰는 패턴은 대개 다음 흐름을 따른다.

개발 점검형: 파일 읽기 → 터미널 테스트 실행 → 파일 수정 → 재테스트
리서치형: 웹 검색 → 출처 비교 → 파일로 정리
웹 작업형: 웹 검색으로 공식 경로 확인 → 브라우저 접속 → 클릭/입력 → 결과 요약
운영 점검형: 터미널 로그 확인 → 설정 파일 검토 → 수정안 제시 → 승인 후 반영

예를 들어 "배포 실패 원인을 찾아줘"라는 요청 하나만 해도 실제로는 여러 도구가 연결된다. Hermes는 로그를 보기 위해 터미널을 열고, 설정을 보기 위해 파일을 읽고, 에러 메시지를 검색해 원인을 비교하고, 필요하면 관련 문서를 웹에서 확인할 수 있다. 사용자는 한 문장만 던졌는데, Hermes는 도구 여러 개를 릴레이처럼 이어서 쓴다.

이 지점이 바로 Hermes다운 순간이다. 답변을 멋지게 쓰는 것이 아니라, 문제를 풀기 위해 필요한 행동들을 연결하는 것. 그래서 도구 이해는 선택이 아니라 핵심이다.