← All docs

FAQ

Answers to the most common questions about Claunity.

Didn't find your answer?

Check the Troubleshooting page for common errors, or email us at support@claunity.com.


General

What is Claunity? +

Claunity is an AI assistant built directly into Unity Editor. It understands your project — scripts, scenes, structure — and can answer questions, write code, modify the scene, and test your game through natural language chat.

Do I need to know how to code to use Claunity? +

No. You describe what you want in plain English and Claunity handles the implementation. That said, understanding basic Unity concepts (GameObjects, components, scenes) will help you give better instructions and review what Claunity does.

Does Claunity work with any Unity version? +

Claunity requires Unity 2021.3 LTS or newer. It works with all render pipelines — Built-in, URP, and HDRP.

Does it work on all platforms? +

The Unity package works on any platform where Unity Editor runs. The desktop app (backend) is available for Windows 10+, macOS 14+ (Apple Silicon), and Ubuntu 22.04+.

Is Claunity a subscription or a one-time purchase? +

Claunity is a one-time purchase on the Unity Asset Store. You keep it forever including all future updates. You do need to bring your own Anthropic API key — or use Claude Code if you have a subscription. Those are billed separately based on usage.


AI & API Keys

Which AI provider should I use? +

We recommend Claude Sonnet (Anthropic) as the default. It produces the most reliable results for scene actions and code generation. See the AI Providers page for a full comparison.

How much does the AI cost to use? +

It depends on the provider and model. A typical Claunity session with Claude Sonnet costs a few cents. Heavy Project Mode sessions with many scripts and scene operations might cost $0.10–$0.50. Claude Haiku is significantly cheaper for simple tasks.

Can I use Claunity without an API key? +

Yes — if you have a Claude Pro or Claude Max subscription, you can use Claude Code mode. Set AI Source to "Claude Code" in Settings. No API key needed, no per-token billing.

Is my API key safe? +

Yes. Your API key is stored locally in ~/.config/claunity/config.json on your machine. It is only ever sent directly to Anthropic — never to any Claunity server.

Can I switch between providers mid-project? +

Yes. Switch at any time in Settings — the change takes effect on the next message. Your chat history is preserved and provider-agnostic.


Scene Actions

Can I undo what Claunity does? +

Yes. Every scene action Claunity performs is registered in Unity's Undo system. Press Ctrl+Z (or Cmd+Z on macOS) to reverse any change, exactly as if you had done it by hand.

Claunity did something wrong — how do I revert? +

Use Ctrl+Z to undo the action. For script changes, you can ask Claunity to revert the file: "@ScriptName revert to what it was before". For complex multi-step tasks, undo each step in reverse order.

Does Claunity know what is in my scene? +

Not automatically — but it can read your scene on demand. If you ask it to do something scene-related, it will call get_scene_info first to inspect the hierarchy before making changes. You can also ask it directly: "What is in the current scene?"

Can Claunity work with prefabs? +

Yes. Claunity can save GameObjects as prefabs and instantiate prefabs from your Assets folder into the scene. Full prefab editing (entering prefab mode) is not yet supported.

Does it support multiple scenes? +

Yes. Claunity can create new scenes, load scenes (single or additive), and save the current scene. It operates on whichever scene is currently active in the Editor.


Scripts

Will Claunity overwrite my scripts without asking? +

No. Script changes appear as action preview cards in the chat. You see the filename and a summary of changes before anything is applied. Click Apply to confirm or Cancel to skip.

How does Claunity edit scripts — does it see the full file? +

Yes. Before editing any script, Claunity reads the complete current file content. It then writes back the full updated file — never a partial snippet. This prevents broken files from incomplete edits.

Can Claunity work with large scripts? +

Yes, up to the context window limit of the model you're using. Sonnet and Opus handle scripts of several hundred lines without issues. For very large files (1000+ lines), consider splitting them before editing.


Project Mode

What file formats does Project Mode accept? +

PDF, Markdown (.md), and plain text (.txt). If you don't have a document, you can skip the upload and describe your game idea directly in the chat.

Can I edit the plan before Claunity starts building? +

Yes. After the plan is generated, chat with Claunity to refine it — add tasks, remove epics, change scope. Click Start Building only when you're happy with the plan.

What happens if Claunity gets stuck on a task? +

If it cannot proceed without your input, it pauses and shows a question card. Answer in the input field and execution resumes. If a task fails after retrying, it is marked with ✗ and execution continues with the next task.


Privacy & Data

Does Claunity send my code to any server? +

Your scripts and scene data are sent to Anthropic as part of the chat context. They are not sent to any Claunity server. Check Anthropic's privacy policy for how they handle data.

Does Claunity collect any telemetry? +

No. Claunity does not collect usage data, analytics, or crash reports. The only external network requests are: AI API calls (to your provider), model list fetch (from the public claunity-data GitHub repo), and update checks (from the public claunity-releases GitHub repo).