Harnesses are cloud coding environments that let you run coding agents like Claude or Codex in isolated, secure environments on Northflank. Instead of running agents on your local machine or directly against your codebase, Harnesses provide a controlled workspace with its own resources, networking, and configuration.
Run Harnesses in Northflank's managed cloud or in your own cloud infrastructure . You can connect repositories, configure ports and environment variables, and monitor resource usage—all from the Northflank dashboard or your local terminal.
How Harnesses work
When you create a Harness:
- Northflank provisions a cloud coding environment in your environment (managed cloud or your own infrastructure).
- You authenticate your coding agent using an API key or linked account.
- (Optional) You connect a Git repository for the agent to work with.
- You configure networking, environment variables, and resources.
- You access the Harness from the Northflank dashboard or connect to it locally using SSH.
An active Harness runs continuously until you pause or delete it. Files in the Harness workspace are preserved when you pause and resume the Harness. You can update its configuration and monitor its resource usage at any time.
Multiple team members can work in the same Harness simultaneously. Your teammates can see what you're doing in real-time and collaborate together in the same environment.
Create your first Harness
- A Northflank account on a Pay As You Go plan
- A coding agent account or API key (Claude, Codex, Pi, or your own agent)
- A Git integration if you want to connect a repository
To create a Harness:
- In your Northflank dashboard, create a new project and click Harnesses
- Select your coding agent (Claude, Codex, OpenCode, Pi) or select Bring Your Own Agent.
- Enter a name for your Harness.
- Select the environment where you want to run the Harness.
- Under Authentication, select how you want to authenticate your coding agent. You can use an API key or a linked account.
- Under Repository, select an existing repository and branch, create a new repository, or continue without a repository.
- Optionally, under Advanced, configure runtime variables, the runtime image, resources, and workspace storage.
- Click Create Harness.
You'll be redirected to the Harness terminal. If you didn't use an API key, you may need to sign in to your coding agent when you first open it.
Connect to your Harness locally
Access your Harness from your local machine using SSH.
- The Northflank CLI installed and authenticated.
- Access to the Harness you want to connect to.
To connect to your Harness:
- Open the Harness overview.
- Under Local access, click Connect.
- Copy the SSH command shown.
- Run the command in your terminal.
Example: northflank dev ssh --projectId harness --harnessId numerous-class
You can now work in your Harness environment from your local terminal.
Reach out to the Northflank team at support@northflank.com or book a demo .