HammerAI란 무엇인가요?
HammerAI는 외부 LLM 프록시 모드를 사용하는 로컬 우선 AI 문자 채팅 및 작성 애플리케이션입니다.
이 HammerAI 가이드는 /v1로 끝나는 API 기반, 정확한 공급자 모델 이름, API 키 및 알려진 경우에만 설정해야 하는 선택적 컨텍스트 길이 등 공식 프록시 모드 필드를 사용합니다. 프록시 모드는 캐릭터 채팅 모델 요청을 외부 API로 라우팅하는 반면 HammerAI는 계속해서 로컬 대화 인터페이스를 제공합니다. API 루트와 정확한 모델 이름을 사용하고, 확인된 값이 알려지지 않은 한 컨텍스트 길이를 비워두고, 짧은 응답과 긴 세션을 테스트하기 전에 채팅을 다시 로드하세요.
HammerAI의 공식 Proxy Mode는 외부 OpenAI-compatible 서비스에 문자 채팅 생성 요청을 보냅니다. 4개의 프록시 필드를 사용하며 로컬 모델 다운로드나 HammerAI 호스팅 모델 계정이 필요하지 않습니다.
공식 HammerAI 인터페이스에서 프록시 활성화
- 캐릭터 채팅을 엽니다.
- 오른쪽 패널을 Settings로 전환합니다.
- LLM 메뉴를 찾으세요.
- 아래로 스크롤하여 Proxy를 선택합니다.
- 아래 값으로 프록시 양식을 작성하십시오.
4개의 필드를 TokenHub에 매핑
- Proxy URL:
https://us-api.tokenhub.com/v1 - Proxy Model: TokenHub 모델 카탈로그의 전체 모델 ID
- Proxy API Key: TokenHub API 키
- Proxy Context Length: 선택 사항; 실제 한도를 알 수 없는 경우에는 비워 두세요.
공식 프록시 예제는 전체 요청 경로가 아닌 LM Studio의 /v1와 같은 API 기반을 사용합니다. 최신 HammerAI 버전에서는 실수로 제공된 /chat/completions 또는 /completions 접미사를 잘라낼 수 있지만 /v1 루트를 직접 입력합니다.
웹과 데스크톱의 차이점 설명
TokenHub는 원격 HTTPS 서비스이며 일반적으로 추가 CORS 설정이 필요하지 않습니다. HammerAI의 CORS 지침은 웹 앱이 LM Studio와 같은 로컬 서비스에 연결될 때 적용됩니다. 해당 로컬 서버 지침을 원격 TokenHub URL로 전송하지 마십시오.
프록시 구성을 적용합니다.
저장하고 짧은 메시지 하나를 보낸 후 TokenHub 요청 로그에서 모델 ID를 확인하세요. HammerAI는 일부 서비스에서는 연결이 설정되기 전에 전체 앱을 다시 로드해야 한다는 점에 유의합니다. 4개 필드가 모두 정확하지만 응답이 도착하지 않으면 HammerAI를 다시 로드하고 다시 테스트하세요.
장거리 채팅이 실패한 경우 먼저 Proxy Context Length를 지우거나 수정하세요. 401의 경우 Proxy API Key를 검사합니다. 404의 경우 Proxy URL가 /v1에서 중지되는지 확인하세요. 모델이 없으면 Proxy Model를 다시 복사하세요. 이 네 가지 필드를 확인하는 것은 관련되지 않은 로컬 모델 매개변수를 적용하는 것보다 더 유용합니다.
공식 참고자료
모델 선택 방법
HammerAI 프록시 모드 FAQ
프록시 URL로 무엇을 입력해야 합니까?
/v1로 끝나는 TokenHub API 기반을 입력하세요. HammerAI의 공식 프록시 모드 예제는 전체 요청 경로가 아닌 기본 URL을 사용합니다.
프록시 컨텍스트 길이를 입력해야 합니까?
선택 사항입니다. 모델의 최대 컨텍스트를 모르는 경우 공백으로 두십시오. 그렇지 않으면 정확한 값을 입력하십시오.
저장한 후 프록시가 응답하지 않는 이유는 무엇입니까?
기본 URL, 정확한 모델명, API 키를 확인한 후 채팅을 다시 로드하세요. 공식 HammerAI 가이드에는 일부 서비스에는 전체 다시 로드가 필요하다고 나와 있습니다.
HammerAI는 프록시 모드에서 데이터를 어디로 전송합니까?
해당 캐릭터 채팅에 대한 모델 요청은 구성된 외부 API로 이동하고 HammerAI는 로컬 인터페이스를 제공합니다. 사용하기 전에 각 서비스의 데이터 처리를 검토하세요.
HammerAI 프록시 모드를 안전하게 테스트하려면 어떻게 해야 하나요?
저장 후 채팅을 다시 로드하고, 짧은 메시지를 보내고, 긴 대화를 시작하기 전에 TokenHub 로그에서 정확한 모델 및 요청 상태를 확인하세요.
참고 자료
이 설정은 TokenHub 및 공식 문서를 기준으로 하며, 최종 확인일은 2026-09-08。