Auto Proxy Switcher

Automatically detect AI service connectivity and intelligently configure HTTP proxy for VS Code/Cursor. Supports custom proxy URL/port in settings, optional system / environment proxy detection, and user-confirmed port when using detected values. Writes http.proxy to User settings only (workspace-safe on Cursor).

自动检测 AI 服务连接状态并智能配置 HTTP 代理。支持在设置中 自定义代理地址与端口、可选 系统/环境变量 辅助推断、对检测到的地址进行 端口确认或手输；仅将 http.proxy 写入用户设置，避免工作区写入限制。

📖 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 proxyUrl → system/env (if enabled) → prompts; 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) — 版本说明

English

• Custom proxy / port: Set autoProxy.proxyUrl to your full local URL (any port). This value is first priority when you enable proxy while not connected.
• No silent “last time” on Enable: lastUsedProxyUrl is not used in that flow; use settings, detection, or the input wizard instead.
• System / env hint (optional): When proxyUrl is empty and autoProxy.autoDetectSystemProxy is on — macOS scutil, Windows netsh winhttp, then HTTPS_PROXY / HTTP_PROXY / ALL_PROXY.
• Confirm detected address: QuickPick — use as-is, change port only, or enter full URL (covers mixed ports vs. system proxy, e.g. Clash Verge).
• Manual fallback: If nothing is detected — enter port only (http://127.0.0.1:<port>), full URL, or open settings.
• http.proxy scope: Written and cleared in User settings only; avoids “cannot write workspace” errors on Cursor.
• UX: Success notification includes Open Settings → autoProxy.proxyUrl; broader i18n for UI and logs.
• Privacy / scope: Does not modify shell profiles (~/.zshrc, etc.); connectivity checks only hit URLs you configure under autoProxy.testUrls.

中文

• 自定义端口/地址：在设置中填写 autoProxy.proxyUrl（完整 URL，端口自定），未开代理时点「启用」会优先使用该配置。
• 启用不自动套「上次」：未开代理时启用不会读取 lastUsedProxyUrl；请用设置、系统检测或引导输入。
• 系统/环境辅助（可关）：proxyUrl 为空且开启 autoProxy.autoDetectSystemProxy 时，依次尝试 macOS 系统代理、Windows WinHTTP、环境变量中的代理。
• 检测需确认：检测到的地址需经 QuickPick — 直接使用、只改端口 或 输入完整 URL（避免混合端口与系统展示不一致）。
• 检测失败兜底：可只输端口、输完整 URL，或 打开设置 编辑 autoProxy.proxyUrl。
• http.proxy 作用域：仅读写用户设置中的 http.proxy，不写入工作区，避免 Cursor 等工作区写入报错。
• 体验：启用成功通知可 打开设置 跳转 autoProxy.proxyUrl；界面与日志 中英 覆盖更完整。
• 范围：不修改 shell 配置文件；对外请求仅为你在 autoProxy.testUrls 中配置的连通性检测。

简列 | Short checklist

• ✅ Editor-only proxy: Only updates VS Code/Cursor http.proxy — does not modify shell profiles
• ✅ User-scope http.proxy only: Avoids writing http.proxy to workspace settings (fixes Cursor restriction errors)
• ✅ 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)
• ✅ Enable with no proxy: Uses proxyUrl / detection / prompts — not lastUsedProxyUrl
• ✅ When detection fails: Prompt for port-only (http://127.0.0.1:<port>), full URL, or open settings
• ✅ i18n for remaining UI/log strings; notification can open autoProxy.proxyUrl 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 上给它一个 ⭐️！