v0.14.0이 한 줄짜리 커맨드를 내놨다 — hermes proxy — 커뮤니티가 몇 달째 묻고 있던 통합 문제의 한 묶음을 조용히 삼킨 명령이다. hermes proxy를 한 번 띄우면 로컬에 http://localhost:port 엔드포인트가 선다. 이 엔드포인트는 OpenAI API를 말한다 — 뒤에서 받쳐주는 건 네가 Hermes를 통해 로그인해둔 OAuth 프로바이더 중 아무거나: Claude Pro, ChatGPT Pro, SuperGrok.
실제 결과는 이렇다: OpenAI API만 말할 줄 아는 도구들 — Aider, Cline, Codex CLI, Continue, 그리고 긴 꼬리의 에디터 플러그인들 — 이 이제 이미 들어둔 구독을 통해 Claude Pro, ChatGPT Pro, SuperGrok과 대화할 수 있다. API key를 따로 발급한 적이 한 번도 없는 상태로.
여기가 중요한 지점이다: 이 도구들 대부분이 프로바이더별 청구 관계를 요구한다. Aider로 Claude → Anthropic console에 결제 수단 단 계정. Cline으로 GPT-5 → OpenAI 청구 계정. Codex CLI → 마찬가지. hermes proxy는 이 전부를, 네가 이미 가진 OAuth 세션으로 인증하는 하나의 localhost 엔드포인트로 접어 넣는다.
흐름을 단계별로 본다.
0. 전제
- •Hermes Agent v0.14.0 이상이 설치·설정돼 있어야 한다 (
hermes --version으로 확인) - •
hermes model로 OAuth 구독이 적어도 하나 연결돼 있어야 한다 — Claude Pro, ChatGPT Pro, 또는 SuperGrok
OAuth 프로바이더에 로그인해본 적이 없다면, hermes model을 처음 돌릴 때 프로바이더별 OAuth 흐름을 안내해준다. 실제로 돈 내고 있는 구독을 고르자.
1. proxy 띄우기
hermes proxy
기본적으로 localhost의 빈 포트에 바인드한다. 시작 로그에 URL이 찍힌다 — 복사해두자. 포트를 고정하려면:
hermes proxy --port 11500
길게 도는 프로세스로 띄워둔다 — 하류 도구가 쓰고 있는 동안엔 죽이지 말자. systemd, launchd, tmux, 혹은 그냥 터미널 탭 하나, 다 된다.
2. 하류 도구를 proxy로 향하게 하기
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # 빈 문자열만 아니면 아무거나
aider --model claude-sonnet-4-6
Aider의 --model은 proxy가 네 Hermes 프로바이더 설정에서 해석해 내놓는 모델 이름이다. Claude Pro로 로그인했다면 기본 Claude 모델이 거기 있다. ChatGPT Pro와 SuperGrok도 같다.
Cline (VS Code)
Cline 설정에서 프로바이더를 OpenAI Compatible로 잡는다. 그다음:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(빈 문자열만 아니면 아무거나) - •Model ID: 네 Hermes 설정의 모델 이름(예:
claude-sonnet-4-6,gpt-5.1)
저장. 이제 Cline의 요청은 Hermes를 거친다. 구독 인증은 Hermes가 알아서 한다.
Codex CLI
Codex CLI는 보통 OPENAI_API_BASE와 OPENAI_API_KEY를 본다. Aider와 같은 모양이다:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Hermes를 통해 ChatGPT Pro로 로그인 중이라면, gpt-5-codex 모델이 proxy를 통해 노출되고, Codex CLI는 풀 기능으로 동작한다 — OpenAI 쪽에 청구 관계를 한 번도 만들지 않은 채로.
Continue (JetBrains / VS Code)
Continue 설정을 편집한다 (~/.continue/config.json 또는 UI에서):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
같은 패턴이다. "provider"는 openai 그대로 둔다 — Continue 입장에서는 OpenAI 엔드포인트를 치는 거니까.
3. 동작하는지 확인
curl 한 줄:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
네 Hermes 프로바이더 설정이 노출하는 모델 목록이 돌아와야 한다. 401이 오거나 빈 목록이 돌아오면 proxy는 살아 있는데 Hermes가 살아 있는 OAuth 세션을 못 보고 있다 — hermes model을 다시 돌리고, 실제로 구독 중인 프로바이더를 골라라.
4. 트러블슈팅
- •"Connection refused" — proxy가 안 돌고 있다. 띄워라.
- •"401 unauthorized" — 요청한 모델이 네가 연결한 구독 범위에 없다.
hermes model로 어떤 프로바이더가 살아 있는지 확인. - •"Model not found" — 하류 도구가 쓰는 모델 이름이 Hermes 프로바이더가 노출하는 이름과 안 맞는다.
hermes model list에 나오는 이름을 써라. - •레이트 리미트 — 구독 자체의 한도에 부딪히고 있다 (Claude Pro는 Sonnet 5시간당 50개 안팎; ChatGPT Pro는 별도 쿼터; SuperGrok도 마찬가지). proxy는 별도 레이트 리미터를 안 얹는다 — 프로바이더가 주는 쿼터를 그대로 전달할 뿐이다.
왜 이게 중요한가
OpenAI API는 AI 도구 생태계의 공용어다. 거의 모든 에디터 플러그인과 코드 어시스턴트가 OpenAI를 일순위로, "OpenAI 호환 엔드포인트"를 이순위로 지원한다. 함정은 그 "호환 엔드포인트"가 거의 항상 "API key가 필요하고, 그 말은 청구 계정이 필요하고, 그 말은 네 월 $20짜리 구독이 누군가의 대시보드에서 종량제 계정으로 둔갑한다"는 뜻이라는 점이다.
hermes proxy는 그 문제를 접어버린다. 네 OAuth 구독은 살던 자리에 그대로 있는다. proxy가 localhost에서 OpenAI를 말한다. Aider, Cline, Codex CLI, Continue — 이 도구들은 자기가 Claude나 Grok과 대화하고 있다는 걸 모른다. 그저 동작하는 OpenAI 엔드포인트가 보일 뿐이다.
구독 하나, 모든 도구, API key 없음. 그게 광고 전부다.