CubeDocs

SSH from Codex and Claude

Reach your cloud computer from the Codex and Claude apps, or any SSH client on your Mac.

Every Cube computer accepts SSH. The Mac app sets it up for you, so other apps on your Mac, such as the Codex and Claude desktop apps, can work on your computer too.

Turn it on

Open your computer, choose Machine, and find the SSH card. While the computer is running, turn on Allow SSH from this Mac. Cube:

  1. Creates a key for this Mac and this computer in ~/.ssh.
  2. Writes a host entry for the computer to its own file in ~/.ssh, and adds an Include line for it to ~/.ssh/config.
  3. Registers the key with your computer.

SSH

Allow SSH from this Mac
Command
ssh cube-2f6c…-9a41…
Host
cube-2f6c…-9a41…
User
ubuntu
Key
~/.ssh/cube-2f6c…-9a41…_ed25519

Use this Cube in Claude

Adds this computer to Claude's SSH environments and opens Claude.

Open in Claude

Use this Cube in Codex

Opens Codex's SSH connection setup for this computer.

Open in Codex
The SSH card with SSH turned on.

Check it from Terminal with the command shown under Command:

ssh cube-…
FieldValue
Commandssh and the computer's host alias.
HostThe alias: cube- followed by your account and computer IDs.
Userubuntu
KeyThe key Cube made for this computer, ~/.ssh/<alias>_ed25519.
Key (PEM)The same key in PEM format, for apps that ask for one.

Each computer has its own alias, key and port, so you can reach several computers from one Mac. The hostname and port are in the host entry Cube wrote; Files Cube wrote on this Mac, under the fields, lists its files.

Set SSH up from the Mac app. In a browser, Cube can't write to ~/.ssh, so the SSH card asks you to use the desktop app.

Claude

Under Use this Cube in Claude, choose Open in Claude. Cube adds this computer to the Claude app's SSH environments and opens Claude. Pick the computer in the environment menu, then choose a folder on it, such as one of your repositories. Claude works entirely on your computer.

The button needs the Claude app installed on your Mac and the computer running.

Codex

Install Codex on your computer first, from Agents & Tools, and sign it in: in Machine, Agent sign-ins can copy your Mac's Codex sign-in with Copy from this Mac.

Then, under Use this Cube in Codex, choose Open in Codex. Cube opens Codex's SSH connection setup for this computer. Enable the connection, then choose a project folder on your computer. Threads in that project run on your computer: commands, file reads and edits all happen there.

Any other SSH client

Editors and terminals on your Mac read the same SSH config, so they can use the alias directly: ssh <alias>, or the alias as the host in your editor's remote SSH settings.

Turning it off

Switch off Allow SSH from this Mac, or choose Remove SSH access. Cube removes its key from your computer and deletes the files it wrote on this Mac.

On this page