# Installation

> Install the plugin in Codex or Claude Code and point it at your Blender executable.

## Requirements

| Tool | Version |
| --- | --- |
| Codex or Claude Code | A release with plugin support |
| Blender | 5.2 LTS, the tested version |
| Bun | 1.3.5 or newer |
| Rust | Stable toolchain, only for [scene analysis](scene-analysis.md) |

## Install the plugin

Both hosts install the same twelve specialist skills and local MCP server. Choose the commands for your host.

```bash title="Codex"
codex plugin marketplace add ifBars/blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio
```

```bash title="Claude Code"
claude plugin marketplace add ifBars/blender-agent-studio
claude plugin install blender-agent-studio@blender-agent-studio
```

Inside a Claude Code session, you can also run `/plugin marketplace add ifBars/blender-agent-studio` followed by `/plugin install blender-agent-studio@blender-agent-studio`.

Start a new Codex task or Claude Code session afterwards so the skills and MCP server load. Ask the agent to check the Blender version with `blender_version` to verify the executable is available.

## Point it at Blender

Put `blender` on your `PATH`, or set `BLENDER_EXECUTABLE` to the executable:

```bash title="macOS / Linux"
export BLENDER_EXECUTABLE="/path/to/blender"
```

```powershell title="Windows (PowerShell)"
$env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"
```

MCP tools also accept a `blenderPath` argument, and benchmark commands accept `--blender`.

## Update

```bash title="Codex"
codex plugin marketplace upgrade blender-agent-studio
codex plugin add blender-agent-studio@blender-agent-studio
```

```bash title="Claude Code"
claude plugin marketplace update blender-agent-studio
claude plugin update blender-agent-studio@blender-agent-studio
```

Start a new task or session afterwards. If you built the scene analysis runtime, rebuild it too.

## Scene analysis runtime

Three tools use a small Rust executable for [scene analysis](scene-analysis.md). Build it once from the **installed plugin directory**, the one containing `mcp`, `runtime`, and `package.json`:

```bash
bun run setup:runtime
```

Or set `BAS_RUNTIME_EXECUTABLE` to a compatible `bas-runtime` build. Every other tool works without Rust.

## Skills only

To install the skills without the MCP server, use the skills CLI:

```bash title="Router skill"
bunx skills add -g ifBars/blender-agent-studio --skill blender-agent-studio --agent codex -y
```

```bash title="Router and all twelve specialists"
bunx skills add -g ifBars/blender-agent-studio --skill "*" --agent codex --full-depth -y
```

For Claude Code, replace `--agent codex` with `--agent claude-code`. This route installs skills without the MCP server or plugin presentation metadata.