한국어 문서

환경 변수

주요 환경 변수

Hermes Agent의 환경 변수는 기본적으로 ~/.hermes/.env 파일에 둡니다. 프로젝트 루트의 .env가 아닙니다.

hermes config env-path
# 예: /Users/you/.hermes/.env

값을 직접 편집해도 되지만, 권장 방식은 hermes config set입니다.

hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

핵심 원칙

종류	위치
API key, token, password	`~/.hermes/.env`
모델명, provider, backend, timeout	`~/.hermes/config.yaml`
OAuth credential	`~/.hermes/auth.json` 또는 provider별 auth 파일

변수	설명
`OPENROUTER_API_KEY`	OpenRouter API key
`OPENROUTER_BASE_URL`	OpenRouter 호환 base URL override
`ANTHROPIC_API_KEY`	Anthropic Console API key
`ANTHROPIC_TOKEN`	Anthropic OAuth/setup-token 수동 override
`OPENAI_API_KEY`	OpenAI 호환 endpoint API key
`OPENAI_BASE_URL`	vLLM, SGLang, Ollama 등 custom endpoint base URL
`GOOGLE_API_KEY`	Google AI Studio / Gemini API key
`GEMINI_API_KEY`	`GOOGLE_API_KEY` alias
`DEEPSEEK_API_KEY`	DeepSeek API key
`DASHSCOPE_API_KEY`	Alibaba Cloud DashScope / Qwen
`HF_TOKEN`	Hugging Face Inference Providers token
`AI_GATEWAY_API_KEY`	Vercel AI Gateway API key
`GLM_API_KEY` / `ZAI_API_KEY`	z.ai / Zhipu GLM API key
`KIMI_API_KEY`	Kimi / Moonshot API key
`KIMI_CN_API_KEY`	Kimi China endpoint API key
`MINIMAX_API_KEY`	MiniMax global endpoint
`MINIMAX_CN_API_KEY`	MiniMax China endpoint
`COPILOT_GITHUB_TOKEN`	GitHub Copilot API용 token 우선순위 1
`GH_TOKEN`	Copilot fallback 및 GitHub CLI token
`GITHUB_TOKEN`	Copilot fallback token

SSH backend를 사용할 때는 secret을 .env에 둡니다.

TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Vercel Sandbox backend는 다음 값이 필요합니다.

VERCEL_TOKEN=...
VERCEL_PROJECT_ID=...
VERCEL_TEAM_ID=...

.env에 저장한 값을 config에서 참조할 수 있습니다.

model:
  provider: openrouter
  default: anthropic/claude-sonnet-4

auxiliary:
  vision:
    provider: gemini
    api_key: ${GOOGLE_API_KEY}