Get started

Quick start

Complete the setup once, then choose the app, a browser, the terminal or an editor.

Your server

Enter your server’s SSH name and every command on this page updates.

Examples

Download CC Remote

The desktop app for macOS.

v0.1.6 · Nov 16, 2026

macOS Apple Silicon

macOS 13.0+ · 33.0 MB · Signed & notarized

Download .dmg

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 --version

Check the connection

First accept the SSH host key and set up key login with a regular SSH connection.

ssh devbox claude --version

Sign 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 setup

Next: 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