Anthropicから、Skillsという概念が発表になりました。
これはAIに明確なプロセスを指示するという新しい概念です。
1日資料に目を通しながら、ハマりポイントなども一度言語化しようとまとめてみたので、お役に立てればと思います。
まずはスルーしがちな、ClaudeCodeでの基本的な設定から。
Claude Code の設定は「階層」と「上書き」を理解するのがすべて
Claude Code は、複数の設定ファイルを優先順位付きで読み込みます。
特に重要なのは次の2点です。
- プロジェクト側の
settings.jsonはグローバル設定を上書きする - 指示の「強制力」はファイルごとに異なる
優先度の高い順は以下の通りです。
-
~/.claude/settings.json（全体設定） ~/.claude/CLAUDE.md-
プロジェクト/.claude/settings.json← 最重要 プロジェクト/.claude/CLAUDE.mdプロジェクト/.claude/skills/
👉 「必ず守らせたい指示」は、プロジェクト側 settings.json に書く
これが最大のポイントです。
Skill が読まれない本当の理由
Claude Code の Skill は便利ですが、意外と「読まれない」ことがあります。
よくある原因は以下です。
- CLAUDE.md の指示が曖昧（＝推奨レベルと解釈される）
- ユーザーの「早く」「とりあえず」で Skill より優先される
- Claude が「後で確認すればいい」と判断する
つまり、CLAUDE.md だけでは強制力が足りないのです。
解決策：settings.json の instructions を使う
settings.json にある instructions フィールドは、
Claude Code にとって 最も強い命令 になります。
推奨設定例
{
"instructions": "【必須】Unity操作を行う会話では、最初のレスポンスで必ず /unity-component-setup, /unity-scene-hierarchy, /unity-ui-design を全て読み込んでから作業を開始すること。"
}
この一文だけで、
- Skill を読み忘れない
- 毎回同じ品質で作業が始まる
- 指示ブレがなくなる
という効果があります。
MCP（Model Context Protocol）の正しい理解
MCP は、Claude Code と Unity Editor を WebSocket で直接つなぐ仕組みです。
Unity 側で MCP サーバーが起動すると、次のファイルが自動生成されます。
.unity-mcp-runtime.json
この中に、
- WebSocket ポート
- HTTP ポート
- Unity バージョン
- 起動時刻
など、接続に必要なすべての情報が入っています。
👉 このファイルは「読むだけ」
手動で編集するものではありません。
MCP 通信の基本
通信は JSON-RPC + WebSocket で行います。
例：シーン内オブジェクト一覧取得
echo '{"jsonrpc":"2.0","id":1,"method":"unity.scene.list","params":{}}' | \
websocat -t ws://127.0.0.1:5052
これにより、Claude Code から Unity を「操作可能な対象」として扱えます。
推奨プロジェクト構成
安定運用するための最小構成は以下です。
プロジェクト/
├── .claude/
│ ├── settings.json ← Skill 強制はここ
│ ├── CLAUDE.md ← 補足説明用
│ ├── skills/
│ └── docs/
├── .unity-mcp-runtime.json
└── ...
- 強制ルール → settings.json
- 補足説明 → CLAUDE.md
- 詳細手順 → skills/
という役割分担が重要です。
よくあるトラブルと対処法
Skill が読まれない
→ settings.json に instructions がない
→ 必須指定を追加
MCP に接続できない
→ Unity が起動していない / ポート不一致
→ .unity-mcp-runtime.json を確認
マテリアルが共有されてしまう
→ GameObject 指定で直接変更している
→ Skill の「個別マテリアル設定」手順を使う
まとめ：一番大事なこと
- 最優先で守らせたい指示は
settings.jsonに書く - CLAUDE.md はあくまで補助
- Skill と MCP は「設計」で安定する
Claude Code × Unity MCP は、
設定さえ正しく組めば “会話で Unity を操作する環境” が現実になります。
最初にここを押さえておくと、後の開発効率がまったく違います。
先日、自身で作成しているUnityのMCPサーバーを公開しました‼️
https://github.com/dsgarage/UniMCP4CC
Unityの基本的な機能はカバーできているのですが、まだ安定しないAPIは場外しております。
リクエストがあれば、遠慮なくお声がけ＆Issue立ててください🙇