开发者模式概览

开发者模式是 WinCode 中面向高级用户的一组进阶功能。开启后，您可以将 WinCode 连接到本地网关服务、自定义 API 端点，以及管理本地运行所需的依赖组件，获得更高的灵活性和可控性。

什么是开发者模式

默认情况下，WinCode 通过云端服务完成对话、工具调用和 API 交互，无需任何额外配置。开发者模式为有需要的用户提供了以下能力：

• 网关配对：将 WinCode 连接到本地运行的网关服务（win-code-gateway），使局域网内的其他设备也能通过 WinCode 访问 API 能力。
• Sidecar 本地依赖：WinCode 会在本地下载并管理 Node.js 运行时和 Claude Code CLI 等组件，确保离线或网络受限时仍可正常工作。
• 本地 API 端点：将 WinCode 的 AI 服务指向您自己部署的 API 地址，满足企业内网或私有化部署的需求。

什么时候需要开启开发者模式

大多数用户无需开启开发者模式。以下场景建议开启：

1. 企业内网环境：公司网络限制了对云端 API 的直接访问，需要通过本地网关代理请求。
2. 私有化部署：您或您的团队自建了 API 服务，希望 WinCode 直接调用本地端点。
3. 多设备共享：局域网内有多台设备需要使用 WinCode 的能力，希望通过一个网关统一管理。
4. 离线或受限网络：需要提前下载好所有运行时依赖，避免运行时因网络问题中断。

如何开启开发者模式

1. 打开 WinCode 主界面。
2. 点击右上角的 设置 图标。
3. 在左侧导航中选择 开发者模式。
4. 将顶部的开关切换为 开启 状态。

开启后，WinCode 界面底部状态栏会显示当前网关连接状态和 Sidecar 组件状态。如果所有组件就绪，状态显示为绿色"已就绪"；如果网关未启动或依赖未下载，会显示黄色提示"开发模式不可用"。

状态说明

本章内容

• 网关与 Sidecar：了解网关配对和本地依赖的工作原理
• 环境准备：确认您的系统满足开发者模式的要求
• 本地 API 端点：配置自定义的 API 服务地址
• Sidecar 管理：查看、管理和修复本地依赖组件
• 故障排查：常见问题和解决方案
• 快捷键与高级设置：面向进阶用户的快捷键和隐藏设置