​
Claude Cowork / Desktop 接入 NoneLinear

Claude Desktop 的 Cowork / Code 可以通过第三方推理网关使用 NoneLinear。本文统一使用 cc-switch 本地路由配置：Claude Desktop 连接本机路由地址，cc-switch 再把 Claude 桌面应用里的模型名映射到 NoneLinear 上的真实模型 ID。
关于 Cowork 与 Code 标签页Claude Desktop 在 3P 模式下提供两个工作区：Cowork 适合资料整理、调研、长时间无人值守的代理任务；Code 是图形化的 Claude Code，可以读写本地工作目录、执行终端命令。两者共享同一份第三方推理配置。

​
配置原理

Claude Desktop 的第三方推理配置里，Gateway base URL 不直接填写 NoneLinear 的base url，而是填写 cc-switch 的本地路由地址：
请求链路如下：
这样做的关键作用是：Claude Desktop 侧仍然使用 Claude 模型名或槽位，cc-switch 在本地把这些模型名映射为 NoneLinear 上的真实模型 ID。也就是说，Claude Desktop 里的 Gateway base URL 必须和 cc-switch 里的本地路由服务地址保持一致。

​
准备工作

Windows 系统版本与虚拟化要求Cowork 在 Windows 上仅支持 Pro / Enterprise / Education / Pro for Workstations 版本，Home 版无法使用。按 Win + R 输入 winver 可查看当前 Windows 版本。确认系统版本符合要求后，建议以管理员身份安装 Claude Desktop。首次使用 Cowork 前，如果系统提示需要启用虚拟化组件，请按提示完成安装并重启系统。

​
1. 启用 Claude Desktop 开发者模式

启动 Claude Desktop 后不要登录 Anthropic 账号，先停留在登录页。
在菜单栏点击 Help → Troubleshooting → Enable Developer Mode。应用会自动重启，菜单栏会多出一个 Developer 菜单。
启用 Developer Mode 重启后，在菜单栏选择 Developer → Configure third-party inference，打开第三方推理配置面板。

​
2. 在 cc-switch 中进入 Claude 配置页

打开 cc-switch，点击顶部的 Claude Desktop / Cowork 对应图标，进入 Claude 桌面应用的供应商配置页。如果已经添加过 NoneLinear，可以直接使用当前供应商；如果还没有添加，点击右上角 + 新增。 cc-switch Claude Desktop 配置入口 NoneLinear 供应商建议按下面方式配置： 模型映射按你的实际需求填写：左侧是 Claude Desktop 发给本地路由的模型名，右侧是 cc-switch 转发到 NoneLinear 时实际请求的模型 ID。每一行只配置一个实际请求模型；下表右侧列出的多个模型只是可选示例，不是同时填写多个。
模型映射里的 NoneLinear 实际请求模型必须与 模型列表 完全一致，包括大小写、连字符和版本号。

​
3. 开启 cc-switch 本地路由

进入 cc-switch 的 设置 → 路由 页面，确认以下开关都已打开：
  1. 在主页显示本地路由开关
  2. 路由总开关
  3. 路由应用：Claude
cc-switch 开启 Claude 本地路由 默认服务地址通常是：
后续 Claude Desktop 的 Gateway base URL 就要填写这个地址。使用期间需要保持 cc-switch 运行；如果退出 cc-switch 或关闭本地路由，Claude Desktop 的请求就无法继续转发到 NoneLinear。

​
4. 对齐 Claude Desktop 的 Gateway base URL

回到 Claude Desktop 的 Configure third-party inference 面板，进入 Connection 分组，选择 Gateway (Anthropic-compatible)。 按下表填写： 这里最重要的是 Gateway base URL 要和 cc-switch 路由页里的服务地址完全一致。例如 cc-switch 显示的是 http://127.0.0.1:18080，Claude Desktop 里也必须填写 http://127.0.0.1:18080。 Claude Desktop Gateway base URL 与 cc-switch 本地路由对齐
不要在 Claude Desktop 的 Gateway base URL 里填写 https://api.nonelinear.com/anthropic。本文使用的是 cc-switch 本地路由方案，Claude Desktop 要先连本机路由，再由 cc-switch 转发到 NoneLinear。

​
5. 应用配置并进入 Cowork / Code

在 Claude Desktop 的第三方推理配置面板中点击 Apply locally。保存后需要完全退出并重新打开 Claude Desktop，让 Cowork / Code 重新读取 Gateway 和模型映射配置。
只关闭 Claude Desktop 窗口不一定等于完全退出。Windows 可以在系统托盘中右键 Claude 图标选择 Quit；macOS 可以在菜单栏选择 Claude → Quit Claude，然后再重新打开应用。
登录页出现第三方网关入口后，选择 Continue with Gateway。进入后可以在 Cowork 或 Code 里发送测试消息，例如：
如果可以正常回复，说明 Claude Desktop 已经通过 cc-switch 本地路由接入 NoneLinear。 Claude Desktop 通过 cc-switch 路由验证成功

​
常见问题

​
Claude Desktop 仍然连不上怎么办？

优先检查三件事：
  1. cc-switch 是否正在运行，并且 路由总开关 已开启。
  2. cc-switch 路由页里 Claude 是否已开启。
  3. Claude Desktop 的 Gateway base URL 是否和 cc-switch 服务地址完全一致。

​
为什么要用本地路由？

Claude Desktop 侧使用的是 Claude 模型名和第三方网关配置；cc-switch 本地路由可以在请求转发时把这些模型名映射到 NoneLinear 的真实模型 ID。这样你可以在 NoneLinear 上按需使用 Claude、DeepSeek、Kimi 等模型。

​
修改 cc-switch 模型映射后不生效怎么办？

先保存 cc-switch 配置，然后完全退出 Claude Desktop，再重新打开。Claude Desktop 读取第三方推理配置和模型信息通常需要重启当前会话。

​
相关资源