XO Docs

Setup

Create a Claude Code project on XO, authenticate Claude, and open your editor.

Set up a Claude Code agent on XO: create a project, link your Claude credentials via OAuth, and open the browser-based editor to start working.

What You'll Need

  • An XO account
  • One of: an Anthropic API key, or a Claude account (subscription) you'll authenticate via OAuth after the workspace provisions

Deploy Claude Code

Create a New Project

Go to beta.xo.builders.

XO Builders dashboard

Click the + icon next to My Projects in the left sidebar.

Click the + icon to create a new project

On the AI Research Team template card, click Create Agent.

Click Create Agent on the AI Research Team template

Configure Project Details

Enter a unique Project Name — e.g. test.

Optionally, paste an Anthropic API Key. You can skip this and connect your Claude subscription later via OAuth (see Connect Claude below).

Click Create Project.

Click Create Project

Wait for Startup

Open the Configure panel to monitor provisioning.

Click Configure

Wait until the Cowork API status shows Up.

Cowork API Up indicator

Don't proceed to the Claude authentication step until the workspace is fully running.

Connect Claude

Skip this step if you provided an Anthropic API key in Step 2 — your agent is already authenticated. Otherwise, click Connect Claude next to the Configure button on your project card to link your Claude account via OAuth.

OAuth is only available after provisioning is complete. Wait for the workspace to finish starting up before clicking Connect Claude.

See Connect Claude for the full OAuth walkthrough.

Open Your Editor

Back in the Configure panel, launch the browser-based VS Code (code-server) to start working in your workspace. Trust the workspace and open a terminal with Ctrl + `.

Full walkthrough: Access Your Machine via VS Code Server.

Your Claude Code agent is now authenticated and ready. Run claude in the terminal to start a session.

On this page