Claude Codeを16ステップビートシーケンサーに変えてみた
はじめに
Claude Code の拡張機能(skills / agents)で 16ステップビートシーケンサーを作った。
Mastra AI Beats Lab , AI エージェントフレームワーク Mastra を使った Web ベースのビートメーカーの仕組みをベースにこれを Claude Code 上で再現し、ターミナルだけでビート生成できるようにした。
/beat "lofi, jazzy, dusty, 92bpm"
これだけで JSON / MIDI / WAV / MP3 が生成される。
作ったもの
デモ
「眠くなるビート」を生成した例:
BPM: 68 Swing: 0.15
| 0| 1| 2| 3| 4| 5| 6| 7| 8| 9|10|11|12|13|14|15|
------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
Kick | X| | | | | | | | X| | | | | | | |
Snare | | | | | | | | | | | | | X| | | |
HiHat | | | | | | | X| | | | | | | | X| |
------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
C4 | O| | | | | | | | O| | | | | | | |
B3 | | | | | O| | | | | | | | | | | |
A3 | | | | | | | | | | | | | O| | | |
------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
Beat |1 | | | |2 | | | |3 | | | |4 | | | |
主な機能
- テキストからビート生成: 「lofi, jazzy」「眠くなる」のようなスタイルプロンプトでビート生成
- マルチフォーマット出力: JSON / MIDI / WAV / MP3
- ASCIIグリッド表示: ターミナルで視覚的に確認
- DAW連携: MIDI 出力で任意の DAW にインポート可能
アーキテクチャ
Claude Code の拡張システムをフル活用した構成:
/beat "<prompt>"
│
▼
┌─────────────────────────────────┐
│ music-reference-agent (haiku) │ ← スタイル解釈
│ プロンプト → BeatSpec YAML │
└─────────────────────────────────┘
│
▼
┌─────────────────────────────────┐
│ music-generation-agent (sonnet)│ ← ビート生成
│ BeatSpec → Beat JSON │
└─────────────────────────────────┘
│
▼
┌─────────────────────────────────┐
│ beatlab-pipeline (skill) │ ← 検証・出力
│ validate → render → export │
└─────────────────────────────────┘
拡張機能の構成
| 種類 | 役割 | ファイル |
|---|---|---|
| Skill | ユーザー向けコマンド /beat
|
.claude/skills/beat/SKILL.md |
| Skill | JSON契約定義 | .claude/skills/beatlab-contract/SKILL.md |
| Skill | パイプラインスクリプト | .claude/skills/beatlab-pipeline/ |
| Agent | スタイル解釈 (haiku) | .claude/agents/music-reference-agent.md |
| Agent | ビート生成 (sonnet) | .claude/agents/music-generation-agent.md |
| Hook | 生成後の自動再生 | .claude/hooks/play-audio.sh |
使い方
セットアップ
git clone https://github.com/ryok/claude-beatlab
cd claude-beatlab
uv sync # Python 環境セットアップ
ビート生成
claude # Claude Code を起動
# スタイルプロンプトでビート生成
/beat "lofi, jazzy, dusty, 92bpm, minimal melody"
# 日本語でも OK
/beat "眠くなるビート"
/beat "激しいビート"
出力ファイル
beats/20260127_043543/
├── beat.json # ビートデータ
├── beat.mid # MIDI (DAW用)
├── beat.wav # オーディオ
└── beat.mp3 # 圧縮オーディオ
実装のポイント
1. 2段階エージェント構成
なぜ 2つのエージェントに分けたのか:
# music-reference-agent (haiku) - 軽量・高速
# スタイル解釈に特化
bpm: 68
swing: 0.15
drum_plan: "Kick on 0, 8; soft snare on 12"
melody_plan: "Single repeating motif (C4, B3)"
density: low
// music-generation-agent (sonnet) - 高精度
// 実際のビートデータ生成
{
"bpm": 68,
"swing": 0.15,
"drumSequence": { "Kick": [0, 8], "Snare": [12] },
"pianoSequence": { "C4": [0, 8], "B3": [4] }
}
メリット:
- haiku で高速にスタイル解釈 → 低コスト
- sonnet で正確な JSON 生成 → 高品質
- 責務分離でデバッグしやすい
2. スキルによる契約定義
beatlab-contract スキルで JSON フォーマットを厳密に定義:
Allowed piano notes (fixed):
C5, B4, A4, G4, F4, E4, D4, C4, B3, A3, G3
Allowed drum sounds (fixed):
Kick, Snare, HiHat, Clap, OpenHat, Tom, Crash, Ride, Shaker, Cowbell
Steps: 0-15 only
これにより:
- エージェントが契約を参照して正確な JSON 生成
- バリデーションスクリプトで検証
- 最大 3回のリトライで品質担保
3. 決定論的パイプライン
AI の出力を Python スクリプトで確実に処理:
# validate.py - JSON 検証・正規化
# render_grid.py - ASCII グリッド生成
# export_midi.py - MIDI 出力
# render_wav.py - オーディオ合成
スクリプトは uv run python で実行し、環境依存を排除。
4. Hooks による自動再生
Claude Code の Hooks 機能を使って、ビート生成完了後に自動でオーディオを再生できる:
// .claude/settings.json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Bash",
"hooks": [{ "type": "command", "command": "bash .claude/hooks/play-audio.sh" }]
}
]
}
}
PostToolUse フックは Bash コマンド実行後にトリガーされる。ffmpeg による MP3 変換完了を検知して afplay (macOS) で再生:
# .claude/hooks/play-audio.sh
if [[ "$command" == *"ffmpeg"* ]] && [[ "$command" == *"beat.mp3"* ]]; then
mp3_path=$(echo "$command" | grep -oE 'beats/[0-9_]+/beat\.mp3')
afplay "$mp3_path" & # バックグラウンド再生
fi
これにより /beat 実行後、生成されたビートが自動的に流れる。
Beat JSON フォーマット
Mastra AI Beats Lab と完全互換の JSON フォーマットを採用。生成したビートを Mastra AI Beats Lab の Web UI で開いて編集・再生することも可能:
{
"bpm": 68,
"swing": 0.15,
"pianoSequence": {
"C4": [0, 8],
"B3": [4],
"A3": [12]
},
"drumSequence": {
"Kick": [0, 8],
"Snare": [12],
"HiHat": [6, 14]
}
}
今後の展望
- Web UI でのビジュアル編集
- ループ再生・リアルタイムプレビュー
- 複数パターンのチェーン再生
- カスタム音源対応
まとめ
Claude Code の拡張システム(skills / agents)を組み合わせることで、テキストベースのビートシーケンサーを実現できた。
特に学んだこと:
- Skills: ユーザー向けコマンド定義と再利用可能な知識のバンドル
- Agents: 異なるモデル(haiku / sonnet)を使い分けた AI タスク実行
- パイプライン: AI 出力を Python スクリプトで確実に処理
- Hooks: ツール実行後のイベントをフックして自動化
Claude Code は単なる AI コーディングアシスタントではなく、拡張可能なプラットフォームとして活用できる。
Discussion