← All docs

Settings

Click the ⚙ icon in the top-right of the Claunity panel to open Settings. Here you configure how Claunity connects to AI and how it behaves.

AI Source

The first thing to choose is where Claunity gets its AI from. There are two options:

API Key

You provide an API key from Anthropic. Claunity calls the Claude API directly. You pay per token used.

Claude Code No API key needed

Uses your existing Claude Code CLI installation and subscription. No API key required — Claunity calls claude -p as a subprocess. Requires Claude Code to be installed: npm install -g @anthropic-ai/claude-code

Provider

When using API Key mode, select which AI provider to use:

  • Claude — Anthropic's models. Best overall quality for code and scene actions.

See AI Providers for a full comparison and model recommendations.

Model

After selecting a provider, choose a model from the dropdown. The list is fetched automatically from the Claunity update server and always shows the latest available models — no plugin update needed when new models release.

Which model to choose

Start with claude-sonnet-4-6 — fast, capable, and cost-effective. Use claude-opus-4-6 for complex multi-file tasks where quality matters most. Use claude-haiku-4-5 for simple tasks where speed and low cost are the priority.

API Key

Paste your API key into the key field. The key is stored locally in ~/.config/claunity/config.json on your machine — it is never sent anywhere except directly to your chosen AI provider.

Use the 👁 button to toggle key visibility. Use Test Connection to verify the key works before saving.

Empty API key warning

If you try to save Settings with an empty API key while not using Claude Code mode, Claunity will warn you. You won't be able to use it until a valid key is provided.

Auto-approve actions

By default, Claunity shows an action preview card before executing any scene change — you see what's about to happen and confirm with Apply.

Enabling Auto-approve skips the confirmation step entirely. Actions are executed immediately without waiting for your approval.

Use with caution

Auto-approve is faster but gives you less control. If Claunity misunderstands a request, changes are applied instantly. You can always use Ctrl+Z to undo, but complex multi-step changes may be harder to reverse cleanly.

Test Connection

Click Test Connection after entering your API key or switching providers. Claunity sends a minimal test request and reports success or the specific error.

Common results:

  • Connected successfully — everything is working
  • Invalid API key — check the key in your provider dashboard
  • Model not available — your key may not have access to this model tier
  • Cannot reach backend — the desktop app is not running

Where settings are stored

All settings (API key, provider, model, toggles) are saved in two places:

  • Desktop app — ~/.config/claunity/config.json
  • Unity Editor — EditorPrefs (per-machine Unity preferences)

When the Claunity panel opens, it automatically sends the saved config to the desktop app — so settings are always in sync even if the backend was restarted.

← Previous Project Settings Next → AI Providers