ClaudeMap

cc-remote

Run Claude Code on a server over ssh — the model, your login and your subscription stay there while every tool call runs on your own machine: real Claude Code as an ACP agent, plugging straight into acpc, Zed, paseo and other ACP clients

Plugins & Agentsremote developmentacpclaude codesshzed

cc-remote gives your familiar editor a Claude Code that runs somewhere else (367 stars as of writing, 2026-11-11): the claude process — your login and your subscription — stays on a server you reach over ssh, while Read, Write, Edit, Bash (PowerShell on Windows), Glob, Grep and the rest run on your own machine, against your files, your dependencies, your git config and your build tools. It is an Agent Client Protocol (ACP) agent: built from agentclientprotocol's Claude Code adapter claude-agent-acp with one change — the claude it starts runs on the server — and sessions, permission prompts, modes, models, forks and diffs work the way they do in claude-agent-acp; to your editor it looks exactly like Claude Code. There is nothing to set up on the server: no daemon, no port — if `ssh <your-server> claude --version` works (Claude Code 2.1.248 or later, logged in), cc-remote works. Your local MCP servers come along: the ones your editor passes and the ones in your local Claude Code config (~/.claude.json, approved .mcp.json files) run on your machine, OAuth logins included. Sessions mirror to ~/.claude/projects/ locally, where your client can list, replay, load and fork them.

What it does

  • Model on the server, tools on your machine: Read / Write / Edit / NotebookEdit / Bash / Glob / Grep run locally; the system prompt, session, web search, subagents and skills stay remote
  • Nothing to install on the server: no daemon, no port — key-based ssh access plus a logged-in Claude Code 2.1.248+ is the whole setup
  • Real Claude Code behavior via claude-agent-acp: command-prefix approvals, and a command with ; & | redirects $(…) backticks or newlines is never approved automatically
  • Your local MCP servers come along with OAuth logins; on name clashes your client wins over local config, and both win over the host's
  • Sessions mirror to ~/.claude/projects/ like a local Claude Code; the server keeps per-directory working folders under ~/.cc-remote/ws/
  • One dependency-free binary built with Bun for macOS, Linux and Windows

When to use it

For developers whose Claude login and subscription live on an always-on server — a dev box, a work server, a machine in a region where Claude is available — while the code stays local; for teams sharing one logged-in server; and for laptops where you'd rather not install claude or keep a login at all.

Getting started

# your machine needs Bun to build; the resulting binary has no dependencies
git clone https://github.com/AkaraChen/cc-remote && cd cc-remote
bun install
bun run compile    # builds the binary for this machine into dist/cc-remote
bun link           # puts cc-remote on your PATH, in ~/.bun/bin

# prerequisites: ssh to the server works without a password prompt; claude (2.1.248+) on the server is logged in
mkdir -p ~/.config/cc-remote && echo <your-server> > ~/.config/cc-remote/host
cc-remote doctor   # checks ssh and the remote claude version

# Zed — add to settings.json:
{
  "agent_servers": {
    "Claude (remote)": { "command": "cc-remote", "args": ["--host", "<your-server>"] }
  }
}

# acpc in a terminal:
acpc add --slug cc-remote --name "Claude (remote)" cc-remote --host <your-server>
acpc -a cc-remote

Things to know

As of writing the repo carries no license file (the GitHub API reports none), so no reuse terms are stated yet. Known limits from the README: your project's .claude/ directory (commands, skills, agents, settings) is not sent to the server — the server's user-level settings, skills and MCP servers still apply; file checkpoints and rewind are recorded on the server, so they can't see your local edits; bridged MCP servers expose their tools only, not resources or prompts; LSP, Monitor and the worktree tools are turned off. Windows specifics: the shell tool is PowerShell (pwsh 7 when on PATH, otherwise Windows PowerShell 5.1) and Grep needs ripgrep on PATH; Windows' OpenSSH can't share connections, so each session opens its own. By default all sessions share one ssh ControlMaster kept open for 10 minutes, and a dead link fails in about a minute. The server needs a POSIX login shell. 367 stars as of writing (2026-11-11).

Repository

AkaraChen/cc-remote

Charted

Related on the map

  • clawd-conduit

    Plugin / Agent

    Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    Plugin / Agent

    An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    Plugin / Agent

    Hook-level enforcement for the natural-language rules in AGENTS.md and CLAUDE.md — every edit is judged and violations are repaired in the same turn.

    • hooks
    • code-review
    • rules
    • agents-md