Auto Proxy Switcher

Automatically detect AI service connectivity and intelligently configure HTTP proxy for VS Code/Cursor.

自动检测 AI 服务连接状态并智能配置代理的 VS Code/Cursor 扩展。

📖 Use Case | 使用场景

English

When you need to access AI services (like Claude, OpenAI) through a network proxy, but your VPN doesn't support TUN mode (or it's inconvenient to enable global mode), you have to manually configure HTTP proxy in VS Code/Cursor settings. This extension provides automatic switching functionality that configures or removes proxy based on your network environment.

中文

当你需要通过网络代理访问 AI 服务（如 Claude、OpenAI），但 VPN 不支持 TUN 模式（或不方便开启全局模式）时，需要在 VS Code/Cursor 中手动配置 HTTP 代理。本扩展提供自动切换功能，根据网络环境自动配置或移除代理。

✨ Features | 主要功能

📦 Installation | 安装

Method 1: From VS Code Marketplace | 方式 1：从市场安装

1. Open VS Code/Cursor / 打开 VS Code/Cursor
2. Go to Extensions (Cmd+Shift+X or Ctrl+Shift+X) / 进入扩展页面
3. Search for "Auto Proxy Switcher" / 搜索 "Auto Proxy Switcher"
4. Click Install / 点击安装

Method 2: From VSIX file | 方式 2：从 VSIX 文件安装

Download the .vsix file from GitHub Releases, then:

从 GitHub Releases 下载 .vsix 文件，然后：

code --install-extension auto-proxy-switcher-1.0.3.vsix

Restart VS Code/Cursor after installation. | 安装后重启 VS Code/Cursor。

🚀 Usage | 使用方法

1. Status Bar Operation | 状态栏操作

2. Command Palette | 命令面板

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux), type Auto Proxy:

按 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux)，输入 Auto Proxy：

3. Interactive Prompts | 弹窗交互

⚙️ Configuration | 配置选项

Open VS Code/Cursor settings (Cmd+, or Ctrl+,), search for autoProxy:

打开 VS Code/Cursor 设置（Cmd+, 或 Ctrl+,），搜索 autoProxy：

Customize Proxy Address | 修改代理地址

The extension will use your configured proxy address (default: http://127.0.0.1:7890). If your proxy runs on a different port, modify the configuration:

扩展会使用你配置的代理地址（默认：http://127.0.0.1:7890）。如果你的代理运行在不同的端口，请修改配置：

{
  "autoProxy.proxyUrl": "http://127.0.0.1:YOUR_PORT"
}

Common proxy software ports | 常见代理软件端口:

Note: The extension remembers your last manually configured proxy address, so if you change it in VS Code/Cursor settings, it will be used next time.

注意: 扩展会记住你上次手动配置的代理地址，因此如果你在 VS Code/Cursor 设置中修改了代理，下次会使用你修改的地址。

🔧 How It Works | 工作原理

English:

1. On startup: Check AI service connectivity (Claude, OpenAI, etc.)
2. If unreachable: Prompt to enable proxy with configured address
3. If accessible: Automatically remove proxy configuration
4. Periodic check: Background check every 60 seconds (configurable) and auto-adjust
5. Network change: Detect network interface changes and re-check immediately

中文:

1. 启动时：检测 AI 服务（Claude、OpenAI 等）连接状态
2. 无法连接：询问是否配置代理（使用配置的地址）
3. 能够连接：自动移除代理配置
4. 定时检测：每 60 秒（可配置）后台检测并自动调整
5. 网络变化：检测到网络接口变化时立即重新检测

🐛 Troubleshooting | 故障排查

Extension not loaded | 扩展未加载

English:

• Check extension directory: ~/.vscode/extensions/ or ~/.cursor/extensions/
• Restart VS Code/Cursor
• Open Developer Tools (Help → Toggle Developer Tools) and check Console

中文:

• 检查扩展目录：~/.vscode/extensions/ 或 ~/.cursor/extensions/
• 重启 VS Code/Cursor
• 打开开发者工具（Help → Toggle Developer Tools）查看控制台

Proxy configuration not working | 代理配置无效

English:

• Ensure proxy service is running (Clash/V2Ray/Shadowsocks)
• Test proxy: curl -x http://127.0.0.1:7890 https://www.google.com
• Restart VS Code/Cursor

中文:

• 确认代理服务正在运行（Clash/V2Ray/Shadowsocks）
• 测试代理：curl -x http://127.0.0.1:7890 https://www.google.com
• 重启 VS Code/Cursor

Frequent pop-ups | 频繁弹窗

English:

• Increase check interval: Set autoProxy.checkInterval to 120 or higher
• Or click "No more tips" to stop auto-detection

中文:

• 增加检测间隔：将 autoProxy.checkInterval 设为 120 或更大
• 或点击"不再提示"停止自动检测

💻 Development | 开发调试

English:

1. Open this project in VS Code/Cursor
2. Press F5 to start debugging
3. Test extension in the new Extension Development Host window

中文:

1. 在 VS Code/Cursor 中打开本项目
2. 按 F5 启动调试
3. 在新窗口中测试扩展功能

🛠️ Tech Stack | 技术栈

• TypeScript
• VS Code Extension API
• node-fetch
• Webpack

📄 License | 许可证

MIT License

🔗 Links | 链接

• GitHub Repository
• VS Code Marketplace
• Report Issues

📝 Changelog | 更新日志

1.0.3 (Latest)

• ✅ Add custom globe/proxy icon for better visual identity
• ✅ Update all references from "Cursor" to "VS Code/Cursor" for broader compatibility
• ✅ Remove install.sh script (users can install from Marketplace directly)
• ✅ Fix README to remove personal path exposure
• ✅ Improve installation documentation

1.0.2

• ✅ Update README with bilingual content (English first, Chinese parallel)
• ✅ Fix async handling in removeProxy() callbacks to ensure configuration is cleared
• ✅ Enhance user feedback after disabling proxy
• ✅ Improve proxy address description to mention user configuration

1.0.1

• ✅ Remember last used proxy address
• ✅ Add network change detection
• ✅ Add i18n support (English/Chinese)

1.0.0

• 🎉 Initial release

🌟 Support | 支持

If you find this extension helpful, please give it a ⭐️ on GitHub!

如果这个扩展对你有帮助，请在 GitHub 上给它一个 ⭐️！