Monica

日本語

简体中文
English
Tiếng Việt
Русский

日本語

简体中文
English
Tiếng Việt
Русский

テーマ

JoyinJoester2026-09-28
822
3.9m

Android API Key とローカルモデルプロキシ ​

1.0.101 · Monica CLI インストールとリリース · GitHub Release

Android の MDBX に保存した API Key を参照し、Monica がローカル URL と取り消し可能なローカル Key を生成します。上流の秘密鍵はクライアントに渡しません。

本人の端末で実行します。ENTRY_ID は library の UUID です。要求されたらマスターパスワードを入力します。

sh
monica library
monica bind work-ai --entry <ENTRY_ID> --protocol openai
monica grant model-client --connection work-ai --repo "*" --operation model-list --operation model-invoke --ttl-minutes 240 --max-calls 1000
monica proxy-config model-client --output ./model-client.json
monica serve --proxy-grant model-client --session-minutes 60

JSON の base_url と api_key を信頼できるクライアントに設定します。ファイルを Git やプロンプトに含めないでください。OpenAI は http://127.0.0.1:47831/v1、Anthropic は http://127.0.0.1:47831 です。Anthropic 用の保存済み Key は --protocol anthropic で別にバインドします。プロトコル変換や自動切替はありません。

JSON と SSE に対応します。OpenAI は responses/chat completions、Anthropic は messages/count_tokens、両方で models を利用できます。上流は HTTPS のみです。WebSocket とバックグラウンド Responses は未対応です。

monica serve --proxy-grant model-client --session-minutes 60 を実行し、マスターパスワードで指定したモデル権限の1時間のプロキシセッションを承認します。複数の権限には --proxy-grant を繰り返します。起動時に実際の期限を表示します（JSON: ready.data.proxy_sessions）。承認されたプロキシは通常の5分の再認証・アイドル制限を超えて利用できますが、Tiga の絶対期限（既定の Multi は解錠から2時間）、プロセスと権限の期限を超えません。項目・分類の厳しいポリシーも適用されます。通常の表示・MCP 権限は変更されません。オプションを省略すると従来の認証制限が適用され、プロセスの既定時間は5分のままです。

ロック、権限取消、元の項目やポリシーの変更、期限切れで停止します。再開には同じ serve コマンドで本人が再認証します。有効な権限に予算が残っていればローカル Key は継続利用できます。セッションは本機メモリ内だけに存在し、再起動・再解錠後に復元されません。データベース形式と API Key の保存形式は変わらず、Android は既存エンジンのまま利用できます。自動解錠はありません。

renew 後は proxy-config --force で更新してクライアントに再読込します。revoke は権限を取り消し、unbind は元の Android 項目を残します。元の項目を編集した場合は bind --replace と再承認が必要です。

一時 MDBX とローカル TLS 模擬上流で検証済みです。実サービス、Codex、Claude Code の接続試験は未実施です。

中国語の完全なガイド

直接接続：元の Key をクライアント設定へ保存 ​

Monica プロキシを使わない場合は、手動入力の direct-config manual または既にバインドした Android API Key を使う direct-config saved を選べます。Codex / Claude Code の設定ファイルを生成します。出力先は明示必須で、ホストの設定を自動選択しません。

sh
monica direct-config manual --client codex --api-base https://models.example.test --model YOUR_MODEL --output ./codex-direct/config.toml
monica direct-config saved work-ai --client claude --model YOUR_CLAUDE_MODEL --output ./claude-direct/settings.json

手動入力は非表示プロンプト、または --secrets-stdin と {"token":"..."}。保存済み Key はマスターパスワード ({"password":"..."}) を使用し、現在の broker を停止して Tiga のエクスポートと表示権限を確認します。エクスポート禁止は回避できません。Codex は OpenAI、Claude Code は Anthropic の接続を使用します。

Codex はドメインのみの URL に /v1 を追加します。Claude Code は末尾の /v1 を除き SDK にパスの追加を任せます。HTTPS API ベースと明示的なモデル ID が必要です。完全な /responses や /messages は指定しません。

既存ファイルには --force が必要です。無関係な設定を保持し、変更前に私有 .monica-<UUID>.bak バックアップを作成します。不正・曖昧な形式は変更せず拒否し、同じ設定の再実行でバックアップを増やしません。Unix 0600 / Windows 私有 ACL を使用します。

設定には元の Key が平文で保存されます。 Monica の期限、回数、失効、ロックは直接接続に適用されません。停止するには上流で Key を失効・更新し、設定とバックアップも更新してください。Android の元のデータは保持されます。監査と既存のルート分類修復では書き込みが発生する場合があります。

Recent Update