Before you start
Make sure you have:
- An SSH client on your machine
- Claude Code 2.1.248 or later on the server, signed in to your account
- A POSIX login shell on the server
- Optional: Python 3 on the server, for automatic Skills sync
Install the command
Download and open the app. In Management → Usage Guide, install the terminal command if it is not available, then check its version.
cc-remote --versionCheck the connection
First accept the SSH host key and set up key login with a regular SSH connection.
ssh devbox claude --versionSign in on the server
If needed, sign in to Claude Code on the remote host, then run setup to verify SSH, Claude and authentication and save the default host. Complete browser authorization on the VPS too; credentials stay there.
cc-remote --host devbox --cli auth login
cc-remote --host devbox setupNext: choose how to connect
All four entry points use the same remote ACP and local tool bridge. Each connection has its own session and draft.
- App: chat and manage hosts, Skills and usage in the desktop app
- Web: the same interface in your browser
- Terminal (TUI): the terminal interface in your project directory
- Editors and ACP clients: Zed, AionUi or any stdio ACP client