Claude Codeはコードを書くためだけのツールではありません。同じWi-FiにつないだMacから、自宅のGoogle Home/Nestスピーカーを操作するスクリプトを作り、デバッグし、最後は「ラジオつけて」の一言で動くスキルにまとめる——その一連を実例で解説します。題材は3つ。「問い合わせメールが来たらスピーカーが読み上げる」「radiko(J-WAVE)を流す」「ffmpegで作った自作アンビエントBGMをエンドレス再生する」。とくにradikoでは、一度は「再生不可」と思った問題を、ブラウザの通信解析から突破する過程が、Claude Codeらしいデバッグの好例になりました。
1. Claude Codeは「家のスピーカー」も動かせる
Claude Code(Anthropic公式CLI)は、ファイル操作・コマンド実行・ブラウザ自動化までこなすエージェントです。つまり、やりたいことを言葉で伝えれば、必要なスクリプトを書き、実行し、エラーが出れば原因を調べて直すところまで任せられます。これはWeb開発に限った話ではありません。
本記事では、その応用として「自宅のGoogle Home/Nestスピーカーを操作する」を取り上げます。最終的に実現したのは次の3つです。
- 問い合わせメールの音声通知:仕事の問い合わせメールが届くと、スピーカーが「○○からお問い合わせが届きました」と読み上げる
- radiko(J-WAVE)の再生:「ラジオつけて」でリビングのスピーカーから放送が流れる
- 自作アンビエントBGMのエンドレス再生:音源ファイルを用意せず、ffmpegで合成した環境音を流し続ける
どれも特別なハードは不要で、母艦となるMacと無料ツールだけで完結します。順番に見ていきましょう。
2. 仕組みの全体像
Google Home/Nestスピーカーは、内部的にChromecastと同じ「キャスト」の仕組みで音を受け取ります。ポイントは、操作の指示はどこからでも出せても、実際にキャストを実行するのは同一LAN上の機器でなければならないという点です。今回は常時稼働しているMacを母艦にしました。
[音源] [母艦Mac] [スピーカー]
・radiko → 取得・変換(ffmpeg)・ローカルHTTPで配信 → Google Home
・メール通知 → 読み上げ音声を生成 → (同一Wi-Fi内)
・自作BGM → ffmpegで合成 → pychromecast / catt でキャスト
登場するツールは次の3つです。どれも無料で、Claude Codeがインストールから設定まで案内・実行できます。
| ツール | 役割 |
|--------|------|
| catt | コマンドラインからChromecast系デバイスを操作(検出・音量・再生・停止) |
| pychromecast | Pythonライブラリ。生の音声ストリームを「ライブ」として確実に再生させたいときに使う |
| ffmpeg | 音声の取得・変換・合成、そしてローカルHTTPでの配信まで担う万能ツール |
3. 準備するもの
- 母艦となるMac(スピーカーと同じWi-Fiに接続。常時起動が望ましい)
- Google Home / Nest スピーカー(1台でも、グループ=全室同時でも可)
ffmpeg/catt/pychromecast(いずれも無料)
インストールはClaude Codeに任せられますが、手元で行うなら次のとおりです。
# ffmpeg(Homebrew)
brew install ffmpeg
# catt と pychromecast(pip)
pip3 install catt pychromecast
ヒント: 「Claude Codeに調べさせる」のがこの記事の主旨です。上のコマンドも、Claude Codeに「ffmpegとcattを入れて」と頼めば、環境に合わせて実行してくれます。
4. ステップ1:スピーカーを見つける
まずはLAN内のスピーカーを検出します。catt scan で、デバイスの「フレンドリー名」とIPアドレスが分かります。
# デバイス一覧
catt scan
# 例) リビングルーム - 192.168.x.x (Nest Audio)
# ダイニング ルーム - 192.168.x.x (Nest Mini)
# 指定デバイスに音量・再生・停止
catt -d "リビングルーム" volume 30
catt -d "リビングルーム" stop
ここで分かったフレンドリー名(例:リビングルーム)とIPを、以降のスクリプトで使います。グループ(全室同時)も1つのデバイスとして扱えます。
5. 応用①:問い合わせメールを音声で読み上げる
最初の実用例は「仕事の問い合わせメールが届いたら、スピーカーが読み上げる」仕組みです。要素は次の3つに分解できます。
- メールの監視:GmailにIMAPで接続し、直近のメールを定期チェック。パスワードはソースに書かず、macOSのキーチェーンから取得します
- 通知判定:件名に「お問い合わせ」「ご相談」「見積」などのキーワードを含むメールだけを対象にして、システム通知での誤爆を防ぎます
- 読み上げ:差出人ドメインからサイト名を判定し、「○○からお問い合わせが届きました」という文をスピーカーで再生します
これを60秒ごとに動かすには、常駐の仕組みが必要です。macOSならlaunchdが定番です。Claude Codeに「60秒ごとにこのスクリプトを動かして」と頼めば、次のような常駐定義(LaunchAgent)まで作ってくれます。
# 常駐の起動・停止(launchd)
launchctl load ~/Library/LaunchAgents/com.example.mailnotify.plist
launchctl unload ~/Library/LaunchAgents/com.example.mailnotify.plist
# 動いているか確認(PIDが出れば稼働中)
launchctl list | grep mailnotify
つまずき: 短い音声はGoogle Nestが頭切れすることがあります。読み上げ音声の前後に無音を少し足す(パディング)と安定します。こうした「実機でしか分からない癖」も、Claude Codeに症状を伝えれば調整方針を提案してくれます。
この常駐はMacが起動している間だけ動きます。スリープ中は止まる点に注意してください。
6. 応用②:radikoを流す(つまずきと突破)
ここが本記事のハイライトです。最初、ラジオの再生用ツールを使ったところ、配信サーバーに接続できず「このネットワークからは再生できない」と結論づけてしまいました。ところが、同じMacのブラウザでは普通に聴けます。この矛盾が突破口でした。
切り分け:認証と配信を分けて見る
ラジオ配信は「認証サーバー」と「音声を配る配信サーバー(CDN)」に分かれています。到達性を分けて確認すると、認証サーバーには問題なく接続できるのに、ツールが参照する配信サーバーだけがTCPレベルで応答しないことが分かりました。一方でブラウザは聴けている——つまり「ネットワークが全部遮断」ではなく、「ツールが見ている配信先がおかしい」という仮説が立ちます。
ブラウザの実通信を解析する(Claude Codeの強み)
そこでClaude Codeのブラウザ自動化を使い、ブラウザで再生中に実際にアクセスしている配信ホストを、ブラウザのリソース記録(Performance API)から取り出しました。認証トークンなどの機微な情報はURLから除き、ホスト名とパスだけを抽出します。
// ブラウザのコンソールで、読み込まれたリソースのホスト+パスだけを抽出
// (クエリ文字列=トークン等は捨てる)
performance.getEntriesByType('resource')
.map(e => { const u = new URL(e.name); return u.host + u.pathname; })
.filter(s => /\.m3u8|\.aac|stream|playlist|media/i.test(s));
結果は明快でした。ツールが掴んでいた配信ホストと、ブラウザが実際に使っている配信ホストは別物。ツール側が古いホスト名を参照しており、現行の配信ホストは到達可能だったのです。「ネットワークの遮断」は誤診断で、真因は「参照先が古い」でした。
ブラウザと同じ経路で再生する
あとは、ブラウザがやっているのと同じ手順(正規の認証を取得し、現行の配信先から音声を取得)をたどり、ffmpegでMP3に変換してローカルHTTPで配信、それをスピーカーにキャストするだけです。配信形式の細かな相性問題(後述)を回避するため、音声の取得は素直に行い、変換と中継をffmpegに任せました。
# 取得した音声を MP3 化し、ローカルHTTPで待ち受け(ffmpeg)
# … | ffmpeg -f aac -i pipe:0 -c:a libmp3lame -b:a 128k \
# -f mp3 -listen 1 "http://0.0.0.0:8765"
# スピーカーへ「ライブ」として再生(pychromecast)
# mc.play_media("http://<MacのIP>:8765/radio.mp3",
# "audio/mpeg", stream_type="LIVE")
このセクションの学び: 「できない」と感じたら、別経路(ここではブラウザ)で成功している事実と突き合わせる。Claude Codeはブラウザ操作・通信解析・スクリプト修正を1つのセッションで行き来できるので、こうした切り分けが速く回ります。
※ ラジオ配信サービスの利用は各サービスの規約に従ってください。本記事は、ブラウザでの正規の再生経路を同一環境で再現した私的利用の例です。
7. 応用③:自作アンビエントBGMをエンドレス再生
外部の音源がなくても、ffmpeg単体で環境音(アンビエント/ドローン)を作って流し続けられます。やっていることは「複数のサイン波(和音)を合成し、ゆらぎと残響を足す」だけ。aevalsrcに時間長を指定しなければ無限に生成され、そのまま-listenで配信できます。
# A2(110Hz) + E3(164.81Hz) + A3(220Hz) の和音ドローンを無限生成
# tremolo=ゆらぎ / aecho=残響 / lowpass=角を丸める
ffmpeg -f lavfi \
-i "aevalsrc=0.25*sin(2*PI*110*t)+0.18*sin(2*PI*164.81*t)+0.12*sin(2*PI*220*t):s=44100:c=stereo" \
-af "tremolo=f=0.2:d=0.5,aecho=0.8:0.88:60:0.4,lowpass=f=2000" \
-c:a libmp3lame -b:a 128k -f mp3 -listen 1 "http://0.0.0.0:8766"
あとはradikoと同じ要領で、このローカル配信をスピーカーにキャストすれば完成です。再生方式は使い回せるので、「音源が外部のラジオか、自分で合成したBGMか」が違うだけになります。周波数を変えれば雰囲気もすぐ変えられます。集中用BGM、就寝前の環境音など、用途に合わせてClaude Codeに「もっと低めで」「ゆっくり揺らして」と頼めば調整してくれます。
小さな落とし穴: tremoloの周波数は0.1Hz以上という制限があります。「0.08」と指定するとエラーになるので「0.2」などに。こうしたフィルタの制約も、エラーメッセージをClaude Codeに渡せばすぐ直してくれます。
8. 仕上げ:/speakerスキルにまとめる
スクリプトが揃ったら、Claude Codeのスキルにまとめます。スキルはSKILL.mdという手順書で、「いつ使うか(説明文)」と「どう操作するか(手順)」を書いておくだけ。これにより、毎回コマンドや使い方を思い出さなくても、自然な言葉で確実に呼び出せるようになります。
---
name: speaker
description: 自宅のGoogle Homeを操作する。ラジオ再生/停止/音量、
メール通知の状態・設定確認。「ラジオつけて」「音量下げて」等で発動。
---
# おうちスピーカー操作
- ラジオ: ./radiko-proxy.sh [局] [部屋] [音量]
- 自作BGM: ./ambient-play.sh [部屋] [音量]
- 通知の設定一覧: mail-notify.py --config
- トラブル時のポート掃除手順 …
こうしておくと、「J-WAVEかけて」「通知の設定を見せて」と言うだけで、Claude Codeが該当の手順を実行します。操作・設定確認・トラブル対処(後述のポート競合など)まで1か所に集約できるのがスキルの利点です。
Skill か MCP か: 家の中でClaude Codeから使うだけなら、軽量なSkillで十分です。外出先(スマホのアプリ等)から操作したくなったら、母艦を常駐サーバーにするMCP化を検討する、という順番がおすすめです。
9. つまずきポイントまとめ
今回の道中で実際にハマった点を、再発防止用に整理します。どれも「症状をそのままClaude Codeに渡す」と解決が早い類のものでした。
| 症状 | 原因と対処 |
|------|-----------|
| ツールでラジオが再生できない | ツールが参照する配信ホストが古い。ブラウザの実通信から現行ホストを特定して差し替える |
| 変換ツールが配信リストを「非準拠」と拒否 | 配信リストのContent-Typeが厳密判定に通らないケース。形式を解釈させず、音声データを素直に受け取って変換・中継する方式に切り替える |
| スクリプトが連想配列でエラー | macOS標準のbashは3.2で連想配列が使えない。ファイルベースの処理に変更するか、新しいbashを使う |
| 生の音声URLがキャストで弾かれる | 一部のキャストコマンドはURLを動画サイト用に解析しようとする。pychromecastで「ライブ」として直接再生する |
| 「Address already in use」で起動失敗 | 前回のプロセスがポートを掴んだまま。該当プロセスを終了してから再起動する(別ポートでも可) |
まとめ
Claude Codeを使えば、自宅のGoogle Homeを「メール通知の読み上げ」「radikoの再生」「自作BGMのエンドレス再生」へと拡張できます。鍵になったのは、コードを書く力そのものより、「動かしてみて、つまずいて、原因を調べて、直す」を高速で回せることでした。とくにradikoでは、ブラウザの通信解析という別アプローチが、「再生不可」という思い込みを覆しました。
- 母艦Mac+無料ツール(catt / pychromecast / ffmpeg)だけで実現できる
- 「できない」と感じたら、成功している別経路と突き合わせて切り分ける
- 完成したらSkillにまとめ、自然な言葉で呼び出せるようにする
同じ発想は、家電・IoT・日々の雑務の自動化にも応用できます。「コードを書くツール」という枠を外して、身の回りの不便をClaude Codeに相談してみてください。
よくある質問(FAQ)
Q. Claude CodeでGoogle Homeを操作できますか?
A. はい。同じWi-FiにつないだMac(やPC)から、cattやpychromecastといったツール経由でキャストできます。Claude Codeはこれらを呼び出すスクリプトの作成・実行・デバッグまで一貫して行えるため、「ラジオをかけて」「音量を下げて」といった操作をスクリプト化・スキル化できます。
Q. radikoが「再生できない」ときは何を疑えばよいですか?
A. 多くの場合、ツールが参照している配信元(CDN)のホスト名が古いことが原因です。本記事では、ブラウザでは聴けるのにツールでは失敗するケースを、ブラウザの実通信を解析して現行の配信ホストを特定することで解決しました。ネットワーク全体が遮断されていると早合点せず、認証サーバーと配信サーバーを分けて到達性を確認するのが切り分けの近道です。
Q. Macがスリープ中でも鳴りますか?
A. いいえ。スピーカーへ音を送るのは同一LAN上の常駐機(このケースではMac)なので、スリープ・電源オフの間は鳴りません。常時鳴らしたい場合はスリープ抑止(caffeinate等)の併用や、常時起動のマシンを用意します。
Q. 自作BGMはどうやって作るのですか?
A. ffmpegのaevalsrcフィルタで複数のサイン波(和音)を合成し、tremoloやaechoでゆらぎと残響を足すだけで、アンビエント/ドローン系のBGMが作れます。音源ファイルを用意しなくてもコマンド一つで生成し続けられるため、エンドレス再生に向いています。
Q. スキルにすると何が便利ですか?
A. Claude Codeのスキル(SKILL.md)にまとめておくと、「ラジオつけて」「通知の設定を見せて」のような自然な指示で、毎回手順を思い出すことなく確実に実行できます。操作・設定確認・トラブル対処までを1か所に集約でき、再利用性が大きく上がります。