Set up your AI-OS
~10 minutes
Mac or Windows
No coding
One guide for Mac and Windows.
Give your AI-OS a home
Favorites
Desktop
Documents
Downloads
Projects
Downloadsyour-name
AI-OS.zip
AI-OS
Desktop
Documents
Downloads
Projects
- Unzip
- Move into Projects
- Pin to sidebar
Animation · loops
- Unzip the AI-OS folder we emailed you. Don't leave it in Downloads.
- Open your user folder (the one with your name) and create a folder called Projects.
- Move the AI-OS folder into Projects.
- Drag Projects into your sidebar: Finder on Mac, Quick access in File Explorer on Windows. Now it's always one click away.
- Easier option: put it in Documents instead. Works just as well, it's just a bit less tidy.
Install VS Code

- Go to code.visualstudio.com.
- Click Download.
- Install it like any app. It's a free tool from Microsoft.
- Open VS Code.
- Asked to create a GitHub account or sign in? Skip it or close it. Not needed for now.
Add the Claude Code extension
Silent screen recording · loops
- Click the Extensions icon (four squares) on the left.
- Search Claude Code.
- Install the one by Anthropic.
- Still greyed out? Open Extensions again and click Enable.
- Click the Claude icon and sign in with your Claude account (Pro, ~€20/mo, claude.ai).
Open your AI-OS inside VS Code
Silent screen recording · loops
- In VS Code: File → Open Folder.
- Go to where you saved it in step 1, open your AI-OS folder, then pick the AI-OS folder inside it. That inner one is your OS.
- Asked whether you trust the authors? Click Yes.
Run /onboard
Silent screen recording · loops
- Open the Claude chat.
- Type
/onboardand press Enter. - Your OS introduces itself and sets you up live. You only do this once.
If something doesn't work
- No Claude icon after install
- Quit VS Code fully and reopen the folder.
- Sign-in won't return to VS Code
- Sign in at claude.ai first, then retry.
/onboarddoes nothing- Open the inner AI-OS folder (step 4). The sidebar should show
CLAUDE.mdat the top. - Anything else
- Ask Claude in the chat, or email support@myaioperatingsystem.com.
That's it. Your AI-OS is running. Everything else lives in docs/, and your OS can explain any of it. Just ask.