GodotでClaudeを使う：設定、MCP、テスト

エンジンを変更せずに、Godot開発でClaudeを利用できます。最初に確認すべきなのは、プロジェクトファイル、ターミナル、エディター操作、ログ、実行中のゲームにアクセスできるかです。

このガイドはSummer Engineチームによるものです。公式ドキュメントに基づく設定方法と検証手順を紹介しており、モデル間の性能比較や、すべての構成を実機検証したという主張ではありません。

作業環境を選ぶ

Claude Codeはファイルの編集とコマンド実行に対応しています。Cursorにもターミナルツールがあります。正しいプロジェクトを開き、Godotの実行ファイルと権限を確認してください。

独自の連携を作る場合は、必要な操作を実装し、実際の結果と失敗を返す必要があります。モデルを導入しただけでは、テスト環境は完成しません。

具体的な情報を渡す

エンジンのバージョン、project.godotの場所、メインシーン、関連するノードのパスと入力アクションを伝えます。エラー文と再現手順も添えてください。

最初の依頼例：「プレイヤーのシーンと移動スクリプトを読み、変更前にジャンプの仕組みを説明してください。既存の入力アクションを保ったまま空中ジャンプを1回追加し、確認項目を挙げてください。無関係なシーンは変更しないでください。」

Gitでチェックポイントを作り、差分を確認します。

実行して結果を確かめる

Godotの公式ガイドにはコマンドライン操作が記載されています。以下はgodotがPATHにある場合の例です。実行ファイルとプロジェクトの場所は環境に合わせて置き換えてください。

godot --version
godot --headless --path "/path/to/project" --editor --quit
godot --path "/path/to/project"

2番目のコマンドは起動・インポートの確認であり、全シーンのテストではありません。最後のコマンドはプロジェクトを起動し、終了するまで動作します。出力を読み、地上ジャンプ、追加の空中ジャンプ、着地後の回復を試します。以前の操作も確認してください。

ヘッドレス実行では、見た目、音量のバランス、操作感までは判断できません。実際のゲームを見てプレイする必要があります。

必要なツールをMCPで追加する

MCPはClaude Codeを外部ツールに接続する仕組みです。シーンの確認、ノード編集、診断などを提供するサーバーがありますが、機能は実装ごとに異なります。実際のツール一覧を確認し、最初は変更を伴わない読み取りを試してください。

必要なツールがあれば、エディター外のエージェントも実行結果を利用できます。エージェントの表示場所だけで能力は決まりません。

SummerではClaude Code設定ガイドまたはMCP概要を参照してください。概要ページは、設定欄に貼り付けるサーバーURLではありません。

Summerの位置づけ

SummerはGodotベースのエディター、AIワークフロー、エージェント用ツールを提供します。既存プロジェクトを使う際は、プラグインとエクスポート要件を確認してください。

エディターは無料でダウンロードできます。ホスト型AIとアセット生成には有料プランがあります。デスクトップアプリはプロプライエタリで、CLI、MCP、skillsはMITライセンスです。外部エージェントの契約は別途検討してください。

まず1つの仕組みを作り、実行中のゲームで確認してから、動作するチェックポイントを基に進めましょう。