Copy & Run

Hermes Agent의 명령 승인 절차 확인하기

연습용 폴더에서 재귀 삭제를 시켜 보며 Hermes Agent의 smart와 manual 승인 방식, 거부 후 에이전트의 반응, 영구 허용 목록의 범위, deny 규칙, 일회성 실행의 승인 우회를 직접 확인하고, 컨테이너 격리와 터미널 백엔드의 관계를 정리합니다.

실습 노트 · 2026-10-24 발행 · 13분 · 2026-10 확인

에이전트에게 쉘을 주는 순간 가장 중요한 질문은 "무엇을 묻고 지나가는가"입니다. Hermes Agent는 위험한 명령 패턴을 감지하면 사용자 승인을 받는 장치를 갖고 있습니다. 이 글에서는 공식 보안 문서가 설명하는 승인 절차를 연습용 폴더에서 rm -r 같은 무해한 삭제 요청으로 직접 확인합니다. 승인 방식 smart와 manual의 차이, 거부했을 때 에이전트가 하는 행동, 영구 허용 목록이 허용하는 범위, deny 규칙, 그리고 일회성 실행(-z)에서 승인이 생략되는 것까지 다룹니다. 모든 실습은 컨테이너 안의 practice 폴더에서만 합니다.

이 글은 Hermes Agent 실무 시리즈의 3편입니다. 2편 로컬 Ollama 모델 연결하기가 끝난 상태에서 시작합니다. 다음 4편은 MCP filesystem 서버로 접근 범위 제한하기입니다.

준비물

항목 확인한 버전
컨테이너 1편의 cr-hermes-lab (아래 두 파일)
Hermes Agent v0.22.5 (2026.9.24)
모델 2편의 qwen3.8-27b-64k (호스트 Ollama 0.32.15)
터미널 도구 tmux (Dockerfile에 포함, 화면 기록용)

1편의 두 파일을 그대로 씁니다. 같은 내용을 다시 실었습니다. 이 글의 hermes config set과 unset 출력은 실제로는 앞에 체크 표시가 붙지만 아래에서는 생략했습니다.

FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update \
 && apt-get install -y --no-install-recommends curl git ca-certificates tar xz-utils sudo less procps tmux \
 && rm -rf /var/lib/apt/lists/*

# 에이전트는 일반 사용자로 실행합니다.
RUN useradd -m -s /bin/bash agent \
 && echo "agent ALL=(ALL) NOPASSWD:ALL" > /etc/sudoers.d/agent
USER agent
WORKDIR /home/agent
ENV PATH="/home/agent/.local/bin:${PATH}"

# 브라우저 도구는 이 실습에서 쓰지 않으므로 건너뜁니다.
RUN curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use

# 연습용 폴더입니다. 컨테이너 안에서 에이전트가 만지는 파일은 여기에만 둡니다.
RUN mkdir -p /home/agent/practice

CMD ["bash"]
services:
  hermes:
    build: .
    image: cr-hermes:lab
    container_name: cr-hermes-lab
    tty: true
    stdin_open: true
    working_dir: /home/agent
    volumes:
      - hermes-data:/home/agent/.hermes
      - hermes-practice:/home/agent/practice
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      HERMES_DASHBOARD_BASIC_AUTH_USERNAME: admin
      HERMES_DASHBOARD_BASIC_AUTH_PASSWORD: lab-only-pass
      HERMES_DASHBOARD_BASIC_AUTH_SECRET: lab-only-secret-0123456789abcdef
    ports:
      - "127.0.0.1:5500:9119"

volumes:
  hermes-data:
  hermes-practice:

연습용 폴더를 처음 상태로 만드는 스크립트도 만듭니다. 실습 사이사이에 지워진 폴더를 다시 만들 때 씁니다.

#!/bin/bash
# 연습용 폴더를 처음 상태로 되돌립니다. 컨테이너 안에서만 실행합니다.
set -e
P="$HOME/practice"
rm -rf "$P/old-notes" "$P/temp-b"
mkdir -p "$P/old-notes"
echo hello > "$P/memo.txt"
echo a > "$P/old-notes/a.txt"
echo b > "$P/old-notes/b.txt"
ls -R "$P"
docker compose up -d
docker compose exec -T hermes bash -s < reset-practice.sh
# 기대 출력
/home/agent/practice:
memo.txt
old-notes

/home/agent/practice/old-notes:
a.txt
b.txt
이 단계의 파일 내려받기:Dockerfiledocker-compose.ymlreset-practice.sh

승인이 필요한 명령의 종류

공식 문서는 승인 대상 패턴으로 재귀 삭제(rm -r), 권한을 모두에게 여는 chmod 777, mkfs와 dd, 서비스 중지, 쉘 -c 실행과 curl ... | sh 같은 파이프 실행, ~/.ssh/와 ~/.hermes/.env에 쓰는 명령 등을 듭니다. 이 글은 가장 안전하게 시험할 수 있는 재귀 삭제 하나로 확인합니다. 문서에는 어떤 설정에서도 막히는 "하드라인 차단 목록"(rm -rf / 등)도 있는데, 이 글에서는 시험하지 않았습니다.

1. 기본 설정 확인하기

docker compose exec hermes bash -lc 'hermes config get approvals.mode; hermes config get terminal.backend; hermes config get command_allowlist'
# 기대 출력
smart
local
[]

hermes config get으로 승인 방식 smart, 터미널 백엔드 local, 허용 목록이 비어 있음을 확인한 터미널
hermes config get으로 승인 방식 smart, 터미널 백엔드 local, 허용 목록이 비어 있음을 확인한 터미널

승인 방식 approvals.mode의 기본값은 smart, 터미널 백엔드의 기본값은 local, 영구 허용 목록은 비어 있습니다. 세 값의 의미는 다음과 같습니다.

값 의미
smart 보조 LLM이 위험도를 판단합니다. 낮으면 그 명령만 승인하고, 위험하면 거부하고, 애매하면 사람에게 묻습니다
manual 위험한 명령은 매번 사람에게 묻습니다
off 승인 검사를 끕니다. --yolo와 같고, 문서는 CI나 컨테이너 같은 신뢰 환경에서만 쓰라고 경고합니다

2. smart 모드에서 재귀 삭제 시켜 보기

기본값인 smart 그대로 hermes를 열고 삭제를 요청합니다.

docker compose exec -w /home/agent/practice hermes hermes

입력 칸에 다음 문장을 적고 Enter를 누릅니다.

practice 폴더 안의 old-notes 폴더를 rm -r 명령으로 통째로 삭제해 주세요.

이 글의 환경에서는 승인 창이 나오지 않았습니다. 에이전트가 ls -la old-notes로 내용을 확인한 뒤 rm -r old-notes를 바로 실행하고 삭제를 끝냈습니다. 같은 요청을 두 번 시험했는데 두 번 모두 결과가 같았습니다.

smart 모드에서 에이전트가 ls로 확인한 뒤 rm -r old-notes를 승인 질문 없이 실행하고 삭제를 완료했다고 답한 화면
smart 모드에서 에이전트가 ls로 확인한 뒤 rm -r old-notes를 승인 질문 없이 실행하고 삭제를 완료했다고 답한 화면

누가 판단했는지는 로그에서 확인할 수 있습니다.

docker compose exec hermes bash -c 'grep -h "Auxiliary approval" ~/.hermes/logs/agent.log | cut -c1-200'
# 기대 출력
2026-10-24 08:22:17,327 INFO agent.auxiliary_client: Auxiliary approval: using custom (qwen3.8-27b-64k) at http://host.docker.internal:11434/v1/

agent.log에서 보조 승인 판단에 2편에서 연결한 custom 공급자의 qwen3.8-27b-64k가 쓰였다는 줄을 찾은 터미널
agent.log에서 보조 승인 판단에 2편에서 연결한 custom 공급자의 qwen3.8-27b-64k가 쓰였다는 줄을 찾은 터미널

보조 모델 설정이 auto인 상태에서 승인 판단도 같은 로컬 27B 모델이 맡았습니다. 판단을 맡은 모델이 "삭제해 달라는 사용자 요청이 분명하다"고 판단해 통과시킨 것으로 보입니다. 여기서 중요한 점은 다음과 같습니다. smart는 위험도를 모델에게 묻는 방식이라서, 어떤 모델이 판단하느냐에 따라 같은 명령도 결과가 달라질 수 있습니다. 재귀 삭제를 반드시 사람이 승인하게 하려면 manual을 써야 합니다. (판단이 어떻게 이루어졌는지의 세부는 확인하지 못했습니다. 위의 해석은 로그와 결과에서 추정한 것입니다.)

3. manual 모드로 바꾸고 승인 창 보기

docker compose exec -T hermes bash -s < reset-practice.sh
docker compose exec hermes bash -lc 'hermes config set approvals.mode manual'
docker compose exec -w /home/agent/practice hermes hermes

같은 문장으로 다시 요청하면 이번에는 에이전트가 rm -r을 실행하기 직전에 승인 창이 뜹니다.

manual 모드에서 Dangerous Command 창이 rm -r old-notes 명령과 사유 recursive delete, 다섯 가지 선택지를 보여 주는 화면
manual 모드에서 Dangerous Command 창이 rm -r old-notes 명령과 사유 recursive delete, 다섯 가지 선택지를 보여 주는 화면

창에는 실행하려는 전체 명령과 사유(recursive delete)가 나오고, 선택지가 다섯 개 있습니다.

선택 의미
Allow once 이 명령만 허용
Allow for this session 이 세션 동안 같은 종류를 허용
Add to permanent allowlist 허용 목록에 저장해 앞으로 계속 허용
Deny 거부. 기본 선택
Show full command 전체 명령 펼쳐 보기

창 아래에는 남은 시간이 표시되고(295s), 문서에 따르면 approvals.timeout의 기본값 300초 동안 응답이 없으면 거부로 처리됩니다. 방향키로 Deny를 고르고 Enter를 누릅니다. 이 글에서는 Down을 세 번 눌렀습니다.

이 단계의 파일 내려받기:reset-practice.sh

4. 거부했을 때 에이전트의 반응 보기

Deny를 고르자 명령이 실행되지 않았다는 표시가 나오고 에이전트가 재시도하지 않고 사용자의 지시를 기다리겠다고 답한 화면
Deny를 고르자 명령이 실행되지 않았다는 표시가 나오고 에이전트가 재시도하지 않고 사용자의 지시를 기다리겠다고 답한 화면

화면에는 You denied this command - it did not run.과 함께 denied 표시가 나왔고 폴더는 그대로 남았습니다. 에이전트는 "사용자가 거부했으니 같은 명령을 다시 시도하거나 다른 방법으로 우회하지 말고 지시를 기다리라"는 메시지를 받았고, 그대로 멈춰서 "삭제하지 않았다, 확인해 주기 전에는 어떤 파괴적 작업도 다시 하지 않겠다"고 답했습니다. 승인 창은 명령을 막을 뿐 아니라 에이전트에게 멈추라는 신호도 같이 보냅니다.

docker compose exec hermes ls /home/agent/practice
# 기대 출력
memo.txt
old-notes

5. 영구 허용 목록이 허용하는 범위 보기

같은 요청을 다시 하고 이번에는 3. Add to permanent allowlist(Down 두 번)를 고릅니다.

docker compose exec hermes bash -lc 'hermes config get command_allowlist; grep -n -A2 "^command_allowlist" ~/.hermes/config.yaml'
# 기대 출력
  - recursive delete
2454:command_allowlist:
2455-  - recursive delete
2456-onboarding:

허용 목록을 고른 뒤 config.yaml의 command_allowlist에 명령 문자열이 아니라 recursive delete 항목이 저장된 모습
허용 목록을 고른 뒤 config.yaml의 command_allowlist에 명령 문자열이 아니라 recursive delete 항목이 저장된 모습

저장된 것은 old-notes를 지우는 그 명령이 아니라 recursive delete라는 규칙 이름이었습니다. 문서는 허용 목록 항목이 정확한 명령 문자열, 글롭 패턴, 프롬프트에 나온 규칙 이름 중 하나라고 설명합니다. 규칙 이름이 들어가면 그 종류의 모든 명령이 허용된다는 뜻입니다. 확인해 보았습니다. temp-b라는 다른 폴더를 만들어 같은 방식으로 삭제를 시키자 승인 창 없이 곧바로 지워졌습니다.

허용 목록 등록 뒤 temp-b 폴더 삭제를 요청하자 승인 창 없이 rm -r temp-b가 실행된 화면
허용 목록 등록 뒤 temp-b 폴더 삭제를 요청하자 승인 창 없이 rm -r temp-b가 실행된 화면

그래서 "Add to permanent allowlist"는 편의 기능이지만 recursive delete 같은 위험한 규칙에는 쓰지 않는 편이 좋습니다. 항목은 다음 명령으로 지웁니다.

docker compose exec hermes bash -lc 'hermes config unset command_allowlist; hermes config get command_allowlist'
# 기대 출력
Unset command_allowlist from /home/agent/.hermes/config.yaml
[]

문서에 따르면 허용 목록은 시작할 때 읽으므로 이미 열려 있는 세션에는 지운 뒤에도 남아 있을 수 있습니다. 지운 뒤에는 hermes를 다시 시작합니다.

6. deny 규칙 넣어 보기

approvals.deny는 글롭 패턴 목록이고, 일치하는 터미널 명령을 --yolo나 mode: off보다도 먼저 차단합니다. 패턴은 대소문자를 구분하지 않으며 YAML에서 따옴표로 묶어야 한다고 문서가 안내합니다.

docker compose exec -T hermes bash -s < reset-practice.sh
docker compose exec hermes bash -lc 'hermes config set approvals.deny "[\"rm -r*\"]"; hermes config get approvals.deny'
# 기대 출력
Set approvals.deny = ['rm -r*'] in /home/agent/.hermes/config.yaml
  - rm -r*

hermes를 다시 열고 old-notes 폴더를 rm -r 로 삭제해 주세요.라고 요청하면 rm -r 명령은 승인 창도 없이 BLOCKED로 막힙니다. 그런데 에이전트는 거기서 끝내지 않았습니다.

deny 규칙에 걸려 rm -r이 BLOCKED 되었지만 에이전트가 파일을 rm으로 지우고 빈 폴더를 rmdir로 지워 폴더 삭제를 마쳤다고 보고한 화면
deny 규칙에 걸려 rm -r이 BLOCKED 되었지만 에이전트가 파일을 rm으로 지우고 빈 폴더를 rmdir로 지워 폴더 삭제를 마쳤다고 보고한 화면

에이전트는 rm -r이 사용자의 deny 규칙에 막혔다고 알린 뒤, 폴더에 파일이 하나뿐이라는 점을 이용해 rm a.txt와 rmdir old-notes로 같은 결과를 만들었습니다. 최종 보고에는 이 사실을 숨기지 않고 적었지만, 결과적으로 폴더는 지워졌습니다. 공식 문서도 deny 규칙이 운영체제 샌드박스가 아니라 명령 정책이라서 스크립트, 별칭, 이름을 바꾼 실행 파일로 우회될 수 있다고 적고 있습니다. 같은 목적을 이루는 다른 명령은 패턴에 걸리지 않습니다. 중요한 파일을 지키려면 deny 규칙보다 그 파일이 에이전트의 작업 영역에 없게 하는 쪽이 확실합니다.

docker compose exec hermes bash -lc 'hermes config unset approvals.deny'
이 단계의 파일 내려받기:reset-practice.sh

7. 일회성 실행(-z)에서는 승인이 생략됩니다

hermes --help는 -z(--oneshot) 설명에 "approvals are auto-bypassed"라고 적고 있습니다. 승인 방식을 manual로 둔 채로 직접 확인했습니다.

docker compose exec -T hermes bash -s < reset-practice.sh
docker compose exec -w /home/agent/practice hermes bash -lc 'ls; hermes -z "old-notes 폴더를 rm -r 명령으로 삭제하고 결과만 한 줄로 알려 주세요."; echo ---; ls'
# 기대 출력
memo.txt
old-notes
완료: /home/agent/practice/old-notes 폴더를 rm -r로 삭제했고 삭제 확인까지 마쳤습니다.
---
memo.txt

approvals.mode가 manual인데도 hermes -z로 실행하자 승인 질문 없이 old-notes가 삭제된 터미널
approvals.mode가 manual인데도 hermes -z로 실행하자 승인 질문 없이 old-notes가 삭제된 터미널

승인을 묻지 않고 old-notes가 삭제되었습니다. -z는 스크립트나 파이프에서 쓰라고 만든 모드라서 사람이 앉아 있지 않다고 가정합니다. 자동화에 연결할 때는 이 모드가 승인을 끈 것과 같다는 점을 기억해야 합니다. 문서의 approvals.single_query_mode(기본 deny) 같은 값이 어떤 상황에 쓰이는지는 이 글에서 확인하지 못했습니다.

이 단계의 파일 내려받기:reset-practice.sh

8. 대시보드에서 승인 설정 보기

1편의 대시보드가 떠 있다면 Config 화면의 Security 구간에서 같은 값을 볼 수 있습니다.

대시보드 Config의 Security 구간에서 approvals.mode가 manual로 보이고 timeout 300과 cron, single query, unattended 모드가 deny로 표시된 화면
대시보드 Config의 Security 구간에서 approvals.mode가 manual로 보이고 timeout 300과 cron, single query, unattended 모드가 deny로 표시된 화면

approvals.mode는 목록에서 고를 수 있습니다. 헤드리스 상황(cron_mode, single_query_mode, unattended_mode)의 기본값이 모두 deny라는 것도 여기서 한눈에 보입니다.

컨테이너 격리와 터미널 백엔드의 관계

위 실습은 terminal.backend: local에서 했습니다. 즉 Hermes가 컨테이너 안에서 실행되고, 명령도 그 컨테이너 안에서 실행됩니다. 이때 승인 검사는 모두 적용되었습니다.

문서의 터미널 백엔드 표는 docker, modal 같은 컨테이너형 백엔드에서는 위험 명령 검사를 건너뛴다고 설명합니다. 컨테이너가 보안 경계이기 때문이라고 합니다. 그래도 하드라인 차단 목록은 모든 백엔드에 적용됩니다. 두 계층의 관계를 정리하면 다음과 같습니다.

구성 에이전트 명령이 실행되는 곳 위험 명령 승인
이 시리즈 (컨테이너 안에서 Hermes, local) 컨테이너 적용됨 (직접 확인)
호스트에서 Hermes, local 호스트 적용됨. 승인이 유일한 방어선이고 OS 격리는 없음
호스트에서 Hermes, docker 백엔드 별도 컨테이너 건너뜀. 컨테이너가 방어선 (문서 설명, 이 글에서는 시험하지 않음)

이 시리즈가 호스트가 아닌 컨테이너에 Hermes를 두는 이유가 여기에 있습니다. 승인은 사람이 놓칠 수 있고 모델의 판단에 기대는 모드도 있으며(2단계), 허용 목록은 생각보다 넓고(5단계), deny 규칙은 우회될 수 있습니다(6단계). 모든 승인이 뚫려도 피해가 컨테이너와 연습용 볼륨에서 끝나게 하는 것이 마지막 방어선입니다.

자주 막히는 곳

증상 원인과 해결
승인 창이 전혀 안 뜹니다 approvals.mode가 smart이거나 off인지, 허용 목록에 규칙이 있는지 hermes config get으로 확인합니다. hermes -z로 실행해도 뜨지 않습니다
에이전트가 deny된 명령 대신 다른 명령으로 같은 일을 합니다 6단계에서 확인한 동작입니다. 막으려는 것이 폴더나 파일이면 접근 범위를 줄이는 방법을 씁니다. 4편에서 다룹니다
허용 목록을 지웠는데도 계속 허용됩니다 이미 열려 있는 세션은 시작할 때 읽은 목록을 씁니다. hermes를 종료하고 다시 엽니다
승인 창에서 아무것도 안 누르고 5분이 지났습니다 시간이 지나면 거부 처리됩니다. 에이전트가 다시 시도하면 새 승인 창이 뜹니다

이어서 해 볼 것

  • 세션 허용 비교: Allow for this session을 골라서 같은 세션 안에서 두 번째 삭제에서 승인을 묻는지, hermes를 다시 열면 다시 묻는지 확인해 봅니다.
  • 허용 목록 후보 보기: hermes approvals suggest는 지난 승인 기록에서 허용 목록 후보를 제안합니다. 문서에 따르면 재귀 삭제 같은 위험한 종류는 제안하지 않습니다. 이 글에서는 시험하지 않았습니다.
  • 다음 단계: MCP filesystem 서버를 붙이고 접근 범위 제한하기로 이어서, 명령 정책이 아니라 폴더 범위로 막는 방법을 봅니다.

확인 범위

  • 해 본 것: 2026-10-24, Hermes Agent v0.22.5(2026.9.24)와 Ollama 0.32.15의 qwen3.8-27b-64k 모델로 직접 실행했습니다. smart와 manual 모드의 동작, 승인 창의 선택지, 거부 후의 반응, 허용 목록의 recursive delete 규칙과 그 범위, deny 규칙의 차단과 우회, -z의 승인 생략, 대시보드의 Security 구간은 모두 실행 결과입니다. 승인 방식과 deny, 허용 목록의 설명은 공식 보안 문서와 맞춰 보았습니다. -z의 승인 생략은 hermes --help의 설명과 일치했습니다.
  • 해 보지 않은 것: docker와 ssh 백엔드의 동작, 하드라인 차단 목록, hermes approvals suggest, 모델 응답이 매번 같지 않을 때의 smart 모드 판단 변화.
  • 읽을 때 주의: smart 모드의 삭제 요청은 2회 시도했고 나머지는 단계마다 한두 번씩 실행했습니다. 모델의 행동은 매번 다를 수 있어서 에이전트의 문장과 중간 명령은 이 글과 달라질 수 있습니다.

이 글의 다음 단계

AI·LLM 활용 실무 과정의 일부입니다

이 실습은 교육에서 참가자마다 독립된 환경으로 진행합니다. 원하는 일정을 고르면 문의 양식에 미리 채워집니다.

과정 보기

팀이나 교육 담당자에게 이 글 제안하기

교육 진행 순서와 자주 묻는 질문 보기

같은 카테고리의 글