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

1. Connects to the bridge server via WebSocket
2. Authenticates using the provided API key
3. Reports current working directory to server
4. Listens for PowerShell commands from server
5. 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