Claude Pilot

Run Claude Code through GitHub Copilot's API.

Prerequisites

1. GitHub Copilot Subscription

You need an active GitHub Copilot subscription (Individual, Business, or Enterprise).

2. Copilot CLI

npm install -g @github/copilot

3. Claude Code

npm install -g @anthropic-ai/claude-code

Installation

npm install -g @lioneltay/claude-pilot

Quick Start

# 1. Authenticate with GitHub Copilot
claude-pilot login

# 2. Run Claude Code (proxy starts automatically)
claude-pilot

Features

• Web Search - Works via Copilot CLI
• Auto Token Refresh - Copilot tokens refresh automatically before expiry
• Dashboard - Web-based log viewer at http://localhost:51080/
• Zero Config - Proxy auto-starts and finds an available port

Commands

claude-pilot

Run Claude Code with the proxy. If no arguments are provided, launches Claude Code interactively. Any arguments are passed through to Claude.

# Interactive mode
claude-pilot

# Pass arguments to claude
claude-pilot --help
claude-pilot "explain this codebase"

The proxy starts automatically if not already running.

claude-pilot login

Authenticate with GitHub Copilot using the device flow.

claude-pilot login

This will:

1. Display a code and URL
2. Open GitHub in your browser
3. Enter the code to authorize
4. Save credentials to ~/.config/claude-pilot/auth.json

claude-pilot logout

Clear credentials and stop the proxy.

claude-pilot logout

claude-pilot start

Start the proxy server in the background.

claude-pilot start
claude-pilot start -p 8080  # Custom port

claude-pilot stop

Stop the running proxy server.

claude-pilot stop

claude-pilot status

Show proxy status and authentication state.

claude-pilot status

claude-pilot dashboard

Open the log viewer dashboard in your browser.

claude-pilot dashboard

Configuration

All configuration is stored in ~/.config/claude-pilot/:

| File | Description | | ---------------- | ------------------------------- | | auth.json | GitHub and Copilot tokens | | daemon.json | Running proxy state (PID, port) | | server.log | Proxy server logs | | requests.jsonl | Request/response logs |

How It Works

Claude Pilot runs a local proxy that:

1. Receives requests from Claude Code in Anthropic's Messages API format
2. Transforms them to OpenAI's Chat Completions format
3. Forwards to GitHub Copilot's API
4. Transforms responses back to Anthropic format

This allows Claude Code to work with your existing GitHub Copilot subscription.

Troubleshooting

"Copilot CLI not found"

Make sure the Copilot CLI is installed and in your PATH:

copilot --version

If not installed, see Prerequisites.

"Claude CLI not found"

Make sure Claude Code is installed:

claude --version

If not installed, see Prerequisites.

"Token expired"

Re-authenticate:

claude-pilot login

Check logs

# Server logs
cat ~/.config/claude-pilot/server.log

# Request logs
cat ~/.config/claude-pilot/requests.jsonl | jq .

License

MIT