Windows 新手优先

不会网络配置，也能一步一步接到 ForOpenCode

这套文档不要求你先看懂 API 文档，也不要求你先理解一堆术语。 你只需要确认自己正在用哪个工具，然后按页面一步一步填地址、填 Key、保存、重启、验证。

适合谁 第一次接触模型接入、第一次配代理、第一次改工具地址的人。

先做什么 先确认已经安装工具，再看“我该看哪一页”和“零基础准备”，最后进对应工具页。

最短路径 想先跑通一条配置，直接走“30 分钟跑通”。

直接选入口

第一步我还没安装工具先去下载并安装 CC Switch。没装好前，不要急着开始填地址和 Key。先充值我还没有额度先去控制台兑换充值额度。没额度时，后面就算 Key 和地址都填对，也可能照样用不了。先建 Key我还没有 Key按截图去控制台创建并复制一把自己的 API Key。后面所有工具页都要用到它。先读我是完全新手先把站点地址、/v1、API Key、模型 ID 这些词看明白，再开始填。分流我只想配置某个工具按你现在正在用的工具分流，直接跳到 OpenCode、OpenClaw、Codex。最快我已经有 Key走一条最短路径，优先把一个工具跑通，再回头补看完整说明。

熟手可以直接跳

直达 30 分钟跑通先成功一次，再补完整阅读。直达创建 Key还没拿到 `sk-` 密钥时先走这里。直达配置参数只想核对根地址、/v1、Key 来源时走这里。直达工具分流已经知道自己要配什么工具时直接跳。直达排障地图已经失败过，先找问题再回头读。

你会在这里得到什么

• 一套面向 Windows 新手的统一接入路径，而不是四个风格完全不同的散页。
• 一页统一的配置参数总表，专门帮你分清根地址、接口地址、/v1 和 Key 来源。
• 每个工具都按同样节奏来写：先准备、跟着做、完成后检查、失败时怎么办。
• 一张排障地图，帮你把“连不上”“鉴权失败”“保存后没生效”“旧会话没刷新”快速定位到处理动作。

如果你现在已经有点慌

从这套文档开始，不需要先理解所有概念。你只要确认两件事： 第一，你正在配置哪个工具； 第二，你有没有拿到 ForOpenCode 控制台里的 API Key。

推荐阅读顺序

1. 先看 我该看哪一页，确定自己要走哪条配置线。
2. 如果你还没装好工具，先去 先下载安装工具。
3. 再看 零基础准备，把高频术语和容易填错的字段看懂。
4. 配置前打开 配置参数总表，确认自己该填根地址还是 /v1。
5. 进入对应的工具页跟着做。
6. 如果没生效，直接去 配置失败怎么办。

先记住这一句

浏览器里打开官网，用的是“站点地址”。 工具里填模型接口，很多时候用的是“API 接口地址”。 当页面要求 OpenAI-compatible 的标准接口时，通常就要注意有没有 /v1。