2. Linux.do
  3. 【5月7日重写】Claude Code Desktop（CC桌面版）使用第三方API的指南

【5月7日重写】Claude Code Desktop（CC桌面版）使用第三方API的指南

Aaalice 2026-04-23 09:44 1

Claude Desktop使用自定义API


感谢这位佬友的教程，让我能在CC桌面版里使用第三方模型，但是很快我就发现了一个问题，CC桌面版是不读取本地settings.json里的模型映射的，所以会出现像explore之类的子代理报错找不到claude-sonnet-4-6和claude-haiku-4-5-20251001的情况。

具体报错如下：

第一种：There's an issue with the selected model (claude-haiku-4-5-20251001). It may not exist or you may not have access to it. Run --model to pick a different model.

第二种：There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run --model to pick a different model.



以下是一份补充版本的教程



[!Note]


^-^ 目前能做到的



  • Max思考强度

  • 1M长度上下文

  • 通过CC-Switch随意切换提供商和模型配置

  • 浏览已安装的插件（侧边栏Customize）


^-^ 无法做到的（暂时没找到方法）



  • 在桌面版内安装插件（目前还是通过cli安装plugin）

  • 设置Cowork下的对话思考强度




一、CC-Switch



[!Tip]这一步可以用自己习惯的本地网关，CPA啥的都行，这里用CC-Switch只是因为我习惯用它的云同步功能



1、下载CC-Switch：GitHub - farion1231/cc-switch: A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io · GitHub

2、添加你自己的提供商配置



[!WARNING]

CC-Switch会接管你的settings.json，务必确保你备份了之前的settings.json，并将通用的配置字段写到CC-Switch的通用配置里（点击编辑通用配置按钮），往后都需要用CC-Switch来管理settings.json，善用编辑通用配置界面中的从编辑内容提取按钮！



3、点开设置，打开路由开关，并确保Claude的路由开关是打开的，然后退出设置，点开新出现的路由开关即可（开启后，选中的提供商条目会变为绿色）





二、安装CC桌面版


安装地址：Download Claude | Claude by Anthropic



[!Tip] 下载之后是一个安装包，点击后会再次下载内容，这一步需要打开梯子的TUN（虚拟网卡）模式




三、开启开发者模式


1、首次打开，先不着急登录，教程全程不需要Claude账号

2、我们需要打开左上角的菜单按钮，但是一开始这个按钮可能是无法点击到的，需要通过鼠标点击邮箱输入框，但不用输入内容（只是为了触发聚焦），连按键盘的Tab键就能选中此按钮了

3、菜单出现之后就可以用鼠标选择了，依次点击Help → Troubleshooting → Enable Developer Mode

（借用一下其他佬友教程里的图）



四、配置桌面版内第三方提供商设置


1、打开界面左上角的developer，选择Configure Third-Party Inference，进入第三方接口配置界面（确保你开启了开发者模式）



2、在右上角选择你的配置文件（这里可以配置多个来回切换，但是对于本教程来说其实意义不大）

3、配置URL和Key为：


http://127.0.0.1:5000



PROXY_MANAGED



[!Tip]上述两条配置仅针对CC-Switch的默认路由设置，PROXY_MANAGED就是CC-Switch的默认路由密钥，直接写上即可。但如果你使用的是其他工具，请自行查阅其官方文档，切勿照抄！



4、往下滚动翻阅，找到IDENTITY & MODELS的Model llst部分

添加并设置三个模型：


claude-sonnet-4-6



claude-haiku-4-5



claude-opus-4-7



[!Tip]



  • 模型名称可以自定义，但是需要加上anthropic/前缀，比如anthropic/deepseek-v4-pro，否则桌面版无法识别，但是对于本教程的本地网关路由方案来说不需要自定义名称，直接通过CC-Switch切换提供商配置即可

  • 名称不需要加上[1m]后缀，需要开启1m上下文长度只需打开Offer 1M-context variant开关即可，但切记根据模型能力选择性开启

  • 只有特定的模型名称支持直接在桌面版内切换思考强度，比如我上面的claude-sonnet-4-6、claude-haiku-4-5、claude-opus-4-7，且只有claude-opus-4-7这个模型名称支持max思考强度，所以更推荐保持上面的模型名称设置



6、改完后保存，选择Apply locally，等待重启即可



五、最终效果



  • 按下CTRL+2切换到Claude Code模式（桌面版拥有两种模式，通过左上角的Cowork-Code切换按钮进行切换）

  • 你的对话主界面的右下角模型列表应该出现一列可以选择的模型，1m上下文正常生效，且诸如explore之类的子代理正常工作

  • 如果需要切换模型，直接在CC-Switch中添加新的提供商配置，勾上通用设置的开关确保settings.json配置完整，保存后切换一下提供商配置即可

  • 切换到模型列表里的Opus 4.7，应可以选择max思考强度


完结撒花~^-^










六、致谢：


【教程】如何用功能更强大更美观的claude桌面端替代cli还能随意切换模型？ - 搞七捻三 - LINUX DO

Claude 桌面版 设置模型别名映射方法 + 开启1m上下文方法 - 开发调优 - LINUX DO

更新了claude desktop 找不到其他非claude模型了

最新回复 (19)
  • Grogu 04-23 10:43
    1楼

    Claude Pro 到期了，Desktop App 直接把 Cowork 和 Code 隐藏了，历史记录都丢了，有解吗 ^-^

  • Aaalice 楼主 04-23 11:03
    2楼

    啊这，佬，我也是第一次用桌面版，不太清楚呢 ^-^

  • fogonroad 04-23 11:19
    3楼

    有没有佬懂怎么离线安装，claude desktop的完整离线安装包安装完成后会提示要用官方下载器重新安装，并且离线安装该如何下载安装workspace的那个环境包呢？

  • Reborn 04-23 11:26
    4楼

    没账号可以登录是不是完全用不了这个软件？^-^

  • 南箕子 04-23 12:13
    5楼

    谢谢佬，这样子加 env 有效了，测试了一下新建 session 也是生效的，但是对 cowork 是不起作用的

  • nikiski 04-23 12:14
    6楼



    没招了，我写claude-opus-4-7[1m]好像超过长度了

  • (*^_^*) 04-23 12:40
    7楼

    接入any后报错


    试过了在env里配置这些都不行


    model=opus[1m]
    
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7[1m]
    
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-opus-4-7[1m]
    
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-opus-4-7[1m]
    
CLAUDE_CODE_SUBAGENT_MODEL=claude-opus-4-7[1m]
  • nikiski 04-23 12:41
    8楼

    claude-opus-4-7[1m]



    其实是因为claude-opus-4-7[1m]超长了变成了省略号…,没招了现在 ^-^

  • (*^_^*) 04-23 12:45
    9楼

    看看大佬们能不能发现什么好办法， 作为官转（bushi），any无法在 claude desktop 中用，就很难受

  • 格拉维提 04-23 13:43
    11楼

    看到有用CCS打通CC和Desktop配置的方案了，可以参考


    原理：用官方 3P Gateway 把 Claude Desktop 的 Code 页接到 cc-switch，再热切换任意兼容模型
    前言：今天中午想把ccswitch的模型放到桌面版，结果就是接不通，有佬说只能cli，但是claude自己告诉我共用底层，所以我摆弄了半天，最后终于知道，底层的确是共用的底层，但是官方文档也写了，桌面版默认只能用官方账号，要换模型只能用cli，但是想要好看有更多功能…
  • 陀飞轮 04-23 14:26
    12楼

    这还不到一小时，这帖子怎么就消失了www

  • sonemeng 04-23 14:28
    13楼

    谷歌登录要验证手机号，就很烦，又不想搞，算啦算啦，服了

  • 梵音 04-23 16:44
    14楼

    我的现在出现找不到执行 No path to Claude code executable 。 有谁遇到吗？已经配置了。


    cat “$HOME/Library/Application Support/Claude/config.json”



    
{
    
        "locale": "en-US",
    
        "userThemeMode": "system",
    
        "codeExecutablePath": "/Users/allen/.local/bin/claude",
    
        "agentMode": "local",
    
        "oauth:tokenCache": "djEww1863eKT3tj3+jGUqpBlAQ==",
    
        "dxt:allowlistEnabled:360d6f04-113c-45b3-9b09-8b5e057105fa": false,
    
        "dxt:allowlistLastUpdated:360d6f04-113c-45b3-9b09-8b5e057105fa": "2026-03-13T07:07:41.795Z",
    
        "dxt:allowlistCache:360d6f04-113c-45b3-9b09-8b5e057105fa": "djEwQcZcHH05WXfeSa4ofXO/Ww2m4uMhjapzkHjGZjre4uGlq3Gq1JSv22FfG2KovcPLdJZf+iNVi19fzGX0IloZOg==",
    
        "hasTrackedInitialActivation": true
    
}

  • zdotta 04-23 19:13
    15楼

    session应该都是保留在本地的？佬可以找一找，可以让codex用fast context找一下，然后做一个session迁移和索引，分配到对应的项目里，然后在项目里的CLAUDE.md或者AGENT.md写一下要读session索引，就可以恢复项目记忆了

  • 連清琦 04-23 19:36
    16楼

    请问cowork怎么设置这个自定义模型别名呢？

  • YaHaHa2025 04-23 19:38
    17楼

    好用吗？一直想试试，但又怕A/有遥测，封我号~ ^-^

  • gofreehj 04-23 20:21
    18楼

    There’s an issue with the selected model (MiniMax-M2.7). It may not exist or you may not have access to it. Run --model to pick a different model.


    MiniMax 订阅不行，怎么弄

    ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M2.7

    ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M2.7

    ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.7

    CLAUDE_CODE_SUBAGENT_MODEL=MiniMax-M2.7

  • YWJ 04-23 21:57
    19楼

    我也遇到了，没找到解决方案，找gpt搞了半天

  • xiaoxin095791 04-23 22:36
    20楼

    Claude Desktop使用自定义API - #274，来自 dooro 可以设置了，但似乎今天服务器不是很稳


* 帖子来源Linux.do
附近帖子
返回
飞读
随机推荐