Access Claude Code remotely via Tailscale for secure mobile or desktop connections. Provision VMs with Fly.io. Compatible with Gemini, Codex, and OpenCode. Ideal for developers needing flexible, AI-assisted coding environments.
git clone https://github.com/QuivrHQ/247-claude-code-remote.gitThe 247-claude-code-remote skill allows users to access Claude Code from any location, providing a secure connection through Tailscale. This skill is particularly useful for developers and AI practitioners who need to provision virtual machines with Fly.io. It seamlessly integrates with popular AI frameworks such as Gemini, Codex, and OpenCode, making it a versatile tool in the AI automation landscape. One of the key benefits of this skill is its ability to facilitate workflow automation by enabling remote access to Claude Code. This means that developers can work on projects from anywhere, reducing the need for physical presence in an office or a specific location. While the exact time savings are not quantified, the flexibility and ease of access can significantly enhance productivity, allowing teams to collaborate more effectively regardless of their geographical locations. This skill is ideal for developers, product managers, and AI practitioners who are looking to streamline their workflows and enhance their project management capabilities. By utilizing the 247-claude-code-remote skill, teams can ensure that they have continuous access to necessary tools and resources, which is crucial in fast-paced development environments. Practical use cases include remote debugging, collaborative coding sessions, and real-time project updates, all of which can be conducted securely and efficiently. With an intermediate implementation difficulty and a setup time of approximately 30 minutes, this skill is accessible for those with a basic understanding of AI automation tools. It fits seamlessly into AI-first workflows by enabling users to leverage AI capabilities without being tethered to a specific location, thus promoting a more agile and responsive development process.
[{"step":"Provision the VM on Fly.io.","action":"Run `flyctl launch` with your desired specifications (e.g., `flyctl launch --name claude-remote-vm --region iad --image flyio/ubuntu:22.04 --vm-size shared-cpu-4x`). Ensure the VM size and region align with your workload needs (e.g., shared-cpu-4x for moderate tasks, dedicated-cpu-8x for heavy workloads).","tip":"Use `flyctl regions list` to check available regions and `flyctl vm sizes` to compare VM options."},{"step":"Install and configure Tailscale.","action":"SSH into the VM (`flyctl ssh console`) and install Tailscale (`sudo apt install -y tailscale`). Authenticate using an auth key (`sudo tailscale up --authkey [YOUR_AUTH_KEY] --hostname [VM_NAME]`). Verify the connection with `tailscale status`.","tip":"Generate an auth key in your Tailscale admin console with ephemeral or reusable settings. Use `--hostname` to make the VM easily identifiable in your Tailscale network."},{"step":"Set up your IDE tool (e.g., VS Code Server).","action":"Install your preferred IDE server (e.g., `curl -fsSL https://code-server.dev/install.sh | sh` for VS Code Server). Start the server with `code-server --auth none --bind-addr 0.0.0.0:8080 &` to allow remote access.","tip":"For security, use `--auth password` or integrate with your identity provider. Restrict access via firewall rules (`ufw allow 8080/tcp`)."},{"step":"Connect to the remote environment.","action":"Use the `247-claude-code-remote` CLI to connect (`claude-code-remote --endpoint https://claude.ai --vm-name [VM_NAME]`). Access the IDE via the Tailscale IP (e.g., `http://[TAILSCALE_IP]:8080`).","tip":"Test the connection from both mobile and desktop devices to ensure cross-device compatibility. Use `claude-code-remote --debug` to log connection issues."},{"step":"Document and automate the setup.","action":"Save the setup steps in a Markdown file (e.g., `claude-remote-setup.md`) and create a `fly.toml` config file for reproducible deployments. Share the environment with your team by inviting their Tailscale emails.","tip":"Use `flyctl deploy` to update the VM configuration from your `fly.toml` file. Schedule daily snapshots (`flyctl snapshot create`) for backup."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/QuivrHQ/247-claude-code-remoteCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Set up a secure remote coding environment using [247-CLAUDE-CODE-REMOTE] via Tailscale. Provision a VM on [Fly.io] with the following specifications: [VM_SIZE], [REGION], and [OPERATING_SYSTEM]. Configure the environment to support [IDE_TOOL] (e.g., VS Code, Cursor, or Zed) and ensure it’s accessible from your [DEVICE_TYPE] (mobile/desktop). Test the connection and verify that [AI_MODEL] (e.g., Claude 3.5 Sonnet, Codex, or OpenCode) is operational. Document the setup steps and any troubleshooting steps taken in a [FILE_FORMAT] (e.g., Markdown or JSON) file named [OUTPUT_FILENAME].
### Remote Coding Environment Setup Report **Date:** October 10, 2024 **User:** [email protected] **VM Details:** - Provider: Fly.io - VM Size: shared-cpu-4x (4 vCPUs, 8GB RAM) - Region: iad (Washington, D.C.) - OS: Ubuntu 22.04 LTS - Tailscale Version: 1.56.1 **Setup Steps:** 1. **Provision VM:** ```bash flyctl launch --name claude-remote-vm --region iad --image flyio/ubuntu:22.04 --vm-size shared-cpu-4x ``` Output: `VM 'claude-remote-vm' created in region iad` 2. **Install Dependencies:** ```bash flyctl ssh console -C "sudo apt update && sudo apt install -y tailscale curl git" ``` Output: `Tailscale installed successfully. Run 'tailscale up' to authenticate.` 3. **Configure Tailscale:** ```bash flyctl ssh console -C "sudo tailscale up --authkey [REDACTED] --hostname claude-remote-vm" ``` Output: `Connected to Tailscale network. Assigned IP: 100.x.y.z` 4. **Install IDE Tool (VS Code Server):** ```bash flyctl ssh console -C "curl -fsSL https://code-server.dev/install.sh | sh && code-server --auth none --bind-addr 0.0.0.0:8080 &" ``` Output: `VS Code Server running on port 8080` 5. **Test AI Model Integration:** - Connected to Claude Code via `247-claude-code-remote` CLI: ```bash claude-code-remote --endpoint https://claude.ai --vm-name claude-remote-vm ``` - Verified model response: `Claude 3.5 Sonnet is operational. Test prompt: 'Write a Python script to parse JSON logs.' Output received in 1.2s.` **Connectivity Check:** - **From Mobile (iOS):** - Opened VS Code app → Connected to `http://100.x.y.z:8080` via Tailscale. - Successfully edited `main.py` and pushed changes to GitHub. - **From Desktop (macOS):** - Connected via `ssh [email protected]` and ran `claude-code-remote --debug`. - Debug logs confirmed stable connection with <100ms latency. **Troubleshooting:** - **Issue:** VS Code Server failed to start. **Fix:** Added `--auth password` flag and updated firewall rules: ```bash flyctl ssh console -C "ufw allow 8080/tcp" ``` - **Issue:** Tailscale connection dropped after 1 hour. **Fix:** Added `--advertise-exit-node` flag to persist connection: ```bash flyctl ssh console -C "sudo tailscale up --advertise-exit-node" ``` **Next Steps:** - Automate VM provisioning using a `fly.toml` config file (attached). - Set up daily snapshots for backup. - Share the environment with the team by inviting their Tailscale emails. **Attachments:** - `claude-remote-setup.md` (Markdown file with detailed steps) - `fly.toml` (Fly.io configuration) **Status:** ✅ Environment operational and tested. Ready for team adoption.
Real-time student behavior monitoring and prediction
Deploy applications globally with automatic scaling and integrated load balancing.
Google's multimodal AI model and assistant
AI assistant built for thoughtful, nuanced conversation
Secure workspace solutions
Recommend great Internet writing
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan