{
 "schema_version": 1,
 "generated": "2026-10-23",
 "id": "bojieli-agentreach--run-claude-code-on-remote-box",
 "repo": "bojieli/agentreach",
 "repo_url": "https://github.com/bojieli/agentreach",
 "repo_slug": "bojieli-agentreach",
 "title": "Run Claude Code against a remote box without installing it there",
 "page_title": "How to run Claude Code against a remote box without installing it there with Agentreach",
 "summary": "Point Claude Code at an SSH host so its shell and file work run on that host.",
 "who": "A developer who needs to diagnose or fix something on a build box or VM and wants an agent to help, but does not want a 300 MB agent install or an API key on a machine other people can access.",
 "problem": "Installing a coding agent on a remote machine puts its binary and API key on a box you do not own or will not keep, and the key stays behind after you leave.",
 "outcome": "The agent runs locally, its commands and file reads or writes happen on the target, and nothing is left on the target after the session closes.",
 "steps": [
  "Install reach with `go install github.com/bojieli/agentreach/cmd/reach@latest`",
  "Start the session with `reach build-box claude`, using your ssh_config alias or a host:path target",
  "Ask the agent a question about the box, for example what is using disk space, and let it run commands",
  "Review what it did with `reach log`",
  "Close the session with `reach down build-box-app` or the session name shown by `reach status`"
 ],
 "agent_prompt": "Use the repo bojieli/agentreach to run Claude Code against <target>, for example build-box:/srv/app. Ask it what is using disk space on the target and confirm the commands ran there by checking `reach log`. Expected output: a disk usage summary from the target, and log entries showing exec commands with status ok.",
 "agents": [
  "claude-code"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "Claude Code is the harness the README names for mirror mode, and reach relies on the ssh binary you already have, so ProxyJump, IdentityFile and 2FA behave as they do in your ssh config.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "go",
 "requirements": [
  "Go toolchain, or a pre-built reach binary from the releases page",
  "An ssh binary on your machine that already reaches the target",
  "The coding agent installed on your local machine, such as Claude Code or Codex",
  "Access to the target over SSH, with keys or config already set up"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/bojieli-agentreach/run-claude-code-on-remote-box/",
 "md": "https://dedupedai.com/use-cases/bojieli-agentreach/run-claude-code-on-remote-box/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/bojieli-agentreach--run-claude-code-on-remote-box.json",
 "api_version": "v1"
}