Technology

Claude Code × Godot 4 連携ガイド｜CLAUDE.md 設定・MCP 導入・GDScript プロンプト例【2026年版】

※本記事にはPR・広告リンクが含まれます。

「AIでコードを書かせたいけれど、Godot 用のまとまった情報が少ない」。個人でゲームを作るインディー開発者なら、一度はそう感じたはずです。Web 上の Claude Code 記事は Web 開発や Python が中心で、GDScript やシーンツリーの扱いはほとんど触れられていません。

この記事では、Claude Code と Godot 4 を実務で組み合わせるための設定を、コピペできる形で具体的に解説します。CLAUDE.md テンプレート、godot-mcp の導入、シナリオ別プロンプト例、AIツール比較表、「できないこと」と回避策を順に押さえていきます。たとえば、CharacterBody2D の移動スクリプト生成やシーン横断リファクタは、自然言語1行の指示で完了します。この記事を読み終えれば、その日から Godot プロジェクトで試せる構成です。

情報は2026-07-12時点の公式ドキュメントに基づいて確認しています。

Claude Code と Godot 4 を組み合わせると何ができるか

結論から言うと、Claude Code は Godot プロジェクトの .gd ファイルと .tscn ファイルをテキストとして読み込み、複数ファイルにまたがる編集やコード生成を任せられます。ターミナル上で動くAIコーディングエージェントなので、Godot エディタを開いたまま横で作業を進められるのが強みです。

具体的には、次のような作業を自然言語の指示だけで進められます。GDScript の新規生成、既存スクリプトのリファクタリング、シグナル接続コードの作成などが代表例です。詳細はClaude Code 公式ドキュメントで確認できます。

CharacterBody2D を使ったプレイヤー移動スクリプトを一から生成する
複数の .gd ファイルにまたがる関数名やノード参照を一括で変更する
エラーメッセージを貼り付けて原因の切り分けと修正案を出させる

出典: Godot Engine 公式サイト

なお Claude Code は Anthropic 製で、ターミナル・VS Code・JetBrains・デスクトップアプリ・ウェブで動作します。この記事では CLAUDE.md 設定・MCP 連携・プロンプト例・比較の4点を順に解説していきます。

Claude Code の料金プランと Godot 開発での選び方（2026年7月時点）

まず知っておきたいのは、無料の Free プランでは Claude Code が使えない点です。Godot 開発で使うなら有料プランが前提になります。以下はClaude 料金ページを2026-07-12に確認した内容です。

プラン	月額	Claude Code	デフォルトモデル	Godot開発での用途
Free	無料	非対応	—	—
Pro	$20	対応	Sonnet 4.6	個人インディー・試用
Max 5x	$100	対応	Opus 4.6	週複数プロジェクト並行
Max 20x	$200	対応	Opus 4.6	フルタイム開発・大規模リファクタ
Team	$25/席〜	対応	—	小規模スタジオ

個人インディー開発者は、まず Pro（$20/月、年払いなら $17/月）から始めるのがおすすめです。複数プロジェクトを並行したり大規模なリファクタを頻繁に回すなら、Opus 4.6 が使える Max 5x（$100/月）が候補になります。

複数人のスタジオなら Team（Standard $25/席/月〜）を検討しましょう。

なお各プランの具体的なリクエスト上限は公式に明示されておらず、使用状況によって動的に変動するとされています。上限に達した場合は上位プランへのアップグレードを検討してください。

Step 1 — Claude Code のインストールと初期設定

インストールは1コマンドで完了します。macOS・Linux・WSL では以下を実行してください。所要時間は5分ほどです。

curl -fsSL https://claude.ai/install.sh | bash

インストールできたら、Godot プロジェクトのディレクトリに移動して起動します。プロジェクト内で起動することで、Claude Code がそのフォルダのファイルを認識できるようになります。

cd your-godot-project
claude

初回はブラウザ経由でログインを求められます。認証後、claude --version を実行してバージョンが表示されれば準備完了です。ここまでで、Claude にプロジェクト内のファイルを読ませて指示を出せる状態になりました。

Step 2 — CLAUDE.md で Godot プロジェクト固有の設定を行う

CLAUDE.md は、Claude Code が毎セッション開始時に自動で読み込むプロジェクト設定ファイルです。ここにコーディング規約やビルドコマンドを書いておくと、毎回同じ説明を繰り返さずに済みます。公式ドキュメントでは推奨サイズを200行以下としています。

配置場所はプロジェクト直下の ./CLAUDE.md（または ./.claude/CLAUDE.md）が基本です。/init コマンドで雛形を自動生成できるので、それを Godot 向けにカスタマイズしましょう。以下はそのままコピペして使えるテンプレートです。

# Godot 4 Project

## 実行コマンド
- エディタ起動: `godot --editor`
- スクリプト検証: `godot --headless --editor --quit-after 1`
- GDScript フォーマット: `gdformat .`
- GDScript 静的解析: `gdlint .`

## プロジェクト構成
- /scenes/    — シーンファイル (.tscn)
- /scripts/   — GDScript (.gd)
- /assets/    — テクスチャ・音声

## コーディング規約
- 言語: GDScript（C# は使わない）
- 対象バージョン: Godot 4.7
- 型アノテーションを必ず付ける: `var speed: float = 100.0`
- ノード参照はシグナル経由を優先し、直接パス参照を最小化する
- @export でインスペクタ公開変数を管理
- 物理移動は _physics_process(delta) を使用
- プレイヤーは CharacterBody2D を継承

## 注意事項
- .godot/ ディレクトリは変更しない
- コード変更後は `gdlint .` と `godot --headless --editor --quit-after 1` で検証
- ノードパスは大文字小文字を区別する

このテンプレートの狙いは、Claude が Godot 3 の古い構文へ回帰するのを防ぐことです。対象バージョンや API の使い方を明記しておくと、@export や move_and_slide() など Godot 4 固有の書き方を安定して生成しやすくなります。

なお gdformat . と gdlint . を使うには gdtoolkit の事前インストールが必要です。まだの場合は次の1コマンドで入ります。

pip install gdtoolkit

パスごとのルールを .claude/rules/ で分割する（上級者向け）

プロジェクトが大きくなり CLAUDE.md が200行を超えそうなら、.claude/rules/ ディレクトリでルールを分割できます。YAML frontmatter の paths フィールドを使うと、特定のファイルにだけルールを適用できます。

例えば paths: ["**/*.gd"] と指定すれば、GDScript ファイルを編集するときだけ該当ルールが読み込まれます。UI 用と AI ロジック用でルールを分けたい場合などに便利です。

Step 3 — Godot MCP サーバーで Claude Code にシーンを「見せる」

CLAUDE.md だけでは、Claude はシーンツリーの実際のノード構成を知りません。その結果、存在しないノードパスを推測で書いてしまうことがあります。Summer Engine もこの点を重視し、次のように述べています。

If you only do one thing, connect an MCP server — project awareness is the difference between Claude that helps and Claude that hallucinates node paths.（出典: Summer Engine / best-ai-coding-assistant-for-godot）

これを解決するのが Godot MCP（Model Context Protocol）サーバーです。接続すると、Claude Code がシーンツリー・ノード名・プロパティを直接参照できるようになります。ここでは最もスター数の多い Coding-Solo/godot-mcp を例にします。

出典: Godot Engine 公式リリースページ

godot-mcp のインストール（macOS/Linux）

前提として Node.js 18.0.0 以上と Godot 4.x が必要です。プロジェクトディレクトリで以下を実行します。

# Node.js 18以上が必要
node --version

# Claude Code に godot-mcp を登録（プロジェクトディレクトリで実行）
claude mcp add godot -- npx @coding-solo/godot-mcp

# 動作確認
claude mcp list

Godot の実行パスは GODOT_PATH 環境変数で指定します。~/.claude.json の env セクションに次のように追記します（参考: Qiita のセットアップ手順）。

macOS の場合:

"env": { "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot" }

Linux・WSL の場合: まず which godot でパスを確認してから指定してください。公式バイナリを /usr/local/bin/ に配置している場合は次のようになります。AppImage の場合はダウンロードした .AppImage ファイルのフルパスを指定してください。

"env": { "GODOT_PATH": "/usr/local/bin/godot" }

設定後にできること

godot-mcp を接続すると、Godot エディタの起動、デバッグモードでのプロジェクト実行、コンソール出力・エラーメッセージの取得、シーン管理（作成・ノード追加・スプライト読み込み）などをツールとして呼び出せます。実際の指示は次のようなイメージです。

「現在のシーンに含まれるノードを一覧表示して」→ 実際のシーンツリーを返す
「SplashScene に ColorRect を追加してフェードアニメーションを付けて」→ .tscn を直接編集
デバッグモードでゲームを実行してコンソールのエラーを取得

なお godot-mcp の Godot 4.7 での動作確認はドキュメントに明記されていないため、実際の使用前にご自身のプロジェクトで動作確認することをおすすめします。

実務ワークフロー例とプロンプトパターン

ここからは、そのまま試せるシナリオ別のプロンプト例を紹介します。CLAUDE.md で仕様を固めているぶん、指示は簡潔で済みます。

プレイヤーキャラクター基礎実装

Godot 4.7 で CharacterBody2D を使った 2D プレイヤーコントローラーを GDScript で書いて。
仕様:
- 左右移動: ui_left / ui_right
- ジャンプ: ui_accept（コヨーテタイム 0.1秒付き）
- 重力: ProjectSettings の gravity_2d を参照
- move_and_slide() を使う
- 型アノテーション必須

敵 AI のステートマシン

このプロジェクトのEnemy.gdに、次の3ステートのステートマシンを実装して:
1. Idle: 待機（2秒後に Patrol へ遷移）
2. Patrol: 左右に移動（端に達したら折り返す）
3. Chase: プレイヤーが range_distance 以内に入ったら追いかける
シグナルで遷移イベントを emit する設計にして。

バグ修正のデバッグ支援

このエラーが出ています:
Invalid get index 'position' on base 'Nil'.
At: res://scripts/player.gd:34:_physics_process()
エラーの発生元は player.gd の 34行目 _physics_process() です。
原因と修正方法を教えて。

gdtoolkit + headless 検証の自動化

Claude が書いたコードは、そのまま完成品として扱わず検証を挟むのが安全です。gdtoolkit（gdformat でスタイル補正、gdlint で静的解析）と godot --headless --editor --quit-after 1 のコンパイルチェックを組み合わせると、構文レベルのミスを事前に潰せます。

myudon 氏の実装例では、.claude/commands/code-validate.md に検証コマンドを記述し、Claude Code が変更後に自動実行するフローが紹介されています。Makefile に full-validate タスクをまとめておけば、指示のたびに一貫した品質チェックを回せます。

なお godot --headless の動作はバージョンによって異なる場合があり、Godot 4.7 での挙動は2026-07-12時点で公式に未確認です。パイプラインに組み込む前に、実際の環境でテストすることをおすすめします。

AIツール比較表 — Godot 4 開発での用途別選び方

Claude Code が唯一の選択肢というわけではありません。Godot 向けの主要ツールを用途別に整理しました。GDScript 品質やランタイムデバッグの可否は各ソースの報告に基づく傾向です。

ツール	タイプ	費用	GDScript品質	プロジェクト認識	ランタイムデバッグ	向いているケース
Claude Code	ターミナルエージェント	$20〜/月	高（Godot4ドリフト少）	ファイルレベル	不可	複数ファイル横断の実装・リファクタ
Claude Code + godot-mcp	ターミナル+MCP	$20〜/月	高	シーンツリーまで	部分的（debug出力取得可）	シーン操作・ノード管理も含む開発
Cursor (+MCP)	IDEエージェント	$20/月	モデル依存	MCPあれば高	不可	IDE操作に慣れた開発者・補完重視
GitHub Copilot	IDEオートコンプリート	$10/月	中（Godot3ドリフトあり）	なし	不可	既存IDE継続利用・コスト優先
Summer Engine	AI専用エンジン	無料〜	高	エンジン内部まで	可（自動修正）	実行・テストまで含む完全自動化

出典: Godot Engine 公式リリースページ

Claude Code は「Godot 3 と Godot 4 の構文ドリフトが他ツールより少ない」と複数のソースが報告しています。

既存プロジェクトへのファイル横断のリファクタが強みなので、コードの実装役として据えるのが向いています。

Claude Code では「できないこと」と回避策

導入前に必ず押さえておきたいのが、Claude Code の限界です。Summer Engine はこの制限を端的にこう表現しています。

Claude edits files but cannot press play and read the live runtime error, so it hands you code and you find the runtime bug.（出典: Summer Engine / Claude for Godot）

ランタイムエラーの検知

Claude Code は F5 でゲームを実行し、出力される実行時エラーを読むことができません。null ノードパスやシグナル接続漏れ、CollisionShape2D のない CharacterBody2D といった問題は、ファイルの静的解析では検知できないのです。

回避策は3段構えです。godot-mcp 経由でデバッグ出力を取得し、gdtoolkit で静的検証を行い、headless コンパイルチェックで構文エラーを事前に排除します。これで検知できる範囲をかなり広げられます。

複雑な UI 配置とビジュアル調整

ノードの px 単位の位置を目で見ながら合わせるビジュアル作業も、Claude Code の苦手分野です。大まかなレイアウト構造は Claude に生成させ、細かい位置調整は Godot エディタ上で手動で仕上げる分業がおすすめです。

セキュリティと API キー管理

API キーなどの機密情報は、CLAUDE.md や .gd ファイルにハードコードしないでください。.env ファイルや OS.get_environment() を使い、個人設定は .gitignore 済みの CLAUDE.local.md に限定して記述するのが安全です。

まとめ — Claude Code × Godot 4 を導入すべき開発者とは

Claude Code × Godot 4 が特に向いているのは、複数ファイルにまたがる実装やリファクタを効率化したいインディー開発者です。逆に、実行して初めて分かるランタイムバグの検証まで丸ごと自動化したい場合は、Summer Engine のような実行環境つきツールも比較検討する価値があります。

導入は次の4ステップで始められます。まずは小さなプロジェクトで試し、自分のワークフローに合うか確かめてみてください。

Claude 料金ページで Pro プランに登録する
curl -fsSL https://claude.ai/install.sh | bash でインストールする
プロジェクトに Godot 向け CLAUDE.md を配置する
claude mcp add godot で godot-mcp を登録する

生成されたコードを深く理解して自力でデバッグできると、AIの生産性はさらに伸びます。GDScript の基礎固めには『Godot 4 & GDScriptではじめる 2Dゲーム開発レシピ』など日本語の実践書を1冊手元に置いておくと安心です。

なお本記事の価格・配信状況は変動しやすいため、各サービスの公式サイトで最新情報を確認してください。

文系エンジニアの日記

Claude Code × Godot 4 連携ガイド｜CLAUDE.md 設定・MCP 導入・GDScript プロンプト例【2026年版】

Claude Code と Godot 4 を組み合わせると何ができるか

Claude Code の料金プランと Godot 開発での選び方（2026年7月時点）

Step 1 — Claude Code のインストールと初期設定

Step 2 — CLAUDE.md で Godot プロジェクト固有の設定を行う

パスごとのルールを .claude/rules/ で分割する（上級者向け）

Step 3 — Godot MCP サーバーで Claude Code にシーンを「見せる」

godot-mcp のインストール（macOS/Linux）

設定後にできること

実務ワークフロー例とプロンプトパターン

プレイヤーキャラクター基礎実装

敵 AI のステートマシン

バグ修正のデバッグ支援

gdtoolkit + headless 検証の自動化

AIツール比較表 — Godot 4 開発での用途別選び方

Claude Code では「できないこと」と回避策

ランタイムエラーの検知

複雑な UI 配置とビジュアル調整

セキュリティと API キー管理

まとめ — Claude Code × Godot 4 を導入すべき開発者とは

おすすめ商品

投稿者

バイブコーディング入門｜初心者でもアプリが作れるツール5選と始め方【2026年7月版】

人型ロボットが工場に入った2026年——仕組み・主要5社・価格・日本の現在地をまとめて解説

MCPとは何か？ChatGPT・ClaudeがあらゆるツールとつながるAI連携の新標準

生成AI調達ガイドライン第2.0版で何が変わる？AIエージェント・画像音声対応の要点

コメントを残すコメントをキャンセル

Claude Code と Godot 4 を組み合わせると何ができるか

Claude Code の料金プランと Godot 開発での選び方（2026年7月時点）

Step 1 — Claude Code のインストールと初期設定

Step 2 — CLAUDE.md で Godot プロジェクト固有の設定を行う

パスごとのルールを .claude/rules/ で分割する（上級者向け）

Step 3 — Godot MCP サーバーで Claude Code にシーンを「見せる」

godot-mcp のインストール（macOS/Linux）

設定後にできること

実務ワークフロー例とプロンプトパターン

プレイヤーキャラクター基礎実装

敵 AI のステートマシン

バグ修正のデバッグ支援

gdtoolkit + headless 検証の自動化

AIツール比較表 — Godot 4 開発での用途別選び方

Claude Code では「できないこと」と回避策

ランタイムエラーの検知

複雑な UI 配置とビジュアル調整

セキュリティと API キー管理

まとめ — Claude Code × Godot 4 を導入すべき開発者とは

おすすめ商品

投稿者

Related Posts

コメントを残す コメントをキャンセル

コメントを残すコメントをキャンセル