claude-code-windows-client

Claude Code Windows Client

Windows client that connects to the Claude Code bridge server and executes PowerShell commands on behalf of Claude Code running on Linux/macOS.

Installation

npm install -g claude-code-windows-client

Usage

Start the client on your Windows machine:

claude-code-windows-client ws://your-linux-machine:8080 --api-key your-secret-key

Options

• --api-key, -k <key>: API key for server authentication (default: 'default-key')
• --cwd, -c <path>: Working directory to report to server (default: current directory)

Examples

# Connect to server with custom API key
claude-code-windows-client ws://192.168.1.100:8080 --api-key my-secret-key

# Connect with specific working directory
claude-code-windows-client ws://server:8080 --cwd "C:\Users\john\project"

How it works

• Connects to the bridge server via WebSocket
• Authenticates using the provided API key
• Reports current working directory to server
• Listens for PowerShell commands from server
• Executes commands and returns stdout/stderr/exit codes

Security Features

• API key authentication
• Command validation to prevent dangerous operations
• Sandboxed PowerShell execution
• Automatic timeout for long-running commands

Supported Operations

The client can execute any PowerShell command, with common filesystem operations:

• File listing: Get-ChildItem
• File reading: Get-Content
• Text searching: Select-String
• File operations: Copy-Item, Move-Item, Remove-Item
• Directory operations: New-Item, Set-Location

Requirements

• Node.js 16+
• Windows PowerShell
• Network connectivity to bridge server

Troubleshooting

• Ensure PowerShell is in your PATH
• Check firewall settings for WebSocket connections
• Verify API key matches between client and server