🎹

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