Spatial
Start Building
Browse docs

Get Started

WelcomeQuickstartLayout modesPrompting guidelinesContext basicsFAQ

Core Concepts

Auto-compactionSubagentsMemoriesModels and capabilitiesToken costsSession hygiene

Workflows

Stash and pop promptsAttachments and contextBrowser preview workflowReview and request changesWidgets sidebarWorking with integrationsTroubleshooting

Desktop App

Settings and preferencesVoice inputMax modeCodebase indexingPopout chatPlatform supportProjects and sessionsAgent modesKeyboard shortcutsCLI toolClaude Code sessionsCodex sessions

Session Environments

Git worktreesSSH sessionsCloud sessionsLocal container sessions

Integrations

OverviewGitHubVercelRailwayLinear

Usage & Billing

Tokens and contextPricingPlans and rate limitsUpgrade subscriptionDowngrade subscriptionRefundsCancel subscription

Tutorials

Snake game starter

Desktop App

Claude Code sessions

Claude Code sessions run through your local Claude Code CLI, which changes capability boundaries compared with the default Spatial harness.

Prerequisites

  • Install Claude Code CLI and ensure it is available on your system PATH.
  • Use a valid CLI login/session so requests can execute.
  • Select the Claude Code model in the session model picker.

How Claude Code sessions differ

When Claude Code is selected, the app delegates execution to Claude Code CLI in JSON streaming mode. Claude Code uses its own harness and tool behavior instead of the default Spatial runtime path.

  • Custom Spatial SDK tool behavior is not the primary execution path in this mode.
  • Auto-routing is not applied in the same way as default model sessions.
  • Context compaction is managed by Claude Code in CLI mode.

Mode and compatibility notes

  • Agentic, Plan, and Build are supported when using Claude Code sessions.
  • Because this flow depends on external CLI JSON events, major CLI protocol changes can temporarily affect compatibility.
  • If behavior regresses after a CLI update, check for a newer app version that matches the updated CLI protocol.