Happy Coder導入ガイド — スマホからClaude Codeを操作する方法

対象読者

Claude Codeを日常的に使っていて、外出先からもセッションを操作したい開発者
AIコーディングアシスタントに興味があり、モバイルワークフローを試したいエンジニア
リモートワークやフリーランスで、場所を選ばず開発を続けたい人
チームリーダーやテックリードで、移動中にAIエージェントの進捗を確認したい人

前提知識：ターミナル操作の基本、Node.jsの基礎知識、Claude Codeの基本的な使い方

Happy Coderとは

Happy Coderは、Claude CodeやCodexをスマホやWebブラウザから操作できる無料・オープンソースのモバイルクライアントです。Bulka, LLCが開発し、2025年5月にリリースされました。

GitHubスターは約12,100（2025年6月時点）。App Storeの評価は4.9/5（467件のレビュー）で、短期間のうちに支持を集めています。

ターミナルで動いているClaude Codeのセッションを、そのままスマホに映し出せるのが基本的な仕組みです。メッセージの送信やファイルの確認、権限の承認まで、すべてモバイルからできます。

PCの前にいなくてもClaude Codeを使いたい場面

Claude Codeはターミナルベースのツールなので、PCがないと操作できません。ただ、実際の開発現場ではこういう場面がよくあります。

大規模なリファクタリングをClaude Codeに任せたが、完了通知をスマホで受け取りたい
通勤中の電車で、コードレビューの指示を出したい
ミーティング中に、バックグラウンドで動いているエージェントの進捗を確認したい
カフェでスマホだけで簡単な修正を指示したい

Happy Coderはこうした場面をエンドツーエンド暗号化つきでカバーします。ユーザーからは「スマホだけで2本の技術記事を20〜30分で執筆できた」「PCワークフローと同等の速度を実現できる」といった声も上がっています。

Happy Coderの7つの機能

1. リアルタイム双方向同期

PCのClaude Codeセッションとモバイルアプリがリアルタイムで同期します。ターミナルの出力はミリ秒単位でスマホに表示され、スマホから送ったメッセージもすぐにClaude Codeに届きます。

PCとスマホに主従関係はありません。どちらのデバイスからでも会話を開始し、メッセージの送受信ができます。

2. エンドツーエンド暗号化

通信はすべてQRコードで共有した秘密鍵で暗号化されます。AES暗号化と公開鍵認証を組み合わせた方式です。

中継サーバーは暗号化されたデータを転送するだけ。サーバー側でコードの内容を読み取ることはできません。

3. マルチセッション管理

複数のClaude Codeセッションを同時に実行し、それぞれ独立して管理できます。たとえばフロントエンドとバックエンドで別々のセッションを立ち上げ、スマホから切り替えながら操作する使い方が可能です。

各セッションは独立した状態を持ち、プロジェクトコンテキストや会話履歴も個別に保持されます。アプリを再起動してもセッションは維持されます。

4. プッシュ通知

タスクの完了、エラーの発生、権限の確認要求など、重要なイベントをプッシュ通知で受け取れます。長時間のタスクを実行中でも、スマホを見るだけで状況がわかります。

通知にはディープリンクが含まれており、タップすると該当セッションの該当箇所に直接ジャンプできます。

5. 音声エージェント

音声でClaude Codeに指示を出せます。単なる音声認識ではなく、ElevenLabsの音声認識・合成技術を統合しており、AIが音声の意図を解釈してコード実行要求に変換します。

「テストを全部実行して」と話しかけるだけで、適切なコマンドが実行される仕組みです。

6. カスタムエージェント・スラッシュコマンド対応

~/.claude/agents/ に配置したカスタムエージェントや、独自のスラッシュコマンドもモバイルからそのまま使えます。デスクトップで使える機能はすべてモバイルでも利用可能です。

MCP（Model Context Protocol）ツールの権限プロンプトにも対応しています。JIRA、GitHub等の外部サービスとの連携時に、モバイル上で許可・拒否を選択できます。

7. 完全無料・オープンソース

MITライセンスで公開されており、テレメトリーやトラッキングは一切ありません。ソースコードはGitHubで確認できます。TypeScript 97.7%で構成されており、コミュニティによる活発な開発が続いています。

仕組み（アーキテクチャ）

Happy Coderは3つのコンポーネントで構成されています。

┌──────────────┐     暗号化データ     ┌──────────────┐     暗号化データ     ┌──────────────┐
│              │ ──────────────────▶ │              │ ──────────────────▶ │              │
│   CLI        │                     │  Relay       │                     │  Mobile App  │
│  (PC上で実行) │ ◀────────────────── │  Server      │ ◀────────────────── │  (スマホ)     │
│              │                     │ (中継のみ)    │                     │              │
└──────────────┘                     └──────────────┘                     └──────────────┘
       │                                    │                                    │
  Claude Codeを                     暗号化blobを                          復号して
  監視・暗号化                       保存・転送                           表示・操作

中継サーバーが必要な理由

スマホとPCは通常、別のネットワーク上にあるため直接通信できません。中継サーバーが両方のデバイスからの接続を受け付ける役割を果たします。ポート開放やIPアドレスの設定は不要です。

中継サーバーにはオフラインファースト設計が採用されています。スマホの接続が一時的に途切れても、サーバーが暗号化データを保持し、接続が回復すると見逃した更新分が自動的に同期されます。

セキュリティの流れ

QRコードスキャンで共有秘密鍵を交換（サーバーには渡らない）
CLIがClaude Codeの出力を秘密鍵で暗号化
暗号化されたデータを中継サーバーに送信
サーバーはデータを保存・転送（中身は読めない）
スマホが受信し、秘密鍵で復号して表示

サーバーを経由しても通信内容が漏れることはありません。

Happy Coderの導入 6ステップ

前提条件

Node.js 20.0.0以上がインストールされていること
Claude Code がインストール済みで、認証が完了していること
スマートフォン（iOS または Android）

Step 1：Claude Codeのインストール（未導入の場合）

Claude Codeをまだ入れていなければ、先にセットアップします。

macOSの場合はHomebrewが手軽です。

brew install claude-code

ほかの環境ではClaude Code公式ドキュメントを参照してください。

インストール後、初回起動で認証を行います。

claude

認証が完了したら Ctrl+C でいったん終了します。

注意: 従来の npm install -g @anthropic-ai/claude-code は廃止予定です。Homebrewまたは公式インストーラーを使ってください。

Step 2：Happy Coder CLIのインストール

npmでグローバルインストールします。

npm install -g happy-coder

バージョンが表示されればOKです。

happy --version

Step 3：モバイルアプリのインストール

お使いのスマートフォンにHappy Coderアプリを入れます。

iOS: App Storeからダウンロード
Android: Google Playからダウンロード

Webブラウザから使いたい場合は app.happy.engineering にアクセスする方法もあります。ただしプッシュ通知を受け取りたい場合はネイティブアプリがおすすめです。

Step 4：CLIを起動してQRコードを表示

ターミナルで以下を実行します。

happy

初回起動時に以下が自動的に行われます。

Claude Codeの認証チェック
暗号化キーペアの生成
QRコードの表示（ターミナル上に出ます）

ここで表示されるQRコードが、デバイス間の暗号化通信の鍵になります。

Step 5：QRコードをスキャンしてペアリング

スマホでHappy Coderアプリを開く
「Connect」または「ペアリング」をタップ
ターミナルに表示されたQRコードをスマホカメラでスキャン
接続が確立されると、アプリにClaude Codeのセッションが表示される

この操作で暗号化の秘密鍵がスマホに安全に転送されます。QRコードには接続情報と暗号鍵が含まれており、中継サーバーには一切送信されません。

注意: QRコードのスクリーンショットは他人に共有しないでください。暗号鍵が含まれているため、第三者にセッションへのアクセス権を与えてしまいます。

Step 6：動作確認

接続が完了したら、以下を確認します。

PC側: ターミナルでClaude Codeが通常通り動作していること
スマホ側: アプリにClaude Codeの出力がリアルタイムで表示されていること
双方向テスト: スマホからメッセージを送信し、PCのClaude Codeに届くこと

ここまでの所要時間は約10分です。

基本的な使い方

セッションの開始

# Claude Codeセッションを開始（デフォルト）
happy

# モデルを指定して開始
happy -m opus

# 権限モードを指定して開始
happy -p plan

# 環境変数を渡して開始
happy --claude-env SOPS_AGE_KEY_FILE=keys.txt

Codexモードで使う

OpenAI Codexも同様にモバイルから操作できます。

happy codex

Geminiモードで使う

Google Geminiにも対応しています。初回のみ認証が必要です。

# 初回認証
happy connect gemini

# セッション開始
happy gemini

# モデルを指定
happy gemini model set gemini-2.5-pro

その他のCLIコマンド

happy auth      # 認証の管理
happy doctor    # 診断の実行（問題が起きた場合）
happy daemon    # バックグラウンドサービスの管理
happy notify    # プッシュ通知のテスト送信

Happy Coderの実践シーン

シーン1：長時間タスクのモニタリング

大規模なリファクタリングやテスト実行をClaude Codeに任せ、プッシュ通知で完了を知る使い方です。

あなた: 「このプロジェクトの全テストを実行して、失敗したものを修正して」
→ PCを離れてミーティングへ
→ スマホに「タスク完了」の通知が届く
→ スマホで結果を確認、追加の指示を出す

CIの待ち時間やビルド時間が長いプロジェクトでは特に役立ちます。

シーン2：通勤中のコードレビュー

電車の中でプルリクエストのレビューをClaude Codeに依頼できます。

スマホから: 「PR #42のコードをレビューして、セキュリティの問題があれば指摘して」
→ Claude Codeがレビューを実行
→ 結果をスマホで確認
→ 修正の指示もスマホから

シーン3：複数プロジェクトの並行管理

フロントエンドとバックエンドのセッションを同時に立ち上げ、スマホから切り替えながら指示を出せます。

# ターミナル1
cd ~/projects/frontend && happy

# ターミナル2
cd ~/projects/backend && happy

スマホのアプリ上でセッションを切り替えて、それぞれに指示を出せます。各セッションのコンテキストは完全に独立しています。

シーン4：権限承認のリモート対応

Claude Codeがファイルの書き込みや外部APIの呼び出しなど、権限が必要な操作を要求した場合、スマホに承認プロンプトが表示されます。タップ一つで許可・拒否を選べるので、PCから離れていても作業が止まりません。

シーン5：音声でのハンズフリー操作

運転中や料理中など手が離せないときでも、音声でClaude Codeに指示できます。「テストを実行して」「最後のコミットを元に戻して」と話しかけるだけです。

競合ツールとの比較

モバイルからClaude Codeを操作する方法はほかにもあります。

項目	Happy Coder	Tailscale + Termius	Claude Remote
セットアップ難易度	簡単（npm install → QRスキャン）	中〜高（VPN設定が必要）	中程度
料金	完全無料	一部有料	不明
E2E暗号化	あり	VPNによる暗号化	不明
音声操作	あり	なし	なし
プッシュ通知	あり	なし	なし
オフライン対応	あり（再接続で自動同期）	VPN接続が必要	不明
マルチセッション	あり	手動で管理	不明
オープンソース	あり（MIT）	Termiusは非OSS	不明

Happy Coderは設定の手軽さとセキュリティを両立している点、そしてClaude Code以外のツールにも対応している点で差がつきます。

セキュリティに関する注意点

Happy Coderはゼロトラスト設計ですが、運用面で気をつけるべきことがあります。

信頼できるデバイスのみでQRコードをスキャンする
公共Wi-Fiでは機密性の高いコマンドの実行を避ける
CLIとアプリは常に最新バージョンに保つ
QRコードのスクリーンショットを他人に共有しない（暗号鍵が含まれるため）
不要になったデバイスのペアリングは解除する

よくある質問（FAQ）

Q1. Happy Coderを使うのに追加料金はかかる？

かかりません。Happy Coderは完全無料です。ただしClaude Code自体の利用にはAnthropicのAPIキーまたはサブスクリプションが必要です。Happy Coderはクライアントアプリなので、追加のサーバー費用等は発生しません。

Q2. 中継サーバーにコードが漏れることはない？

ありません。すべてのデータはQRコードで共有した秘密鍵で暗号化されます。中継サーバーが扱うのは暗号化されたblobのみで、平文のデータにアクセスすることは技術的に不可能です。

Q3. PCがスリープするとセッションは切れる？

macOSの場合、Happy CLIはデフォルトで caffeinate を使ってスリープを抑制します。ただし環境変数 HAPPY_DISABLE_CAFFEINATE=true が設定されている場合はスリープします。万が一接続が切れても、オフラインファースト設計により再接続時に自動で同期されます。

Q4. Claude Code以外のAIツールにも対応している？

OpenAI Codex（happy codex）とGoogle Gemini（happy gemini）に対応しています。Geminiは happy connect gemini で初回認証を行ってください。

Q5. 複数のPCからスマホに接続できる？

できます。それぞれのPCで happy を起動し、スマホアプリでセッションを切り替えることで、複数のマシンを1台のスマホから操作できます。

トラブルシューティング

接続に問題がある場合は、まず診断コマンドを実行してください。

happy doctor

よくある問題と対処法

問題	対処法
QRコードが表示されない	`node --version` でNode.js 20以上か確認
スマホに出力が表示されない	アプリを再起動し、再スキャン
CLIがクラッシュする	`npm update -g happy-coder` で最新版に更新
macOSがスリープする	`HAPPY_DISABLE_CAFFEINATE` 環境変数が未設定か確認
Gemini接続に失敗する	`happy connect gemini` で再認証

まとめ

Happy Coderを入れると、Claude Codeがスマホから使えるようになります。QRコードを1回スキャンするだけでE2E暗号化接続が確立され、通勤中のコードレビューやカフェからのバグ対応、ミーティング中のバックグラウンドタスク管理まで、PCの前にいなくても開発が止まりません。

CodexやGemini CLIにも対応しているので、複数のAIコーディングツールを使い分けている場合も1つのアプリで管理できます。MITライセンスで完全無料、GitHubスターは1.2万超。CLIは npm install -g happy-coder、アプリはApp StoreかGoogle Playからどうぞ。

※本記事は2026年2月時点の情報に基づいています。最新の情報はHappy Coder公式サイトをご確認ください。