Unity's plugin for Claude Code
Install and troubleshoot Unity's plugin for Claude Code to access Unity's first-party tooling within your Claude Code environment.
읽는 시간 2분최근 업데이트: 18시간 전
참고
The following concerns a product or service (each a “Third Party Product”) that's not developed, owned, or operated by Unity. This information may not be up-to-date or complete, and is provided to you for your information and convenience only. Your access and use of any Third Party Product is governed solely by the terms and conditions of such Third Party Product. Unity makes no express or implied representations or warranties regarding such Third Party Products, and will not be responsible or liable, directly or indirectly, for any actual or alleged damage or loss arising from your use thereof (including damage or loss arising from any content, advertising, products or other materials on or available from the provider of any Third Party Products).
Unity's plugin adds a set of Unity skills to Claude Code. After you install Unity's plugin, you can ask an agent to accomplish tasks in Unity in plain language instead of front-loading instructions to an agent with unnecessary extra context. Install the plugin, choose the scope that matches how you work, then verify that Claude Code loads the skills.
For a description of the skills and how to prompt them, refer to About Unity's plugin.
Install the plugin
You can install the Unity plugin for Claude Code in two ways: through the Claude Code command line interface or the Claude desktop app.
Install the plugin in Claude Code
To install the Unity plugin within the Claude Code command line interface:
-
Add the marketplace:/plugin marketplace add Unity-Technologies/unity-agent-plugin
-
Install the plugin:/plugin install unity@unity-agent-plugin
Install the plugin in the Claude desktop app
To install through the Claude desktop app:
- Open the Claude desktop app.
- Go to the Plugins section.
- Select Browse.
- Search for . If you can't find it, add it to the marketplace by URL:
Unity- Select Add > Add marketplace.
- Enter .
https://github.com/Unity-Technologies/unity-agent-plugin - Select Sync.
- Select Install (+).
Choose a scope
During the installation, Claude Code asks you to choose a scope. Select the one that meets your needs:
- User scope: available in all your projects. Recommended if you work across several Unity projects.
- Project scope: shared with everyone who works in this repository. Recommended for a team standardizing on the plugin.
- Local scope: available to you, in this repository only.
To skip the scope prompt, run the install from your terminal and set the scope with . The command uses user scope by default, so pass this option only when you want a different scope. For example, to install the plugin for yourself in the current repository only:
--scopeclaude plugin install unity@unity-agent-plugin --scope local
Verify the installation in Claude Code
To verify that the plugin is active:
- Enter to display the list of Unity plugin skills in the slash menu.
/unity: - Enter to confirm that
/pluginis installed and enabled.unity
Update the plugin in Claude Code
Claude Code checks for plugin updates after your session starts and updates them in the background. When an update is available, Claude Code prompts you to run . Otherwise, the new version loads the next time you launch Claude Code.
/reload-pluginsAuto update is off by default for third-party marketplaces and on by default for official Anthropic marketplaces. To change it, refer to Configure auto-updates.
To force a refresh now:
/plugin marketplace update unity-agent-plugin
Limitations
The plugin has the following limitations:
- For simple uGUI work, the plugin makes little difference compared to doing it manually.
- On Sonnet 5, the plugin mainly supplies correctness. Sonnet 5 builds most Unity features without the plugin, but defaults to older approaches.
Troubleshooting
Your Claude Code version is too old, or is unavailable in your environment.
/plugin- Run .
claude --version - Update Claude Code. For detailed information, refer to Update Claude Code and Update manually.
- Restart your terminal and run again.
claude
If still isn't available, use the plugin browser in the Claude desktop app, or declare the plugin under in .
/pluginenabledPlugins.claude/settings.json-
Clear the plugin cache:rm -rf ~/.claude/plugins/cache
-
Restart and reinstall.
Add the marketplace first, then retry the install. Refer to step 4 in Install Unity plugin in the Claude desktop app.