Developers
网关与 Sidecar
了解 WinCode 开发者模式中网关配对和 Sidecar 本地依赖的工作方式
网关与 Sidecar
开发者模式的核心由两部分组成：网关配对和 Sidecar 本地依赖。理解它们的工作方式，可以帮助您更好地配置和排查问题。
网关配对
什么是网关
网关（win-code-gateway）是一个运行在您本地电脑或局域网服务器上的中转服务。WinCode 通过它与 API 服务通信，而不是直接连接互联网上的云端接口。
使用网关的好处：
- 统一管理：局域网内多台设备可以共享同一个网关，无需每台设备单独配置 API 密钥。
- 网络适配：在企业内网环境中，网关可以作为唯一的出口，绕过网络限制。
- 安全可控：所有 API 请求经过本地网关，方便审计和管理。
配对流程
- 确保网关服务已在目标设备上启动并正常运行。
- 打开 WinCode，进入 设置 > 开发者模式。
- 在"网关地址"一栏中输入网关服务的地址（例如
http://192.168.1.100:8080）。 - 点击 配对。WinCode 会向网关发送一个配对请求。
- 网关端会弹出确认提示，确认后配对即完成。
配对成功后，WinCode 的状态栏会显示绿色的"网关已连接"。此后所有 API 请求都会通过该网关转发。
取消配对
如果需要连接到其他网关，或不再使用网关模式：
- 进入 设置 > 开发者模式。
- 在网关信息区域点击 断开配对。
- WinCode 会恢复为默认的云端连接模式。
Sidecar 本地依赖
什么是 Sidecar
Sidecar 是 WinCode 运行所需的一组本地组件，主要包括：
- Node.js 运行时：用于执行本地脚本和工具。
- Claude Code CLI：AI 对话能力的核心执行引擎。
这些组件由 WinCode 自动下载和管理，存放在应用的数据目录中，无需您手动安装或配置。
下载时机
Sidecar 组件会在以下情况自动下载：
- 首次开启开发者模式时。
- 组件版本更新时（WinCode 会自动检测并提示）。
- 组件被意外删除或损坏后重新开启开发者模式时。
下载过程通常在后台进行，不影响 WinCode 的正常使用。下载完成后，状态栏的 Sidecar 指示器会从"下载中"变为"已就绪"。
存储位置
Sidecar 组件存储在 WinCode 的应用数据目录中：
| 操作系统 | 默认路径 |
|---|---|
| Windows | %APPDATA%\WinCode\sidecars\ |
| macOS | ~/Library/Application Support/WinCode/sidecars/ |
| Linux | ~/.config/WinCode/sidecars/ |
一般无需手动访问该目录。如果 Sidecar 出现问题，可以在 Sidecar 管理 中查看修复方法。