01
1. Prepare Cage
Install a supported desktop version, create your local login and start a supported guest environment.
Find simple explanations for the features you will use most, plus links to the project developers' full documentation.
Install a supported desktop version, create your local login and start a supported guest environment.
Choose and apply your own supported proxy node. Review Cage network diagnostics before working.
Share an intended project folder, open a new terminal, run claude and sign in to your account.
These summaries explain what each subject covers. Select the developer documentation link to find the latest detailed instructions and search the appropriate section.
Install your desktop app, set up the local account, select a guest OS and launch the first workspace
Open developer documentationUnderstand the supported host/guest combinations, images and guest development tools
Open developer documentationImport a proxy configuration, select an exit, inspect network checks and understand connection restrictions
Open developer documentationAdd authorized accounts, check visible quota information and assign accounts to sessions
Open developer documentationPair supported Android or locally built iOS clients and continue sessions from a phone
Open developer documentationConnect a compatible Linux VPS and use remote projects, terminals and tools
Open developer documentationLearn when settings apply, how to change them and what belongs to the guest environment
Open developer documentationManage virtual disk storage, restore workflows, application updates and retained files
Open developer documentationResolve installation, networking, guest startup, login and download errors
Open developer documentationUnderstand file sharing, terminal input, copying and behavior when the app window closes
Open developer documentationCage exposes shared host folders to its guest. Changes to a shared project can change the original files. Separate projects within one guest are not independently isolated.
The default controlled public connection uses IPv4 TCP and proxied DNS. IPv6, public UDP, ICMP and direct local-network access are restricted by default.
Network and isolation checks provide configuration evidence, not a promise of perfect security or freedom from Claude account restrictions.
Mobile access and SSH deployment require extra configuration and compatible devices. Phone pairing and some guest scenarios may not be fully verified on every device.
Need help with a reproducible bug? Read the latest release notes, capture the first relevant error from Operation Details, and use the project's GitHub Issues page. Do not publish passwords, tokens or private project data.
References: Project repository · Release v0.1.7 · Developer documentation
Independent informational content, not affiliated with Anthropic or the project developers. Check upstream documentation for newer releases.