claudeers.
// Developer Tools

claudette

A drop-in Claude Code runs on your remote machine over ssh, its tools work on your local files.

// Developer Tools[ cli ][ api ][ claude ]#claude#ai-agents#claude-code#cli#remote-development#rust#ssh#t3code#devtools◷ MIT$open-sourceupdated about 3 hours ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up claudette (git-clone project) into my current project.
Found on https://claudeers.com/claudette-2
Repo: https://github.com/oshinop/claudette
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/oshinop/claudette
Category: devtools. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/oshinop/claudette

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageRust

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

claudette: Claude's mascot with a small bow, floating above a laptop it is tethered to

claudette

English · 简体中文

A drop-in claude that runs Claude Code on another machine, reached over ssh, and its tools on this one: your files, builds and git stay on the local machine, while the remote machine holds the login.

What you get

  • A drop-in claude: anything that launches Claude Code launches claudette unchanged, and your settings, permission rules, hooks, skills, plugins and MCP servers apply as they would locally.
  • Little load on the local machine: Claude Code itself runs on the remote machine, so a modest machine keeps many agents going at once, with no Claude Code install or login of its own.
  • No telemetry from the local machine: claudette sends none, and Claude Code's own comes from the remote machine.
  • Sessions that survive the local machine sleeping or the network dropping.

Use cases

  • T3 Code and Paseo run many Claude threads at once; with claudette, all of them run on a Mac mini at home instead of the local machine (setup: T3 Code, Paseo).
  • magpie lends a Claude subscription to Codex, OpenCode and other agents; with claudette, the subscription signed in on the remote machine serves the local machine's agents (setup).
  • Clients that speak ACP, such as Zed, JetBrains AI Assistant, Toad and acpc, run Claude through the claude-agent-acp adapter; with claudette behind it, Claude runs on the remote machine and works on the local machine's files (setup).

Set up

curl -fsSL https://raw.githubusercontent.com/oshinop/claudette/main/scripts/install.sh | CLAUDETTE_HOST=mini sh
claudette +doctor                               # checks ssh and the remote machine
ln -s "$(command -v claudette)" ~/bin/claude    # a folder on PATH, ahead of any other claude

claudette +update installs a newer release later; claudette's own commands mention one when it is out. Installation and configuration covers what both machines need, the other settings, updating, and why a link rather than an alias.

Use

Run claude as you always do. Usage covers what's specific to claudette and what to watch out for, and hosts how to point T3 Code, Paseo, an ACP client or an Agent SDK program at it.

Development

Building needs Rust 1.88 or later through rustup, and zig with cargo-zigbuild, which link the static Linux builds:

brew install zig && cargo install --locked cargo-zigbuild
scripts/build.sh     # dist/claudette-{darwin,linux}-{arm64,x64}; the macOS builds need a Mac
cargo test           # unit tests
scripts/test.sh      # end-to-end tests, in containers (needs Docker)

CI runs the unit tests on Linux and macOS, the four builds with the installer, and the end-to-end tests. Pushing a tag that matches Cargo.toml's version, such as v0.1.0, publishes a release with the builds and their SHA256SUMS, which the install script downloads.

Contributing

Issues and pull requests are welcome on GitHub.

  • Bug reports: include the output of claudette +doctor, both machines' operating systems, and the host if one launched claudette (T3 Code, Paseo, an ACP client). The log setting (configuration) records every frame and mount request. It contains prompts and file contents, so share only the relevant part.
  • Hosts and clients: a report that a host from hosts works or doesn't, with its version and what you tried, helps as much as code.
  • Pull requests: cargo test and scripts/test.sh should pass. CI runs both, plus the four release builds and the installer. A change in behavior comes with a test that would catch it breaking: unit tests sit beside the code, and end-to-end tests in tests/e2e drive the real Claude Code in containers (testing). Update the docs the change makes stale, including the coverage list in docs/testing.md, and their Chinese versions in docs/zh-CN (README_zh-CN.md for this file). There is no formatter configuration: follow the style of the file you change.

Acknowledgements

The idea of running Claude Code remotely while replacing its file and shell tools with local ones of the same names and inputs comes from cc-remote by AkaraChen.

More

// faq

What is claudette?

A drop-in Claude Code runs on your remote machine over ssh, its tools work on your local files.. It is open-source on GitHub.

Is claudette free to use?

claudette is open-source under the MIT license, so it is free to use.

What category does claudette belong to?

claudette is listed under devtools in the Claudeers registry of Claude-compatible tools.

0 views
★ 30 stars
unclaimed
updated about 3 hours ago

// embed badge

claudette on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claudette-2.svg)](https://claudeers.com/claudette-2)

// retro hit counter

claudette hit counter
[![Hits](https://claudeers.com/api/counter/claudette-2.svg)](https://claudeers.com/claudette-2)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 307,864◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how claudette connects across the ecosystem