Quick start
This page takes you from nothing to a first reply from an agent that runs on your own computer. You can read all of it before you sign up.
Before you begin
Section titled “Before you begin”- A computer that stays on while your agents work: macOS, Linux or Windows, with a terminal you can paste a command into.
- Node.js 22 or newer on that computer. Check with
node -v. If you do not have it, see Install Node.js below. - A Claude subscription, or an Anthropic API key. If Claude Code is already signed in on that computer, that login is used. If not, you sign in at step 3. You do not need to install Claude Code yourself: MonoClaw brings its own copy.
Step 1: Create your account
Section titled “Step 1: Create your account”- Open command.monoclaw.ai in a browser on the computer you want to connect.
- Enter your email address. There is no password.
- Enter the six-digit code from the email.
You should see the setup screen with five steps, the first one ticked.
Step 2: Connect your computer
Section titled “Step 2: Connect your computer”- Under Connect your computer, copy the command.
- Paste it into a terminal on that computer and press Enter. It is the same on macOS, Linux and Windows.
Sign in to get your command. It ends with a one-time token that works for an hour, which is why it is only shown inside the app. This is its shape, so you know what you will be running:
npx -y @monoclaw/machine@latest connect <token>npx comes with Node.js. It fetches the MonoClaw machine program from npm and runs its connect command, which does five things in order:
- It installs the program for good with
npm install -g, without running any install scripts. From then on the command ismonoclaw. - It connects the computer to your account with the one-time token.
- It makes a folder called
commandin your home folder, if there is none, for your agents to work in. - It starts the machine in the background, now and every time you log in.
- It runs
monoclaw doctorand prints what is ready and what is not.
If you would rather watch the machine run, choose Run it in this terminal instead. That command stops before the background step, and you start the machine yourself. It stops when you close the terminal:
monoclaw startYou should see Waiting for your computer… in the app give way, by itself, to the next step, Add Claude, with your computer’s name on it. The terminal ends with Connected. Go back to MonoClaw in your browser: it has moved on by itself.
If this step fails
Section titled “If this step fails”“MonoClaw needs Node.js 22 or newer. Install it, open a new terminal and run this again.” Your Node.js is older than 22. If the terminal says npx is not found, Node.js is not installed at all. Either way, install it as described under Install Node.js, open a new terminal and paste the same command again.
“npm isn’t allowed to install here (permission denied).” npm reported EACCES. Do not use sudo. Install Node.js with Homebrew on macOS or with nvm on Linux, which keep it in your own folders, then run the command again. See Troubleshooting.
“That enrolment token was not found or has expired. Make a new one from Add a machine.” The command is more than an hour old, or it has been used once already. Go back to the app and copy the command it shows now. See Troubleshooting.
The machine does not appear and the app keeps waiting. The terminal says why. Scroll up to the first error and look it up in Troubleshooting.
monoclaw doctor lists things to fix. The computer is connected all the same. The usual line is Not logged in to Claude, which the next step deals with. See how to read doctor.
Install Node.js
Section titled “Install Node.js”On macOS, with Homebrew:
brew install nodeWithout Homebrew, download the LTS installer from nodejs.org and open it.
On Linux, install nvm, which needs no sudo:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bashThen open a new terminal and install Node.js:
nvm install 22On Windows, in PowerShell:
winget install OpenJS.NodeJS.LTSOr download the LTS installer from nodejs.org.
When node -v shows 22 or newer, open a new terminal and paste the MonoClaw command again.
Step 3: Add Claude
Section titled “Step 3: Add Claude”A new machine can do nothing until it has a module. Agents need Claude.
- Choose Add Claude to followed by your machine’s name.
If Claude Code is signed in on that computer, you should see Claude become ready and the setup move on to the next step.
If Claude is not signed in
Section titled “If Claude is not signed in”The page says what is missing and checks again by itself. On that computer, run:
monoclaw claude auth loginThis signs in the copy of Claude Code that MonoClaw uses. Follow what it prints, then go back to the app.
On a server with no browser the same command works: it prints a link: open the link on any device, sign in, and paste the code it gives you back into the terminal.
To use an Anthropic API key instead of a subscription, open the machine’s page and add the Claude (API key) module. More under Troubleshooting.
Step 4: Create your first agent
Section titled “Step 4: Create your first agent”- Choose Create your first agent. The New project page opens.
- Project name is optional. Leave it blank and the agent suggests one.
- Give the agent a Name, such as Lead Developer.
- Under Runs on, check the Machine and the Connection (your Claude login). With one machine these are filled in for you.
- Check the Folder the agent works in, its Permissions and its Access. The defaults are the folder from step 2, Auto and Full. Read Security before you give an agent Full access to a folder that matters.
- Choose Start.
You should see the project open as a chat with your agent’s name on it.
Step 5: Say hello
Section titled “Step 5: Say hello”- Type a message in the box at the bottom, or choose one of the suggested first messages.
- Send it.
You should see the agent start working and its reply appear in the chat. If the agent wants to do something its permissions do not cover, you see a card with Allow and Deny.
Check it worked
Section titled “Check it worked”On the computer you connected, run:
monoclaw doctorEach line starts with ✓ (fine), • (a note, not a problem) or ✗ (something to fix, with the fix on the next line). You should see All good. at the end. That means Node.js is new enough, the program is installed properly, Claude Code is there and signed in, the computer is connected to your account, its folders exist, and every module on it is ready.
In the app, Machines should list your computer as Online.
What’s next
Section titled “What’s next”- Listen to replies: give your agent a voice and hear its replies.
- Give an agent tools: let it make images or transcribe recordings.
- Add another machine: a second computer or a server, with the same one command.
- Invite someone: share a project with other people.
To use your phone, open command.monoclaw.ai in its browser and sign in with the same email. The conversation is the same on every device.