기술 자료

AI

Unity's AI tools

Open Unity Dashboard

AI

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.
읽는 시간 4분최근 업데이트: 7일 전
참고
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, run the following commands inside an active Claude Code terminal session (started by running 
claude
in your terminal):
  1. Add the marketplace:
    /plugin marketplace add Unity-Technologies/unity-agent-plugin
  2. Install the plugin:
    /plugin install unity@unity-agent-plugin
참고
The 
/plugin
commands aren't available in the Claude extension in Visual Studio Code (VS Code). In the VS Code Claude extension, enter 
/plugins
to open the plugin manager, where you can add the marketplace on the Marketplaces tab and install from there.

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

The 
/plugin
slash commands aren't available in the Claude extension for VS Code.
If you're using the VS Code extension, enter 
/plugins
to open the plugin manager and install the plugin there. If you prefer to work from a terminal, open a Claude Code session and run the install commands. The terminal, the Claude desktop app's local sessions, and VS Code all read the same settings files, so a plugin installed at user scope in one environment is available in the others.
If you're in a terminal session and 
/plugin
is still not recognized, your Claude Code version may be too old:
  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.

  1. Clear the plugin cache:
    rm -rf ~/.claude/plugins/cache
  2. Restart and reinstall.
If you installed through the Claude desktop app and skills are still missing in Claude Code, run 
/reload-plugins
or start a new Claude Code session.

Add the marketplace first, then retry the install. Refer to step 4 in Install Unity plugin in the Claude desktop app.

The plugin only ships skills and doesn't use a Model Context Protocol (MCP) server. Skills that control the Unity Editor run Unity CLI commands. For these commands to work, confirm the following:
Run 
unity status
to confirm the CLI can reach the Editor. To set up the separate Unity MCP server, run 
unity mcp configure
.