WeChat ↔ Claude Code CLI ブリッジ

WeChat を使用してローカルマシンで実行中の claude CLI（Claude Code）に接続します。ブリッジサービスは claude -p --output-format stream-json をベースに、以下をサポートしています：

• テキストメッセージの Claude Code への転送
• 画像をローカルに保存し、プロンプトで必要に応じて通知：ユーザーのリクエストに Claude が必要な場合のみ読み取り（マルチモーダルモデルは Read ツール、テキストのみモデルはビジョン関連 MCP ツールを使用）；画像のみ送信で要件がない場合、Claude は読み込まなくても構いません
• ファイル、音声、ビデオはディスクに保存後、ローカルパスを Claude Code に渡す
• session_id を使用した自動的なコンテキスト続接（--resume）
• WeChat 側での /model / /permission / /stop / /clear / /send の制御

WeChat ブリッジ関連の基層プロトコルを修正する必要がある場合は、wechat_agent_bridge_skills/openclaw-weixin オリジナル SDK を参照できます。

ディレクトリ説明

パス	用途
templates/	独立して実行可能な Node ブリッジサービス
templates/src/ilink.ts	WeChat ilink（ClawBot）HTTP API：メッセージ送受信、メディア暗号化・復号化（Codex バージョンと共有実装）
templates/src/bridge.ts	メインループ：getupdates + claude -p --output-format stream-json
templates/src/usage-footer.ts	トークン / コスト フッター（Anthropic モデル価格、コスト優先は result.total_cost_usd から取得）
templates/bridge.config.example.json	設定テンプレート、bridge.config.json にコピーして使用

前提条件

• Node.js >= 18
• claude CLI がインストールおよびログイン済み（claude auth login、または ANTHROPIC_API_KEY 環境変数を使用）
• WeChat 側で ClawBot / ilink ボットのバインディング完了

インストールと起動

cd wechat-claude-code_agent_bridge-skill/templates
cp bridge.config.example.json bridge.config.json
# bridge.config.json を編集：少なくとも cwd をプロジェクトルートディレクトリに設定
npm install
npm run setup
npm start

WeChat 側コマンド

• /help - ヘルプを表示
• /status - 現在のブリッジ状態を表示
• /clear - セッション削除、タスク終了、キューと追加質問をクリア
• /stop - 現在のタスクを終了
• /stopall - 現在のタスクを終了しキューと追加質問をクリア
• /send <パス> - サーバー上のファイルを WeChat に送信
• /model - 現在のモデルを表示
• /model <名前> - 次のラウンド実行で使用するモデルを設定（sonnet / opus / claude-sonnet-4-6 など）
• /model clear - Claude Code のデフォルトモデルに復帰
• /permission - 現在の permission-mode を表示
• /permission default | acceptEdits | plan | auto | dontAsk | bypassPermissions - モードを切り替え

permission-mode クイックリファレンス

モード	意味
default	各書き込み操作で確認（非対話的下ではほぼ読み取り専用）
acceptEdits（デフォルト推奨）	Edit + 一般的な Bash（mkdir/touch/mv/cp など）を自動承認
plan	読み取り専用分析モード
auto	自動実行（アカウントサポートが必要）
dontAsk	事前承認済みツールのみ実行、その他は自動拒否
bypassPermissions	すべてのチェックをスキップ（信頼できるディレクトリでのみ使用）

bridge.config.json でも設定可能：

• allowedTools: ["Bash(git:*)", "Edit", "Read"]（--allowedTools をそのまま渡す）
• disallowedTools: 同上、--disallowedTools をそのまま渡す
• dangerouslySkipPermissions: true → --dangerously-skip-permissions を渡す（permission-mode をオーバーライド）
• bareMode: true → --bare を渡す：すべてのグローバル設定をスキップ（claude mcp add で設定したグローバル MCP、~/.claude/CLAUDE.md、フック、OAuth など含む）、CI / 隔離環境専用。デフォルト false、ブリッジがユーザーマシンで設定済みの MCP サーバーと設定を直接継承できるようにします。
• bareMode: true → --bare を渡す：すべてのグローバル設定をスキップ（claude mcp add で設定したグローバル MCP、~/.claude/CLAUDE.md、フック、OAuth など含む）、CI / 隔離環境専用。デフォルト false、ブリッジがユーザーマシンで設定済みの MCP サーバーと設定を直接継承できるようにします。

重要な制限事項

本ブリッジは非対話的な claude -p を使用しています。したがって：

• 安定したメッセージブリッジ、セッション続接（--resume <session-id>）、画像パス入力、ファイル返送をサポート
• Cursor バージョンのようなツール呼び出しごとの WeChat 側逐条承認はサポートされていません
• /permission + allowedTools を通じて全体実行範囲を制御する必要があり、ツール実行途中での WeChat 確認ポップアップではありません

セッション続接の詳細

• 各ラウンドの result イベント内の session_id は bridge-state.json に書き込まれます
• 次のラウンドメッセージはデフォルトで --resume <sessionId> で続接し、会話コンテキストを保持します
• sessionTimeoutMs（デフォルト 30 分）を超える非アクティブ期間 → 自動的に新しいセッションを開始
• /clear または /permission <mode> は現在のユーザーの続接セッションをリセット

WeChat へのファイル送信

Claude Code がローカルファイルを主動的に WeChat に返送し、回答に出力する場合：

[SEND_FILE:/絶対パス/ファイル.ext]

ブリッジレイヤーが自動的に識別してファイル（≤25MB）をアップロードします。