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.4.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 | 修改代理地址

Configure your local proxy URL here (example below). The extension does not modify shell profiles such as ~/.zshrc; terminal tools need their own proxy setup if required.

在此填写本地代理完整地址（示例见下）。扩展不会修改 ~/.zshrc 等 shell 配置文件；若终端命令也需要走代理，请自行配置终端环境。

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

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

Note: When you click Enable with no proxy active, priority is autoProxy.proxyUrl → (optional) system/env detection → prompts. lastUsedProxyUrl is not used for that flow. http.proxy is written to User settings only (Cursor may forbid writing it to workspace settings). Detection does not know which app you use; you must still confirm detected addresses when applicable.

注意： 当前未使用代理时点「启用」，顺序为 设置里的 autoProxy.proxyUrl →（可选）系统/环境检测 → 引导输入；不会自动使用 lastUsedProxyUrl。http.proxy 仅写入用户设置（Cursor 等工作区写入可能被禁止）。扩展无法识别「具体是哪款软件」；检测到地址时仍可能需在界面 确认。

🔧 How It Works | 工作原理

English:

1. On startup: Check AI service connectivity (Claude, OpenAI, etc.)
2. If unreachable: Offer to enable proxy; resolve URL from last-used → proxyUrl → system/env (if enabled); detected URLs require QuickPick confirmation or port/URL input
3. If accessible: Automatically remove proxy configuration (when periodic/network-change checks run)
4. Periodic check: Background check every 60 seconds (configurable) and auto-adjust
5. Network change: Detect network interface changes and re-check immediately
6. Never modifies shell profiles (~/.zshrc, etc.) — only VS Code/Cursor http.proxy

中文:

1. 启动时：检测 AI 服务（Claude、OpenAI 等）连接状态
2. 无法连接：询问是否启用代理；地址顺序为「proxyUrl → 系统/环境检测 → 输入」；检测到的地址必须用 QuickPick 确认或改端口/输入完整 URL
3. 能够连接：在定时/网络变化检测中自动移除多余代理配置
4. 定时检测：每 60 秒（可配置）后台检测并自动调整
5. 网络变化：检测到网络接口变化时立即重新检测
6. 不修改 shell 配置（如 ~/.zshrc），只改编辑器内的 http.proxy

🐛 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.4 (Latest)

• ✅ Editor-only proxy: Only updates VS Code/Cursor http.proxy — does not modify shell profiles
• ✅ System proxy detection (autoProxy.autoDetectSystemProxy): macOS scutil, Windows WinHTTP, then env vars
• ✅ User must confirm detected URL: QuickPick to accept, change port only, or enter full URL (handles mixed-port clients like Clash Verge)
• ✅ When detection fails: Prompt for port-only (http://127.0.0.1:<port>), full URL, or open settings
• ✅ README aligned with runtime behavior

1.0.3

• ✅ 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 上给它一个 ⭐️！