# claude self-hosted-runner Command

> It lets cloud sessions run on your own machines.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude self-hosted-runner, Self-hosted runner

## Think of it like

It is like you let a class cook in your kitchen. The food is made at your house.

## Definition

claude self-hosted-runner starts a runner on this machine. It can also run in a container. Cloud sessions then run on your own machines, not on Anthropic's. claude self-hosted-runner setup walks you through it. doctor checks a runner that is already going. orchestrator starts new runners when they are needed.

## Example

Lucy's company cannot let code leave its own network. They start self-hosted runners inside it, so cloud sessions run there and the code never leaves.

## Example code

```bash
claude self-hosted-runner setup
```

Walk through setting up a runner.

## Why it matters

Teams with strict rules about where code may go can still use cloud sessions.

## Common mistake

Thinking it is the same as Remote Control. Remote Control drives one person's computer. A runner hosts cloud sessions for many people.

## Three principles

- **Your machines.** Host cloud sessions.
- **setup and doctor.** To start and check.
- **orchestrator.** Runners on demand.

## Related terms

- [Cloud Session](https://learn.benibix.com/term/ai/cloud-session)
- [claude remote-control Command](https://learn.benibix.com/term/ai/claude-remote-control-command)
- [/remote-env Command](https://learn.benibix.com/term/ai/remote-env-command)

## Told apart from

- [claude remote-control vs claude self-hosted-runner](https://learn.benibix.com/compare/claude-remote-control-command-vs-claude-self-hosted-runner-command): People think claude remote-control and claude self-hosted-runner both put Claude Code in the cloud. Neither does, and they serve different people. remote-control lets one person drive Claude Code on their own computer from the Claude app. A self-hosted runner adds a company's machine to a pool that runs cloud sessions for many people. The code stays on the company's network. One is for your laptop. The other is for a whole fleet.

## Taught in

- [Cloud and Server Commands](https://learn.benibix.com/learn/ai-claude-code-commands/cloud-and-server-commands): Claude Code Commands, 17/17

![Three ways to run Claude Code as a server: remote-control, gateway and self-hosted-runner.](https://learn.benibix.com/diagrams/cli-servers.svg)

---

Source: https://learn.benibix.com/term/ai/claude-self-hosted-runner-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
