BRIDGE — Connect VS Code to Claude
Your VS Code workspace. Your Claude account. One connected workflow.
BRIDGE connects Visual Studio Code to your own authenticated Claude.ai browser session through a lightweight Chrome companion.
Send prompts, attach project files, and share terminal output with Claude without constantly switching between your editor and browser.
✨ Features
- Send prompts from VS Code — Write and send prompts directly from the BRIDGE sidebar.
- Attach workspace files — Choose individual files or folders to provide Claude with project context.
- Share your active file — Quickly add the file you're currently editing, including selected text.
- Send terminal output — Share selected terminal output with Claude, with or without additional file context.
- Review before sending — Preview selected files before transferring them. You can also disable repeated confirmations.
- Transfer multiple files — Send selected files as individual attachments.
- Restore your workspace — Unfinished prompts and file selections are restored when you reopen BRIDGE.
- Bring code back into VS Code — Use the companion's copy workflow to transfer Claude's proposed file changes back for review.
🚀 Requirements
Before using BRIDGE, you need:
- Visual Studio Code 1.100 or later.
- Google Chrome or a compatible Chromium-based browser.
- A Claude.ai account signed in through your own browser.
- Node.js 20+ and npm 10+ for installing and running the Chrome companion from source.
Important: BRIDGE does not provide a Claude subscription or API access. You use your own Claude account and are subject to its usage limits.
⚙️ Getting Started
1. Install BRIDGE
Install the BRIDGE extension from the Visual Studio Marketplace.
2. Install the Chrome companion
The Chrome companion is currently distributed separately.
- Download or clone the BRIDGE repository.
- Open
chrome://extensions in Chrome.
- Enable Developer mode.
- Click Load unpacked.
- Select the
packages/chrome-extension folder.
3. Connect your browser
- Open VS Code and select the BRIDGE icon in the Activity Bar.
- Run Bridge: Copy Pairing Token from the Command Palette.
- Open the BRIDGE Chrome extension popup.
- Paste your pairing token.
- Enable Allow prompt automation from VS Code.
- Click Save settings & connect.
Keep an authenticated Claude.ai tab open in Chrome.
Once connected, BRIDGE will show the connection status in VS Code and the Chrome companion.
4. Start using BRIDGE
You can now:
- Write a prompt and send it to Claude.
- Attach files using + Files.
- Add your active file or selected editor text.
- Select terminal output and send it to Claude.
- Copy Claude's proposed changes back into VS Code for review.
🔒 Privacy & Security
BRIDGE is designed around your own accounts and local environment.
- Your own Claude account: BRIDGE uses your existing authenticated Claude.ai browser session. It does not use the developer's Anthropic account or API key.
- No credential collection: BRIDGE does not ask for or store your Claude password, browser cookies, or authentication tokens.
- Local connection: The VS Code extension communicates with the Chrome companion through a local WebSocket bridge bound to
127.0.0.1.
- Selected files only: Workspace files are transferred only when you explicitly select them.
- Review before changes: Proposed file changes are presented for review and require your approval before being written.
- No automatic command execution: BRIDGE does not execute terminal commands generated by Claude.
Prompts, selected files, and terminal output are transferred to Claude through your browser session. Only send information you are comfortable sharing with Claude.
⚠️ Important Limitations
BRIDGE interacts with the visible Claude.ai website rather than an official browser automation API.
This means:
- Claude.ai interface updates may temporarily break prompt delivery.
- You must keep Chrome open with an authenticated Claude.ai tab.
- Login screens, usage limits, and other blocking pages may prevent delivery.
- BRIDGE confirms prompt delivery; it does not wait for or capture Claude's response automatically.
The browser interaction is not guaranteed to work with every Claude.ai interface update.
🛠 Troubleshooting
BRIDGE shows disconnected
- Make sure the VS Code extension is activated.
- Check that the Chrome companion is enabled.
- Verify that you copied the correct pairing token.
- Keep an authenticated Claude.ai tab open.
Claude does not receive the prompt
- Refresh the Claude.ai tab.
- Check whether Claude is showing a login screen or usage limit.
- Verify that prompt automation is enabled in the Chrome popup.
- Retry the transfer.
Files are missing from context
- Check that the files are selected.
- Review the file confirmation dialog.
- Generated, binary, ignored, and unsupported files may be excluded.
📦 Project
BRIDGE consists of:
- A Visual Studio Code extension.
- A Chrome companion extension.
- A lightweight local WebSocket bridge.
For source code, technical documentation, bug reports, and contributions, visit the project repository.
BRIDGE — Less switching. More building.
© 2026 Mesay Lemma Seboka. All rights reserved.
BRIDGE is proprietary software. The LICENSE file is included with this extension.