Claude Code¶
Prerequisite: complete the Unity package installation.
Install and Sign In¶
Install Claude Code using the official setup guide, then run:
Complete the interactive sign-in. Unity's Chat Settings uses claude auth status to report the cached CLI authentication state.
External MCP Client¶
Unity Biome MCP creates .mcp.json in the Unity project root. Open Claude Code from that project, restart it after the file is created, and run the first connection check.
For user-level configuration instead, use the global configuration command with client key claude-code.
For optional project-local MCP workflows and focused Unity subagents, follow Install AI Skills and Agents.
In-Unity Chat¶
- Open MCP > Settings > Chat Settings.
- Confirm that the Claude binary is detected and authentication reports success.
- Open MCP > Chat and select Claude.
MCP Chat reuses the cached Claude CLI login. It does not ask for an API key.
Client-specific Troubleshooting¶
| Symptom | Action |
|---|---|
| Claude is not found | Make claude available on the login-shell PATH, then restart Unity |
| Authentication is not ready | Run claude, complete sign-in, and verify with claude auth status |
| Tools are absent in Claude Code | Start Claude Code from the Unity project and confirm that .mcp.json exists |
| Configuration changed | Restart Claude Code so it reloads the MCP server entry |