設定
MadoHub の設定、API キー、通知を構成します。
アプリ右上から設定を開けます。設定パネルには General、Account、Agent、Memory、Appearance、Voice、Logs の 7 つのタブがあります。
General
言語設定、Claude Code の停止通知トグル (下記参照)、システム通知トグル、アナリティクスのオプトアウト、Companion ペアリング (ローカルネットワーク経由でキャンバスを MadoHub iOS アプリにミラーリングします) があります。
Account
クラウドサインイン、現在のプラン、請求情報です。エージェントの API アクセスが自前のキーではなくクラウド管理の場合、ここでその接続を確認・更新できます。
Agent
AgentApiConfig にまとめられたエージェント関連の設定です。
Provider
インテリジェントルーティング でエージェント間の変換に使う AI モデルを設定します。
| Provider | Default model | API key format |
|---|---|---|
| Anthropic (Claude) | claude-haiku-4-5-20251001 | sk-ant-... |
| OpenAI | gpt-4o-mini | sk-... |
| Custom (OpenAI-compatible) | User-specified | Provider に依存 |
カスタム Provider では、API エンドポイントの Base URL も設定できます。
接続テスト
Test Connection ボタンで、API キーとモデル設定を確認できます。状態インジケーターには現在の Provider とモデル、または未設定の場合は "No API key set" が表示されます。
API キーはいつ必要ですか?
接続で ai-routing または summary の Transform を使う場合のみ必要です。prompt-wrap、full-output、raw は API キーなしで動作します。
その他の Agent オプション
エージェントへのプロンプトの自動送信、タイルを閉じる際の確認、そして閉じたエージェントタイルが直前のセッションの再開を提案するかどうかを制御する Resume Session トグルです。承認モードセレクターで、エージェントからの許可プロンプトの扱い方を制御できます。
Memory
自動的なメモリ抽出とインジェクションの切り替え、および候補キューの確認ができます。候補キューとは、アクティブなメモリエントリに昇格する前の承認待ちのメモリ候補です。
Appearance
テーマ (ダークまたはライト) と、ターミナルのフォントサイズです。
Voice
音声入力の有効・無効と、その送信先 (音声の書き起こしをどのエージェントまたはタイルに送るか) を選択できます。音声入力はコマンドパレット (Cmd+Shift+P) からも切り替えられます。
Claude Code Stop Notifications
Claude Code がタスクを完了したときの通知を切り替えます。このトグルは General タブにあります。
有効にすると、MadoHub は次のことを行います。
~/.madohub/hooks/claude-stop-notify.shにシェルスクリプトをインストールし、~/.claude/settings.jsonのhooks.Stop['*']に登録します。- Stop 時に、このスクリプトが
~/.madohub/notifications/{tile}_{timestamp}.jsonに JSON マーカーファイルを書き込みます。 - MadoHub はそのディレクトリをスキャンし、300 秒以内の新しいマーカーを読み取って (その後削除して) 完了を検出します。
- Claude Code が停止すると edge glow アニメーションを表示し、sound を再生します。
- 15 秒後に自動で閉じます。
これには ~/.claude/settings.json と ~/.madohub/hooks/ への書き込み権限が必要です。
Logs
MadoHub のログファイル (~/.madohub/logs/madohub.log) の最後の 200 行を表示します。ルーティングの問題、Agent 検出の問題、またはセッション解決の失敗を調べるのに便利です。
Refresh をクリックするとログ内容を再読み込みできます。
記録される内容
- Agent の状態変化と検出イベント
- 完了キーワードの一致
- アイドルタイマーの発火
- JSONL セッション解決 (PID → sessionId → file)
- ルーティング変換の実行
- コンテンツ配信イベント
- エラーと警告