# 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.

> **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](./about-unity-plugin.md).

## 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:

   ```bash
   /plugin marketplace add Unity-Technologies/unity-agent-plugin
   ```

2. Install the plugin:

   ```bash
   /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:

```bash
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](https://code.claude.com/docs/en/discover-plugins#configure-auto-updates).

To force a refresh now:

```bash
/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

**The /plugin command isn't recognized:**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](https://code.claude.com/docs/en/setup#update-claude-code) and [Update manually](https://code.claude.com/docs/en/setup#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`.**The skills don't appear after installing:**1) Clear the plugin cache:

   ```bash
   rm -rf ~/.claude/plugins/cache
   ```

2) Restart and reinstall.**In the Claude desktop app, install fails with 'marketplace not found':**Add the marketplace first, then retry the install. Refer to step 4 in [Install Unity plugin in the Claude desktop app](#install-the-plugin-in-the-claude-desktop-app).