Quick Start Guide

Get up and running with CloudForge in 5 minutes

Prerequisites

  • A server (VPS, cloud instance, or local machine) with SSH access
  • Node.js 18+ installed on the server
  • A CloudForge account (sign up free)
1

Create a Server in CloudForge

First, add your server to CloudForge to get a connection token.

  1. Go to Account → Servers → Add Server
  2. Enter a name for your server (e.g., "My Dev Server")
  3. Click "Create Server"
  4. Copy the agent token (starts with cf_)
Save your token now! It will only be shown once.
2

Install the Agent

SSH into your server and run the agent with npx (no installation required):

npx cloudforge-agent --token YOUR_TOKEN

Replace YOUR_TOKEN with the token from Step 1. The cloudforge-agent package will be downloaded and started automatically. cloudforge-agent

Alternative installation methods

npm global install (for persistent use)

npm install -g cloudforge-agent
cloudforge-agent --token YOUR_TOKEN

Shell script

curl -fsSL https://cloud-forge.me/install.sh | sh -s -- --token YOUR_TOKEN

Docker

docker run -d --name cloudforge-agent \
  cloudforge/agent:latest --token YOUR_TOKEN
3

Connect!

Once the agent is running, your server will show as "Online" in CloudForge.

  1. Go to Account → Servers
  2. Your server should show a green "Online" badge
  3. Click "Terminal" to open the web terminal
  4. Start coding!
https://cloud-forge.me/servers/xxx

CloudForge - Remote AI Coding Platform

✓ Connected

Ready for AI Coding! Start with:

claude - Claude Code

codex - Codex CLI

aider - Aider

user@server:~$ _

What's Next?

Agent Setup Details

Learn about running the agent as a service, environment variables, and more.

Setup Claude Code

Configure Claude Code for remote use with CloudForge.

Need Help?

If you run into issues, check our troubleshooting guide or contact us.