Documentation

​
​

Development

User Acquisition

Monetization

Industry

AI

Unity's AI tools

Open Unity Dashboard

AI

​
​
Manage AI tools in the Unity Dashboard
  • Configure Unity's AI settings
  • Monitor Unity's AI usage
  • Unity's AI settings reference
Unity's plugin for third-party agents
  • About Unity's plugin
  • Claude Code
  • Codex
  • Grok
  1. Unity's AI tools
  3. Unity's plugin for third-party agents

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.
Read time 3 minutes
Last updated 22 days ago
Note
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:
  1. Add the marketplace:
    /plugin marketplace add Unity-Technologies/unity-agent-plugin
  2. Install the plugin:
    /plugin install unity@unity-agent-plugin

Install the plugin in the Claude desktop app

To install through the Claude desktop app:
  1. Open the Claude desktop app.
  2. Go to the Plugins section.
  3. Select Browse.
  4. Search for 
    Unity
    . If you can't find it, add it to the marketplace by URL:
    • Select Add > Add marketplace.
    • Enter 
      https://github.com/Unity-Technologies/unity-agent-plugin
      .
    • Select Sync.
  5. 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 
--scope
. 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:
claude plugin install unity@unity-agent-plugin --scope local

Verify the installation in Claude Code

To verify that the plugin is active:
  • Enter 
    /unity:
    to display the list of Unity plugin skills in the slash menu.
  • Enter 
    /plugin
    to confirm that 
    unity
    is installed and enabled.

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 
/reload-plugins
. Otherwise, the new version loads the next time you launch Claude Code.
Auto 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 
/plugin
is unavailable in your environment.
  1. Run 
    claude --version
    .
  2. Update Claude Code. For detailed information, refer to Update Claude Code and Update manually.
  3. Restart your terminal and run 
    claude
    again.
If 
/plugin
still isn't available, use the plugin browser in the Claude desktop app, or declare the plugin under 
enabledPlugins
in 
.claude/settings.json
.

  1. Clear the plugin cache:
    rm -rf ~/.claude/plugins/cache
  2. Restart and reinstall.

Add the marketplace first, then retry the install. Refer to step 4 in Install Unity plugin in the Claude desktop app.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Install the plugin

      • Install the plugin in Claude Code

      • Install the plugin in the Claude desktop app

      • Choose a scope

    • Verify the installation in Claude Code

    • Update the plugin in Claude Code

    • Limitations

    • Troubleshooting

  • Additional resources
  • Unity's plugin for Codex
  • Unity's plugin for Grok
  • unity-agent-plugin repository
Report a problem with this page