WeChat Claude Code ブリッジ

個人 WeChat から、ローカルの Claude Code とチャットできます。

前提条件

• Node.js >= 18
• macOS（daemon は launchd で管理）
• 個人 WeChat アカウント（QR コードスキャンでバインドが必要）
• Claude Code のインストール済み（@anthropic-ai/claude-agent-sdk）

インストール

cd ~/.claude/skills/wechat-claude-code
npm install

postinstall スクリプトが自動的に npm run build を実行し、TypeScript をコンパイルします。

起動トリガー

ユーザーが「WeChat ブリッジ」「WeChat チャット」「wechat bridge」「WeChat に接続」「WeChat ステータス」「WeChat 停止」など、WeChat ブリッジに関連するトピックについて言及した場合に起動します。

起動後の実行フロー

起動時は、何もせずにまず現在の状態を確認してから、利用可能な操作を提示してください。

以下の状態を順序に沿って確認します：

ステップ 1：インストール状態の確認

cd ~/.claude/skills/wechat-claude-code && test -d node_modules && echo "installed" || echo "not_installed"

• not_installed の場合：ユーザーに cd ~/.claude/skills/wechat-claude-code && npm install を実行するよう案内し、ここで終了します。

ステップ 2：WeChat アカウントのバインド状態確認

ls ~/.wechat-claude-code/accounts/*.json 2>/dev/null | head -1

• アカウントファイルがない場合：まず setup を実行して QR コードをスキャンしてバインドする必要があることをユーザーに案内し、実行するかどうか確認します。
• アカウントファイルがある場合：次のステップへ進みます。

ステップ 3：Daemon 実行状態の確認

cd ~/.claude/skills/wechat-claude-code && npm run daemon -- status

ステップ 4：状態に応じた情報表示

Daemon が実行中でない場合：

WeChat ブリッジはバインド済みですが、実行中ではありません。

利用可能な操作：
  setup    QR コードを再度スキャンしてバインド（アカウント変更または期限切れの場合に使用）
  start    サービスを起動
  logs     前回の実行ログを表示

Daemon が実行中の場合：

WeChat ブリッジは実行中です（PID: xxx）。

利用可能な操作：
  stop     サービスを停止
  restart  サービスを再起動（コード更新後に使用）
  logs     実行ログを表示

WeChat 側のコマンド（WeChat で直接送信）：
  /help    ヘルプを表示
  /clear   現在のセッションをクリア、新しい対話を開始
  /status  現在のセッション状態を表示
  /model   Claude モデルを切り替え
  /skills  インストール済み skill を表示

ユーザーが明確に操作を指定した場合（「WeChat を起動」「WeChat サービスを停止」「ログを見る」など）は、状態表示をスキップして対応するコマンドを直接実行します。

サブコマンドリファレンス

すべてのコマンドの作業ディレクトリは ~/.claude/skills/wechat-claude-code です。

コマンド	実行内容	説明
setup	npm run setup	初期インストールウィザード：QR コード生成 → WeChat でスキャン → 作業ディレクトリ設定
start	npm run daemon -- start	launchd デーモンを起動（起動時自動実行、自動再起動）
stop	npm run daemon -- stop	デーモンを停止
restart	npm run daemon -- restart	デーモンを再起動
status	npm run daemon -- status	実行状態を表示
logs	npm run daemon -- logs	最新のログを表示（tail -100）

権限承認

Claude がツール実行をリクエストすると、WeChat に権限リクエストメッセージが送信されます：

• y または yes で許可
• n または no で拒否
• 60 秒以内に返信がない場合は自動的に拒否され、通知されます

データディレクトリ

すべてのデータは ~/.wechat-claude-code/ に保存されます：

~/.wechat-claude-code/
├── accounts/       # バインドされた WeChat アカウントデータ（アカウントごとに 1 つの JSON）
├── config.env      # グローバル設定（作業ディレクトリ、モデル、権限モード）
├── sessions/       # セッションデータ（アカウントごとに 1 つの JSON）
├── get_updates_buf # メッセージポーリング同期バッファ
└── logs/           # 実行ログ（日次でローテーション、30 日間保持）