claude-code-vm

🥈Silver

Automated deployment system for Claude Code development environments on Debian VMs, supporting four progressive tiers from baseline Git/Node.js to full Kubernetes setups with 7 MCP servers.

2800Updated 2mo ago

Intermediate30min to implementautomation

Saves ~75 min per use

Quick InstallView Source

git clone https://github.com/intelligentcode-ai/claude-code-vm.git

Works with:

Claude

Overview

About This Skill

Claude Code VM automates the deployment of Claude Code development environments on Debian virtual machines through a four-tier architecture. Starting with baseline Git, Node.js 22 LTS, and Claude Code CLI, the system scales progressively to include MCP servers, Docker, Docker Compose, and Kubernetes tools. It features 500+ curated security rules designed specifically for Claude Code operations, multi-provider Git credential management, and support for 7 MCP servers—4 requiring no API keys and 3 conditional on API keys. The system uses Ansible-based deployment with Make commands, supports external configuration management, and enables localhost testing without SSH. Teams benefit from context-aware Claude configuration files that automatically adapt to their deployment tier, reducing manual setup and configuration drift.

How to Use

Clone the repository, run `make setup` to create default configuration, then choose your deployment tier using `make deploy-baseline`, `make deploy-enhanced`, `make deploy-containerized`, or `make deploy-full` with your VM host and target user. Optionally configure `.env` with Git credentials and API keys before deployment.

Use Cases

Setting up isolated Claude Code development environments on remote Debian VMs with Git and Node.js

Deploying Docker-based development workflows with MCP servers for AI-assisted coding

Building Kubernetes clusters with Claude Code integration for scalable development infrastructure

Managing multi-host deployments with automated configuration and credential management

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/intelligentcode-ai/claude-code-vm

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Deploy Claude Code and the following tools to a VM for remote development: [TOOLS]. The VM should be configured with [OS] and have [RESOURCES] allocated. Ensure secure access via [ACCESS_METHOD].

Example Output

# VM Deployment Plan for Remote Development

## Tools to be Installed
- Docker
- Git
- VS Code Server
- Python 3.9

## VM Configuration
- **OS**: Ubuntu 20.04 LTS
- **Resources**: 4 vCPUs, 16GB RAM, 100GB SSD
- **Access Method**: SSH with key-based authentication

## Security Measures
- Firewall rules to allow only necessary ports (22 for SSH, 8443 for VS Code Server)
- Regular security updates and patches
- Monitoring for unusual activity

## Next Steps
1. Provision the VM with the specified resources
2. Install and configure the required tools
3. Set up secure access and test connectivity
4. Document the deployment process for future reference