MadoHub Docs

설정

MadoHub 환경설정, API 키, 알림을 구성합니다.

앱 오른쪽 상단에서 설정을 엽니다. 설정 패널에는 일반, 계정, 에이전트, 메모리, 외관, 음성, 로그의 7개 탭이 있습니다.

일반

언어 설정, Claude Code 중지 알림 토글(아래 참고), 시스템 알림 토글, 애널리틱스 옵트아웃, Companion 페어링(로컬 네트워크를 통해 캔버스를 MadoHub iOS 앱에 미러링합니다)이 있습니다.

계정

클라우드 로그인, 현재 플랜, 청구 정보입니다. 에이전트 API 액세스가 사용자가 직접 제공하는 키가 아니라 클라우드로 관리되는 경우, 여기에서 해당 연결을 확인하고 갱신할 수 있습니다.

에이전트

AgentApiConfig로 묶인 에이전트 관련 설정입니다:

공급자

에이전트 간 지능형 라우팅에 사용되는 AI 모델을 구성합니다.

공급자기본 모델API 키 형식
Anthropic (Claude)claude-haiku-4-5-20251001sk-ant-...
OpenAIgpt-4o-minisk-...
Custom (OpenAI 호환)사용자가 지정공급자에 따라 다름

사용자 지정 공급자에는 API 엔드포인트용 Base URL도 설정할 수 있습니다.

연결 테스트

Test Connection 버튼으로 API 키와 모델 구성을 확인합니다. 상태 표시기는 현재 공급자와 모델을 보여주며, 설정되지 않았으면 "No API key set"이라고 표시합니다.

언제 API 키가 필요한가요?

연결에서 ai-routing 또는 summary 변환 유형을 사용할 때만 필요합니다. prompt-wrap, full-output, raw 변환은 API 키 없이 동작합니다.

기타 에이전트 옵션

에이전트 프롬프트 자동 제출, 타일 닫기 확인, 그리고 닫힌 에이전트 타일이 이전 세션 재개를 제안할지 여부를 제어하는 Resume Session 토글입니다. 승인 모드 선택기는 에이전트의 권한 요청을 처리하는 방식을 제어합니다.

메모리

자동 메모리 추출 및 주입을 켜고 끄고, 후보 대기열을 검토합니다. 후보 대기열은 활성 메모리 항목으로 승격되기 전에 승인을 기다리는 메모리 후보들입니다.

외관

테마(다크 또는 라이트)와 터미널 글꼴 크기입니다.

음성

음성 입력을 켜거나 끄고, 그 대상(음성 받아쓰기를 어떤 에이전트 또는 타일로 보낼지)을 선택합니다. 음성 입력은 명령 팔레트(Cmd+Shift+P)에서도 전환할 수 있습니다.

Claude Code 중지 알림

Claude Code가 작업을 마쳤을 때 알림을 켜거나 끕니다. 이 토글은 일반 탭에 있습니다.

활성화하면 MadoHub은 다음을 수행합니다:

  1. ~/.madohub/hooks/claude-stop-notify.sh에 셸 스크립트를 설치하고, 이를 ~/.claude/settings.json의 hooks.Stop['*']에 등록합니다.
  2. Stop 시, 이 스크립트는 ~/.madohub/notifications/{tile}_{timestamp}.json에 JSON 마커 파일을 씁니다.
  3. MadoHub은 해당 디렉터리를 스캔하고, 300초 이내의 마커 파일을 읽은(그 후 삭제하는) 방식으로 완료를 감지합니다.
  4. Claude Code가 중지되면 edge glow 애니메이션을 보여주고 sound를 재생합니다.
  5. 15초 후 자동으로 닫힙니다.

이 기능은 ~/.claude/settings.json과 ~/.madohub/hooks/에 대한 쓰기 권한이 필요합니다.

로그

MadoHub의 로그 파일(~/.madohub/logs/madohub.log)의 마지막 200줄을 확인합니다. 라우팅 문제, 에이전트 감지 문제, 세션 해결 실패를 디버깅할 때 유용합니다.

Refresh를 클릭하면 로그 내용을 다시 불러옵니다.

기록되는 내용

  • 에이전트 상태 변경 및 감지 이벤트
  • 완료 키워드 일치
  • 유휴 타이머 트리거
  • JSONL 세션 해결(PID → sessionId → file)
  • 라우팅 변환 실행
  • 콘텐츠 전달 이벤트
  • 오류 및 경고

On this page