claudeway-vsc
日本語
MCP proxy server as a VSCode extension. Automatically starts with VSCode and lets other PCs on the LAN call Claude AI via the ask_claude tool.
Overview
claudeway-vsc is a VSCode extension port of claudeway (Node.js version).
- Automatically manages the proxy server lifecycle with VSCode startup/shutdown
- Uses the host PC's existing Claude CLI authentication
- No need to run a separate persistent Node.js process
- Compatible with the same
.vscode/mcp.json configuration as claudeway
- Works with both local VSCode and Remote Tunnel
Client PC (VSCode) Host PC
+-----------------+ LAN (HTTP) +-------------------------------+
| MCP Client | ───────────────> | VSCode + claudeway-vsc :8080 |
| ask_claude tool | JSON-RPC | └─ claude --print ... |
+-----------------+ <─────────────── | └─ OAuth cached |
SSE stream +-------------------------------+
Prerequisites
- VSCode 1.115.0 or later
- Claude CLI installed and logged in (
claude --print "hello" returns a response)
Setup
Installation
# Option A: From VSCode Marketplace (after release)
# Search for "claudeway-vsc" in the Extensions view
# Option B: Manual install from VSIX
# Ctrl+Shift+P → "Extensions: Install from VSIX..."
Verify Connection
- Launch VSCode — the status bar shows
claudeway: :8080
- Create
.vscode/mcp.json on the client PC (or locally):
{
"servers": {
"claudeway": {
"type": "sse",
"url": "http://192.168.x.x:8080/mcp"
}
}
}
Replace 192.168.x.x with the host PC's LAN IP address (check with ipconfig). For local connections use http://localhost:8080/mcp.
- Reload VSCode (
Ctrl+Shift+P → Developer: Reload Window) — the ask_claude tool becomes available.
Firewall (Windows, for cross-PC access)
# PowerShell (Administrator)
New-NetFirewallRule -DisplayName "claudeway MCP Proxy" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow
Commands
Available from Ctrl+Shift+P.
| Command |
Action |
claudeway: Restart Server |
Stop and restart the server |
claudeway: Show Log |
Bring the output channel to the foreground |
claudeway: Copy Server URL |
Copy http://<host IP>:<PORT>/mcp to clipboard |
Configuration
Configurable via settings.json.
| Key |
Default |
Description |
claudeway.port |
8080 |
Server listen port |
claudeway.cliTimeoutMs |
120000 |
Claude CLI execution timeout (ms) |
claudeway.logLevel |
"info" |
Log level ("info" / "warn" / "error") |
claudeway.logTz |
"" |
Log timezone (e.g. "Asia/Tokyo". Empty = UTC) |
Constraints
- LAN only -- Never expose to the internet
- Server is only active while VSCode is running (for always-on use, see claudeway)
- No authentication (designed for LAN-only access)
- Single concurrent request only (
tools/call)
- Port change notification does not appear while a remote folder is open via Remote Tunnel (run
claudeway: Restart Server manually after changing the port)
- Ensure usage complies with your environment's policies
Documentation
License
MIT
