환경 변수 레퍼런스
기준일: 2026-07-26
난이도: 중급
공식 기준: Environment Variables
개요
Hermes Agent가 인식하는 환경 변수 전체 카탈로그입니다. 값은 보통 ~/.hermes/.env 또는 프로세스 env로 주입합니다. 시크릿은 커밋 금지.
핵심 개념
| 카테고리 | 용도 |
|---|---|
| LLM Providers | 해당 하위 변수군 |
| Provider Auth (OAuth) | 해당 하위 변수군 |
| Tool APIs | 해당 하위 변수군 |
| Terminal Backend | 해당 하위 변수군 |
| SSH Backend | 해당 하위 변수군 |
| Container Resources (Docker, Singularity, Modal, Daytona) | 해당 하위 변수군 |
| Persistent Shell | 해당 하위 변수군 |
| Egress proxy (sandbox-injected) | 해당 하위 변수군 |
| Messaging | 해당 하위 변수군 |
| Agent Behavior | 해당 하위 변수군 |
| Interface | 해당 하위 변수군 |
| Session Settings | 해당 하위 변수군 |
| Context Compression (config.yaml only) | 해당 하위 변수군 |
| Auxiliary Task Overrides | 해당 하위 변수군 |
| Fallback Providers (config.yaml only) | 해당 하위 변수군 |
| Provider Routing (config.yaml only) | 해당 하위 변수군 |
상세
카테고리별 가이드
LLM Providers / Provider Auth
- 각 provider API 키·베이스 URL·OAuth 토큰 경로
- 여러 키는 credential pool 설정과 함께 사용 가능
Tool APIs / Skill API Keys / Tool Gateway
- 검색, 이미지, TTS, 브라우저 등 도구 키
- Nous Tool Gateway 구독 경로와 개별 키 경로 병존
Terminal / SSH / Container / Persistent Shell
local/docker/ssh/singularity/modal/daytona백엔드 관련- 컨테이너 리소스 한도, 지속 셸 세션
Messaging 및 플랫폼
- Telegram/Discord/Slack/WhatsApp/Signal/Matrix 등 토큰·allowlist
- Web Dashboard / Desktop
- Microsoft Graph / Teams / LINE / ntfy / IRC / SimpleX 등
Egress proxy / Advanced tuning
- 샌드박스 egress 프록시
- 메시징 고급 튜닝 변수
주요 변수 이름 샘플 (원문 추출)
| 변수 | 메모 |
|---|---|
OPENROUTER_API_KEY |
공식 Environment Variables 문서 참조 |
OPENROUTER_BASE_URL |
공식 Environment Variables 문서 참조 |
FIREWORKS_API_KEY |
공식 Environment Variables 문서 참조 |
HERMES_OPENROUTER_CACHE |
공식 Environment Variables 문서 참조 |
HERMES_OPENROUTER_CACHE_TTL |
공식 Environment Variables 문서 참조 |
NOUS_BASE_URL |
공식 Environment Variables 문서 참조 |
NOUS_INFERENCE_BASE_URL |
공식 Environment Variables 문서 참조 |
OPENAI_API_KEY |
공식 Environment Variables 문서 참조 |
OPENAI_BASE_URL |
공식 Environment Variables 문서 참조 |
LM_API_KEY |
공식 Environment Variables 문서 참조 |
LM_BASE_URL |
공식 Environment Variables 문서 참조 |
COPILOT_GITHUB_TOKEN |
공식 Environment Variables 문서 참조 |
GH_TOKEN |
공식 Environment Variables 문서 참조 |
GITHUB_TOKEN |
공식 Environment Variables 문서 참조 |
HERMES_COPILOT_ACP_COMMAND |
공식 Environment Variables 문서 참조 |
COPILOT_CLI_PATH |
공식 Environment Variables 문서 참조 |
HERMES_COPILOT_ACP_ARGS |
공식 Environment Variables 문서 참조 |
COPILOT_ACP_BASE_URL |
공식 Environment Variables 문서 참조 |
COPILOT_API_BASE_URL |
공식 Environment Variables 문서 참조 |
GLM_API_KEY |
공식 Environment Variables 문서 참조 |
ZAI_API_KEY |
공식 Environment Variables 문서 참조 |
Z_AI_API_KEY |
공식 Environment Variables 문서 참조 |
GLM_BASE_URL |
공식 Environment Variables 문서 참조 |
KIMI_API_KEY |
공식 Environment Variables 문서 참조 |
KIMI_CODING_API_KEY |
공식 Environment Variables 문서 참조 |
KIMI_BASE_URL |
공식 Environment Variables 문서 참조 |
KIMI_CN_API_KEY |
공식 Environment Variables 문서 참조 |
ARCEEAI_API_KEY |
공식 Environment Variables 문서 참조 |
ARCEE_BASE_URL |
공식 Environment Variables 문서 참조 |
GMI_API_KEY |
공식 Environment Variables 문서 참조 |
GMI_BASE_URL |
공식 Environment Variables 문서 참조 |
MINIMAX_API_KEY |
공식 Environment Variables 문서 참조 |
MINIMAX_BASE_URL |
공식 Environment Variables 문서 참조 |
MINIMAX_CN_API_KEY |
공식 Environment Variables 문서 참조 |
MINIMAX_CN_BASE_URL |
공식 Environment Variables 문서 참조 |
KILOCODE_API_KEY |
공식 Environment Variables 문서 참조 |
KILOCODE_BASE_URL |
공식 Environment Variables 문서 참조 |
XIAOMI_API_KEY |
공식 Environment Variables 문서 참조 |
XIAOMI_BASE_URL |
공식 Environment Variables 문서 참조 |
UPSTAGE_API_KEY |
공식 Environment Variables 문서 참조 |
UPSTAGE_BASE_URL |
공식 Environment Variables 문서 참조 |
TOKENHUB_API_KEY |
공식 Environment Variables 문서 참조 |
TOKENHUB_BASE_URL |
공식 Environment Variables 문서 참조 |
AZURE_FOUNDRY_API_KEY |
공식 Environment Variables 문서 참조 |
AZURE_FOUNDRY_BASE_URL |
공식 Environment Variables 문서 참조 |
AZURE_ANTHROPIC_KEY |
공식 Environment Variables 문서 참조 |
ANTHROPIC_API_KEY |
공식 Environment Variables 문서 참조 |
AZURE_TENANT_ID |
공식 Environment Variables 문서 참조 |
AZURE_CLIENT_ID |
공식 Environment Variables 문서 참조 |
AZURE_CLIENT_SECRET |
공식 Environment Variables 문서 참조 |
AZURE_CLIENT_CERTIFICATE_PATH |
공식 Environment Variables 문서 참조 |
AZURE_FEDERATED_TOKEN_FILE |
공식 Environment Variables 문서 참조 |
AZURE_AUTHORITY_HOST |
공식 Environment Variables 문서 참조 |
IDENTITY_ENDPOINT |
공식 Environment Variables 문서 참조 |
MSI_ENDPOINT |
공식 Environment Variables 문서 참조 |
HF_TOKEN |
공식 Environment Variables 문서 참조 |
HF_BASE_URL |
공식 Environment Variables 문서 참조 |
GOOGLE_API_KEY |
공식 Environment Variables 문서 참조 |
GEMINI_API_KEY |
공식 Environment Variables 문서 참조 |
GEMINI_BASE_URL |
공식 Environment Variables 문서 참조 |
ANTHROPIC_BASE_URL |
공식 Environment Variables 문서 참조 |
ANTHROPIC_TOKEN |
공식 Environment Variables 문서 참조 |
DASHSCOPE_API_KEY |
공식 Environment Variables 문서 참조 |
DASHSCOPE_BASE_URL |
공식 Environment Variables 문서 참조 |
ALIBABA_CODING_PLAN_API_KEY |
공식 Environment Variables 문서 참조 |
ALIBABA_CODING_PLAN_BASE_URL |
공식 Environment Variables 문서 참조 |
DEEPSEEK_API_KEY |
공식 Environment Variables 문서 참조 |
DEEPSEEK_BASE_URL |
공식 Environment Variables 문서 참조 |
NOVITA_API_KEY |
공식 Environment Variables 문서 참조 |
NOVITA_BASE_URL |
공식 Environment Variables 문서 참조 |
NVIDIA_API_KEY |
공식 Environment Variables 문서 참조 |
NVIDIA_BASE_URL |
공식 Environment Variables 문서 참조 |
STEPFUN_API_KEY |
공식 Environment Variables 문서 참조 |
STEPFUN_BASE_URL |
공식 Environment Variables 문서 참조 |
OLLAMA_API_KEY |
공식 Environment Variables 문서 참조 |
OLLAMA_BASE_URL |
공식 Environment Variables 문서 참조 |
XAI_API_KEY |
공식 Environment Variables 문서 참조 |
XAI_BASE_URL |
공식 Environment Variables 문서 참조 |
MISTRAL_API_KEY |
공식 Environment Variables 문서 참조 |
AWS_REGION |
공식 Environment Variables 문서 참조 |
AWS_PROFILE |
공식 Environment Variables 문서 참조 |
BEDROCK_BASE_URL |
공식 Environment Variables 문서 참조 |
HERMES_QWEN_BASE_URL |
공식 Environment Variables 문서 참조 |
OPENCODE_ZEN_API_KEY |
공식 Environment Variables 문서 참조 |
OPENCODE_ZEN_BASE_URL |
공식 Environment Variables 문서 참조 |
OPENCODE_GO_API_KEY |
공식 Environment Variables 문서 참조 |
OPENCODE_GO_BASE_URL |
공식 Environment Variables 문서 참조 |
CLAUDE_CODE_OAUTH_TOKEN |
공식 Environment Variables 문서 참조 |
HERMES_MODEL |
공식 Environment Variables 문서 참조 |
VOICE_TOOLS_OPENAI_KEY |
공식 Environment Variables 문서 참조 |
HERMES_LOCAL_STT_COMMAND |
공식 Environment Variables 문서 참조 |
HERMES_LOCAL_STT_LANGUAGE |
공식 Environment Variables 문서 참조 |
HERMES_HOME |
공식 Environment Variables 문서 참조 |
HERMES_GIT_BASH_PATH |
공식 Environment Variables 문서 참조 |
HERMES_DISABLE_WINDOWS_UTF8 |
공식 Environment Variables 문서 참조 |
HERMES_KANBAN_HOME |
공식 Environment Variables 문서 참조 |
HERMES_KANBAN_BOARD |
공식 Environment Variables 문서 참조 |
HERMES_KANBAN_DB |
공식 Environment Variables 문서 참조 |
HERMES_KANBAN_WORKSPACES_ROOT |
공식 Environment Variables 문서 참조 |
HERMES_KANBAN_DISPATCH_IN_GATEWAY |
공식 Environment Variables 문서 참조 |
HERMES_PORTAL_BASE_URL |
공식 Environment Variables 문서 참조 |
HERMES_NOUS_MIN_KEY_TTL_SECONDS |
공식 Environment Variables 문서 참조 |
HERMES_NOUS_TIMEOUT_SECONDS |
공식 Environment Variables 문서 참조 |
HERMES_DUMP_REQUESTS |
공식 Environment Variables 문서 참조 |
HERMES_PREFILL_MESSAGES_FILE |
공식 Environment Variables 문서 참조 |
HERMES_TIMEZONE |
공식 Environment Variables 문서 참조 |
PARALLEL_API_KEY |
공식 Environment Variables 문서 참조 |
FIRECRAWL_API_KEY |
공식 Environment Variables 문서 참조 |
FIRECRAWL_API_URL |
공식 Environment Variables 문서 참조 |
TAVILY_API_KEY |
공식 Environment Variables 문서 참조 |
SEARXNG_URL |
공식 Environment Variables 문서 참조 |
TAVILY_BASE_URL |
공식 Environment Variables 문서 참조 |
GROQ_BASE_URL |
공식 Environment Variables 문서 참조 |
EXA_API_KEY |
공식 Environment Variables 문서 참조 |
BRAVE_SEARCH_API_KEY |
공식 Environment Variables 문서 참조 |
BROWSERBASE_API_KEY |
공식 Environment Variables 문서 참조 |
BROWSERBASE_PROJECT_ID |
공식 Environment Variables 문서 참조 |
BROWSER_USE_API_KEY |
공식 Environment Variables 문서 참조 |
FIRECRAWL_BROWSER_TTL |
공식 Environment Variables 문서 참조 |
BROWSER_CDP_URL |
공식 Environment Variables 문서 참조 |
추출된 고유 대문자 식별자 약 637개. 전체 의미·기본값은 공식 문서를 따릅니다.
관리 팁
# ~/.hermes/.env 권한
chmod 600 ~/.hermes/.env
- 프로파일별 env 분리 가능 여부 확인
- CI에서는 시크릿 스토어 주입
- 사용하지 않는 플랫폼 토큰 제거
체크리스트
- 필요한 명령/설정만 골라 로컬에서 확인했다
- 시크릿·토큰 env 이름을 문서와 대조했다
- 버전 차이에 대비해 공식 원문도 북마크했다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스