この記事ではClaude Codeに特化して解説します。Claude Code全般は Claude Code完全ガイド2026:インストールから本番運用まで をご覧ください。

概要

Claude Plugin Weixinは、ClaudeとWeChat(微信)を接続するNode.js製のプラグイン。WeChatのメッセージをトリガーにClaude APIを呼び出し、チャット画面上でAIとの対話を可能にする。中国圏で広く使われるWeChatをインターフェースとすることで、ブラウザやアプリを開かずにClaudeを利用できる環境を構築する目的で開発された。

主な機能

  • WeChatメッセージの自動受信: WeChatに届いたメッセージをリアルタイムで検知し、Claude APIへ転送
  • Claude応答の自動返信: Claude APIから受け取った応答をそのままWeChatのチャット画面に送信
  • 会話コンテキストの保持: 複数回のやり取りを記憶し、文脈を考慮した対話を継続
  • 特定キーワードでのトリガー: 任意のキーワードや条件でClaudeの起動をフィルタリング可能
  • マルチユーザー対応: 複数のWeChatユーザーからの同時利用に対応
  • ログ記録機能: メッセージと応答の履歴をローカルに保存し、後から確認可能
  • Node.js環境で動作: サーバーレスやVPSで常時起動させることで、24時間自動応答を実現

WeChatとClaudeの連携フロー

sequenceDiagram participant U as WeChatユーザー participant W as WeChat
(wechaty経由) participant P as Claude Plugin
Weixin(Node.js) participant C as Claude API
(Anthropic) participant L as ローカルログ U->>W: メッセージ送信 W->>P: メッセージイベント受信 P->>P: キーワードフィルタ判定 P->>C: APIリクエスト
(会話履歴付き) C-->>P: Claude応答 P->>L: ログ保存 P->>W: 応答テキスト送信 W-->>U: WeChatに返信表示

技術スタック

  • 言語: Node.js / JavaScript
  • WeChatクライアント: wechaty(WeChat Web Protocol対応ライブラリ)
  • Claude API: Anthropic公式API
  • 依存パッケージ: axios(HTTP通信)、dotenv(環境変数管理)
  • 実行環境: Node.js 16以上推奨

導入方法

  1. リポジトリをクローン
git clone https://github.com/m1heng/claude-plugin-weixin.git
cd claude-plugin-weixin
  1. 依存パッケージをインストール
npm install
  1. 環境変数を設定
cp .env.example .env

.envファイルにClaude APIキーとWeChatアカウント情報を記入。設定項目の例:

ANTHROPIC_API_KEY=sk-ant-xxxxx
CLAUDE_MODEL=claude-3-5-sonnet-20241022
MAX_HISTORY=10
  1. プラグインを起動
node index.js

初回起動時にQRコードが表示されるので、WeChatアプリでスキャンしてログイン。以降はメッセージ受信時に自動でClaudeが応答する。

WeChatプラグイン設定の重要ポイント .envMAX_HISTORY は会話履歴の保持件数を制御します。値を大きくするほど文脈が豊かになりますが、APIトークン消費も増えます。個人利用なら 10〜20件が現実的な設定値です。また、wechatyはWeb版WeChatプロトコルを使うため、一部アカウント(新規作成直後のアカウント等)はログインが制限される場合があります。安定した動作には一定期間使われた既存アカウントの利用を推奨します。VPS上で常時起動させる際はPM2などのプロセスマネージャーを使うとクラッシュ時の自動再起動が設定できて便利です。

競合比較

ツール名 対応メッセンジャー API方式 会話履歴
Claude Plugin Weixin WeChat Claude API
ChatGPT-on-WeChat WeChat OpenAI API
Slack Claude Bot Slack Claude API
Telegram GPT Bot Telegram OpenAI/Claude

ChatGPT-on-WeChatは同様にWeChatを使うがOpenAI APIに依存し、Claudeには未対応。Slack Claude Botは企業向けSlackに特化しており、個人利用の多いWeChatとは用途が異なる。本ツールはWeChatとClaudeの組み合わせに特化し、中国圏のユーザーにとってアクセスしやすい環境を提供する点で差別化されている。wechatyライブラリを活用することで、Web版WeChatのプロトコルを利用し、公式APIなしでも動作する設計が特徴。

Claudeの自律的なコーディング能力に関心があれば、Claude Code Auto Modeの登場と自律コーディングも参照してください。MCPサーバーを自作してClaudeの機能を拡張したい場合は、MCP Manager:MCPサーバーの一元管理ツールも合わせて確認すると構成の全体像が把握しやすくなります。

活用シーン

Claude Plugin Weixinが力を発揮するシーン
  • 中国圏のユーザー向けAIサポート:VPN経由でClaudeのWebサイトにアクセスせず、日常使うWeChatから直接AIに質問できる環境を構築。翻訳・文章添削・情報検索などをチャット感覚で実行できる。
  • カスタマーサポートの自動化:企業のWeChatアカウントに本プラグインを導入し、顧客からの問い合わせに24時間自動応答。FAQ対応や初期トリアージを人手を介さず処理できる。
  • 個人用AIアシスタント:スマホのWeChatから音声入力やテキストでタスク管理・スケジュール調整・メモ作成を依頼し、Claudeが整理した結果を即座に受け取れる。

こんな人におすすめ

  • 中国圏在住のエンジニア: WeChatを主要なコミュニケーション手段としており、VPNなしでClaudeを活用したい開発者
  • Node.js経験者: wechatyやAPI連携の知識があり、チャットボットを自作・カスタマイズしたいプログラマー
  • 多言語サポートが必要な企業: 中国語ユーザー向けに自動応答システムを構築し、運用コストを削減したいカスタマーサポートチーム
  • プライバシー重視のユーザー: 自前のサーバーでプラグインを動かし、メッセージログを外部サービスに預けず管理したい個人
  • WeChat公式APIが使えない環境: 公式APIの認証取得が難しい個人開発者や小規模チームで、wechatyを使った非公式接続を試したい層

関連記事: Claude Code完全ガイド2026:インストールから本番運用まで

参照ソース