你的 API 为什么一直报错？揭秘“伪原生”陷阱，教你用 CC Switch 满血复活 Claude Code

无知黑科技 首頁 每日列表 原始影片
實際影片長度：5:39.000。原文、繁中、雙語可點擊句子跳轉影片。
0:00.000–0:04.800
Hello,大家好,今天我们来聊聊Cloud Code和API的选择。
0:05.580–0:17.880
起因是前天介绍Obsidian的神级插件时,由于传闻Cloud Code国内使用非常不方便,所以当时只介绍了OpenCode加上AgentClient的方式。
0:18.700–0:29.860
不过考虑到Cloud Code的大名,遇到困难也要解决困难,所以今天功课了一下Clouding插件,也顺便解决了Cloud Code在国内使用的问题。
0:30.620–0:41.400
首先要知道,Cloud Code之所以这么火,除了其核心模型在逻辑推理和编码能力上的代差级优势,最关键的是它让AI真正长出了双脚。
0:42.080–0:49.940
传统的AI只是个坐在轮椅上的军师,只能出主意,而Cloud Code则是直接驻进终端的特种兵。
0:50.240–0:59.180
它不仅能思考,还能通过内置的自主工具级和可扩展的Skills,直接在本地环境中亲自完成任务。
0:59.180–1:07.900
这种思考加执行的闭环,让它从一个对话助手,彻底进化成了能稳定交付任务的数字队友。
1:08.620–1:16.700
不过官方对中国大陆用户非常不友好,您想使用官方模型,就得注册账号,解决充值问题。
1:16.700–1:22.800
这还要面临随时封号的风险,简直是上杆子送钱,还要看人间脸色。
1:23.400–1:26.160
所以另一批人则会选择推而求其次。
1:26.780–1:41.740
既然Cloud Code是基于自家Cloud 3.53NET训练微调的,那我通过第三方API网站,然后继续选择这个模型,或者它家更先进的模型,不也算体验到原汁原味的Cloud Code了吗?
1:41.740–1:44.100
而且不用担心封号问题。
1:44.780–1:53.680
说到API,前段时间给大家汇总过各种类型的API聚合站,但在Cloud Code这里,咱们得重新筛选。
1:54.000–2:00.700
官方渠道直接PASS,不仅门槛高,封号风险更是选在头上的达摩克里斯之间。
2:01.400–2:10.740
国内大厂如规矩流动,也PASS,虽然好用,但它们主打国产模型,基本不支持国外原厂模型的API转发。
2:10.740–2:18.720
国外中转,如OpenRouter,虽然模型权,但支付门槛和网络延迟依然是硬伤。
2:19.360–2:26.420
国内个人版,基本都是基于OneAPI,NewAPI开发的,这是目前性价比最高的选择。
2:26.920–2:30.840
国内外模型全覆盖,按量集费,省钱又省心。
2:30.840–2:39.380
重点来了,虽然这种个人版看起来最像,但它们普遍P着OpenAI的P,也叫伪元生。
2:40.000–2:46.800
你把它接入到Cherry Studio或者Obsidian插件里,一般都没问题,因为那些软件兼容性强。
2:46.800–2:53.940
但如果你把它直接塞给官方的Cloud Code,它那洁癖性格绝对会让你疯狂报错。
2:54.720–3:04.300
所以我们要来认识一款开源小工具,它就是CC-Switch,相当于Cloud Code与第三方API网站之间的翻译官。
3:04.300–3:16.020
它在本地接管Cloud Code的请求,把那些不标准的披着OpenAI皮的数据,洗成原汁原味的原生格式,再未回给Cloud Code。
3:16.220–3:21.520
有了它呢,管你API是真是假,通通都能稳如老狗的运行。
3:21.900–3:28.880
点击添加,将你获取的API密钥,API地址和模型名称依次填入即可,这个没什么难度。
3:29.320–3:32.220
重点是API格式这里一定要选择这个。
3:32.220–3:35.300
这是让官方程序认清的关键。
3:35.980–3:38.280
保存后呢,点一下测试模型。
3:38.840–3:42.140
提示连接成功,左上角开启开关即可。
3:42.680–3:45.260
Cloud Code就会走CC的配置了。
3:46.220–3:47.880
接下来就是安装Cloud Code了。
3:47.880–3:53.040
根据你的系统,随便找个基础教程或者让AI辅助安装即可。
3:53.460–3:54.500
这里呢,不赘述了。
3:55.060–3:58.880
但我要分享三个能让你少走弯路的避坑心得。
3:59.500–4:01.840
一,别被AI牵着鼻子走。
4:02.220–4:07.860
很多人遇到报错就去问AI,结果AI跟你谈天说地一下午,从配置聊到哲学。
4:07.940–4:11.220
最后你发现问题其实出在最开始的路径上。
4:11.720–4:17.780
记住只要CCSwitch和免灯代码搞定了,99%的问题就都消失了。
4:17.780–4:23.420
二,网络加速。如果说你在安装时发现进度条不动,别硬等。
4:23.420–4:29.060
直接让AI给你使用淘宝镜像源安装,速度瞬间起飞。
4:29.060–4:31.300
三,记出免死金牌。
4:31.420–4:39.060
安装时先别运行。先在终端执行下面这行代码,直接跳过官方账号登录。
4:39.060–4:42.700
否则你会卡在浏览器授权页面,欢迎人生。
4:42.700–4:50.140
如果你也想让Cloud Code帮你管理Opsidin仓库,直接安装Clouding插件是最优解的方式。
4:50.140–4:53.900
首先下载插件的三个核心文件。
4:53.900–4:56.220
然后打开Opsidin的设置。
4:56.220–5:04.660
第三方插件。点击文件夹图标。新建一个名为Clouding的文件夹。把三个文件丢进去。
5:04.660–5:10.820
然后回到设置页面。刷新一下就能看到Clouding。点击启用。
5:10.820–5:17.540
再点击Clouding的设置,滑动到最底部。需要填写Cloud Code的程序位置。
5:17.540–5:22.460
如果你不知道在哪儿,在终端输入以下命令,它就会告诉你了。
5:22.460–5:27.900
之后你就可以根据需求随时使用Cloud Code或者Clouding了。
5:27.900–5:29.460
好了,就给大家介绍到这里吧。
5:29.460–5:34.420
可在私信中发送关键字工具。按发布日期获取本期分享。
5:34.420–5:38.060
如果视频对你有帮助,记得转发支持。我们下期再见。
0:00.000–0:04.800
Hello,大家好,今天我们来聊聊Cloud Code和API的选择。
0:05.580–0:17.880
起因是前天介绍Obsidian的神级插件时,由于传闻Cloud Code国内使用非常不方便,所以当时只介绍了OpenCode加上AgentClient的方式。
0:18.700–0:29.860
不过考虑到Cloud Code的大名,遇到困难也要解决困难,所以今天功课了一下Clouding插件,也顺便解决了Cloud Code在国内使用的问题。
0:30.620–0:41.400
首先要知道,Cloud Code之所以这么火,除了其核心模型在逻辑推理和编码能力上的代差级优势,最关键的是它让AI真正长出了双脚。
0:42.080–0:49.940
传统的AI只是个坐在轮椅上的军师,只能出主意,而Cloud Code则是直接驻进终端的特种兵。
0:50.240–0:59.180
它不仅能思考,还能通过内置的自主工具级和可扩展的Skills,直接在本地环境中亲自完成任务。
0:59.180–1:07.900
这种思考加执行的闭环,让它从一个对话助手,彻底进化成了能稳定交付任务的数字队友。
1:08.620–1:16.700
不过官方对中国大陆用户非常不友好,您想使用官方模型,就得注册账号,解决充值问题。
1:16.700–1:22.800
这还要面临随时封号的风险,简直是上杆子送钱,还要看人间脸色。
1:23.400–1:26.160
所以另一批人则会选择推而求其次。
1:26.780–1:41.740
既然Cloud Code是基于自家Cloud 3.53NET训练微调的,那我通过第三方API网站,然后继续选择这个模型,或者它家更先进的模型,不也算体验到原汁原味的Cloud Code了吗?
1:41.740–1:44.100
而且不用担心封号问题。
1:44.780–1:53.680
说到API,前段时间给大家汇总过各种类型的API聚合站,但在Cloud Code这里,咱们得重新筛选。
1:54.000–2:00.700
官方渠道直接PASS,不仅门槛高,封号风险更是选在头上的达摩克里斯之间。
2:01.400–2:10.740
国内大厂如规矩流动,也PASS,虽然好用,但它们主打国产模型,基本不支持国外原厂模型的API转发。
2:10.740–2:18.720
国外中转,如OpenRouter,虽然模型权,但支付门槛和网络延迟依然是硬伤。
2:19.360–2:26.420
国内个人版,基本都是基于OneAPI,NewAPI开发的,这是目前性价比最高的选择。
2:26.920–2:30.840
国内外模型全覆盖,按量集费,省钱又省心。
2:30.840–2:39.380
重点来了,虽然这种个人版看起来最像,但它们普遍P着OpenAI的P,也叫伪元生。
2:40.000–2:46.800
你把它接入到Cherry Studio或者Obsidian插件里,一般都没问题,因为那些软件兼容性强。
2:46.800–2:53.940
但如果你把它直接塞给官方的Cloud Code,它那洁癖性格绝对会让你疯狂报错。
2:54.720–3:04.300
所以我们要来认识一款开源小工具,它就是CC-Switch,相当于Cloud Code与第三方API网站之间的翻译官。
3:04.300–3:16.020
它在本地接管Cloud Code的请求,把那些不标准的披着OpenAI皮的数据,洗成原汁原味的原生格式,再未回给Cloud Code。
3:16.220–3:21.520
有了它呢,管你API是真是假,通通都能稳如老狗的运行。
3:21.900–3:28.880
点击添加,将你获取的API密钥,API地址和模型名称依次填入即可,这个没什么难度。
3:29.320–3:32.220
重点是API格式这里一定要选择这个。
3:32.220–3:35.300
这是让官方程序认清的关键。
3:35.980–3:38.280
保存后呢,点一下测试模型。
3:38.840–3:42.140
提示连接成功,左上角开启开关即可。
3:42.680–3:45.260
Cloud Code就会走CC的配置了。
3:46.220–3:47.880
接下来就是安装Cloud Code了。
3:47.880–3:53.040
根据你的系统,随便找个基础教程或者让AI辅助安装即可。
3:53.460–3:54.500
这里呢,不赘述了。
3:55.060–3:58.880
但我要分享三个能让你少走弯路的避坑心得。
3:59.500–4:01.840
一,别被AI牵着鼻子走。
4:02.220–4:07.860
很多人遇到报错就去问AI,结果AI跟你谈天说地一下午,从配置聊到哲学。
4:07.940–4:11.220
最后你发现问题其实出在最开始的路径上。
4:11.720–4:17.780
记住只要CCSwitch和免灯代码搞定了,99%的问题就都消失了。
4:17.780–4:23.420
二,网络加速。如果说你在安装时发现进度条不动,别硬等。
4:23.420–4:29.060
直接让AI给你使用淘宝镜像源安装,速度瞬间起飞。
4:29.060–4:31.300
三,记出免死金牌。
4:31.420–4:39.060
安装时先别运行。先在终端执行下面这行代码,直接跳过官方账号登录。
4:39.060–4:42.700
否则你会卡在浏览器授权页面,欢迎人生。
4:42.700–4:50.140
如果你也想让Cloud Code帮你管理Opsidin仓库,直接安装Clouding插件是最优解的方式。
4:50.140–4:53.900
首先下载插件的三个核心文件。
4:53.900–4:56.220
然后打开Opsidin的设置。
4:56.220–5:04.660
第三方插件。点击文件夹图标。新建一个名为Clouding的文件夹。把三个文件丢进去。
5:04.660–5:10.820
然后回到设置页面。刷新一下就能看到Clouding。点击启用。
5:10.820–5:17.540
再点击Clouding的设置,滑动到最底部。需要填写Cloud Code的程序位置。
5:17.540–5:22.460
如果你不知道在哪儿,在终端输入以下命令,它就会告诉你了。
5:22.460–5:27.900
之后你就可以根据需求随时使用Cloud Code或者Clouding了。
5:27.900–5:29.460
好了,就给大家介绍到这里吧。
5:29.460–5:34.420
可在私信中发送关键字工具。按发布日期获取本期分享。
5:34.420–5:38.060
如果视频对你有帮助,记得转发支持。我们下期再见。
0:00.000–0:04.800
Hello,大家好,今天我们来聊聊Cloud Code和API的选择。
Hello,大家好,今天我们来聊聊Cloud Code和API的选择。
0:05.580–0:17.880
起因是前天介绍Obsidian的神级插件时,由于传闻Cloud Code国内使用非常不方便,所以当时只介绍了OpenCode加上AgentClient的方式。
起因是前天介绍Obsidian的神级插件时,由于传闻Cloud Code国内使用非常不方便,所以当时只介绍了OpenCode加上AgentClient的方式。
0:18.700–0:29.860
不过考虑到Cloud Code的大名,遇到困难也要解决困难,所以今天功课了一下Clouding插件,也顺便解决了Cloud Code在国内使用的问题。
不过考虑到Cloud Code的大名,遇到困难也要解决困难,所以今天功课了一下Clouding插件,也顺便解决了Cloud Code在国内使用的问题。
0:30.620–0:41.400
首先要知道,Cloud Code之所以这么火,除了其核心模型在逻辑推理和编码能力上的代差级优势,最关键的是它让AI真正长出了双脚。
首先要知道,Cloud Code之所以这么火,除了其核心模型在逻辑推理和编码能力上的代差级优势,最关键的是它让AI真正长出了双脚。
0:42.080–0:49.940
传统的AI只是个坐在轮椅上的军师,只能出主意,而Cloud Code则是直接驻进终端的特种兵。
传统的AI只是个坐在轮椅上的军师,只能出主意,而Cloud Code则是直接驻进终端的特种兵。
0:50.240–0:59.180
它不仅能思考,还能通过内置的自主工具级和可扩展的Skills,直接在本地环境中亲自完成任务。
它不仅能思考,还能通过内置的自主工具级和可扩展的Skills,直接在本地环境中亲自完成任务。
0:59.180–1:07.900
这种思考加执行的闭环,让它从一个对话助手,彻底进化成了能稳定交付任务的数字队友。
这种思考加执行的闭环,让它从一个对话助手,彻底进化成了能稳定交付任务的数字队友。
1:08.620–1:16.700
不过官方对中国大陆用户非常不友好,您想使用官方模型,就得注册账号,解决充值问题。
不过官方对中国大陆用户非常不友好,您想使用官方模型,就得注册账号,解决充值问题。
1:16.700–1:22.800
这还要面临随时封号的风险,简直是上杆子送钱,还要看人间脸色。
这还要面临随时封号的风险,简直是上杆子送钱,还要看人间脸色。
1:23.400–1:26.160
所以另一批人则会选择推而求其次。
所以另一批人则会选择推而求其次。
1:26.780–1:41.740
既然Cloud Code是基于自家Cloud 3.53NET训练微调的,那我通过第三方API网站,然后继续选择这个模型,或者它家更先进的模型,不也算体验到原汁原味的Cloud Code了吗?
既然Cloud Code是基于自家Cloud 3.53NET训练微调的,那我通过第三方API网站,然后继续选择这个模型,或者它家更先进的模型,不也算体验到原汁原味的Cloud Code了吗?
1:41.740–1:44.100
而且不用担心封号问题。
而且不用担心封号问题。
1:44.780–1:53.680
说到API,前段时间给大家汇总过各种类型的API聚合站,但在Cloud Code这里,咱们得重新筛选。
说到API,前段时间给大家汇总过各种类型的API聚合站,但在Cloud Code这里,咱们得重新筛选。
1:54.000–2:00.700
官方渠道直接PASS,不仅门槛高,封号风险更是选在头上的达摩克里斯之间。
官方渠道直接PASS,不仅门槛高,封号风险更是选在头上的达摩克里斯之间。
2:01.400–2:10.740
国内大厂如规矩流动,也PASS,虽然好用,但它们主打国产模型,基本不支持国外原厂模型的API转发。
国内大厂如规矩流动,也PASS,虽然好用,但它们主打国产模型,基本不支持国外原厂模型的API转发。
2:10.740–2:18.720
国外中转,如OpenRouter,虽然模型权,但支付门槛和网络延迟依然是硬伤。
国外中转,如OpenRouter,虽然模型权,但支付门槛和网络延迟依然是硬伤。
2:19.360–2:26.420
国内个人版,基本都是基于OneAPI,NewAPI开发的,这是目前性价比最高的选择。
国内个人版,基本都是基于OneAPI,NewAPI开发的,这是目前性价比最高的选择。
2:26.920–2:30.840
国内外模型全覆盖,按量集费,省钱又省心。
国内外模型全覆盖,按量集费,省钱又省心。
2:30.840–2:39.380
重点来了,虽然这种个人版看起来最像,但它们普遍P着OpenAI的P,也叫伪元生。
重点来了,虽然这种个人版看起来最像,但它们普遍P着OpenAI的P,也叫伪元生。
2:40.000–2:46.800
你把它接入到Cherry Studio或者Obsidian插件里,一般都没问题,因为那些软件兼容性强。
你把它接入到Cherry Studio或者Obsidian插件里,一般都没问题,因为那些软件兼容性强。
2:46.800–2:53.940
但如果你把它直接塞给官方的Cloud Code,它那洁癖性格绝对会让你疯狂报错。
但如果你把它直接塞给官方的Cloud Code,它那洁癖性格绝对会让你疯狂报错。
2:54.720–3:04.300
所以我们要来认识一款开源小工具,它就是CC-Switch,相当于Cloud Code与第三方API网站之间的翻译官。
所以我们要来认识一款开源小工具,它就是CC-Switch,相当于Cloud Code与第三方API网站之间的翻译官。
3:04.300–3:16.020
它在本地接管Cloud Code的请求,把那些不标准的披着OpenAI皮的数据,洗成原汁原味的原生格式,再未回给Cloud Code。
它在本地接管Cloud Code的请求,把那些不标准的披着OpenAI皮的数据,洗成原汁原味的原生格式,再未回给Cloud Code。
3:16.220–3:21.520
有了它呢,管你API是真是假,通通都能稳如老狗的运行。
有了它呢,管你API是真是假,通通都能稳如老狗的运行。
3:21.900–3:28.880
点击添加,将你获取的API密钥,API地址和模型名称依次填入即可,这个没什么难度。
点击添加,将你获取的API密钥,API地址和模型名称依次填入即可,这个没什么难度。
3:29.320–3:32.220
重点是API格式这里一定要选择这个。
重点是API格式这里一定要选择这个。
3:32.220–3:35.300
这是让官方程序认清的关键。
这是让官方程序认清的关键。
3:35.980–3:38.280
保存后呢,点一下测试模型。
保存后呢,点一下测试模型。
3:38.840–3:42.140
提示连接成功,左上角开启开关即可。
提示连接成功,左上角开启开关即可。
3:42.680–3:45.260
Cloud Code就会走CC的配置了。
Cloud Code就会走CC的配置了。
3:46.220–3:47.880
接下来就是安装Cloud Code了。
接下来就是安装Cloud Code了。
3:47.880–3:53.040
根据你的系统,随便找个基础教程或者让AI辅助安装即可。
根据你的系统,随便找个基础教程或者让AI辅助安装即可。
3:53.460–3:54.500
这里呢,不赘述了。
这里呢,不赘述了。
3:55.060–3:58.880
但我要分享三个能让你少走弯路的避坑心得。
但我要分享三个能让你少走弯路的避坑心得。
3:59.500–4:01.840
一,别被AI牵着鼻子走。
一,别被AI牵着鼻子走。
4:02.220–4:07.860
很多人遇到报错就去问AI,结果AI跟你谈天说地一下午,从配置聊到哲学。
很多人遇到报错就去问AI,结果AI跟你谈天说地一下午,从配置聊到哲学。
4:07.940–4:11.220
最后你发现问题其实出在最开始的路径上。
最后你发现问题其实出在最开始的路径上。
4:11.720–4:17.780
记住只要CCSwitch和免灯代码搞定了,99%的问题就都消失了。
记住只要CCSwitch和免灯代码搞定了,99%的问题就都消失了。
4:17.780–4:23.420
二,网络加速。如果说你在安装时发现进度条不动,别硬等。
二,网络加速。如果说你在安装时发现进度条不动,别硬等。
4:23.420–4:29.060
直接让AI给你使用淘宝镜像源安装,速度瞬间起飞。
直接让AI给你使用淘宝镜像源安装,速度瞬间起飞。
4:29.060–4:31.300
三,记出免死金牌。
三,记出免死金牌。
4:31.420–4:39.060
安装时先别运行。先在终端执行下面这行代码,直接跳过官方账号登录。
安装时先别运行。先在终端执行下面这行代码,直接跳过官方账号登录。
4:39.060–4:42.700
否则你会卡在浏览器授权页面,欢迎人生。
否则你会卡在浏览器授权页面,欢迎人生。
4:42.700–4:50.140
如果你也想让Cloud Code帮你管理Opsidin仓库,直接安装Clouding插件是最优解的方式。
如果你也想让Cloud Code帮你管理Opsidin仓库,直接安装Clouding插件是最优解的方式。
4:50.140–4:53.900
首先下载插件的三个核心文件。
首先下载插件的三个核心文件。
4:53.900–4:56.220
然后打开Opsidin的设置。
然后打开Opsidin的设置。
4:56.220–5:04.660
第三方插件。点击文件夹图标。新建一个名为Clouding的文件夹。把三个文件丢进去。
第三方插件。点击文件夹图标。新建一个名为Clouding的文件夹。把三个文件丢进去。
5:04.660–5:10.820
然后回到设置页面。刷新一下就能看到Clouding。点击启用。
然后回到设置页面。刷新一下就能看到Clouding。点击启用。
5:10.820–5:17.540
再点击Clouding的设置,滑动到最底部。需要填写Cloud Code的程序位置。
再点击Clouding的设置,滑动到最底部。需要填写Cloud Code的程序位置。
5:17.540–5:22.460
如果你不知道在哪儿,在终端输入以下命令,它就会告诉你了。
如果你不知道在哪儿,在终端输入以下命令,它就会告诉你了。
5:22.460–5:27.900
之后你就可以根据需求随时使用Cloud Code或者Clouding了。
之后你就可以根据需求随时使用Cloud Code或者Clouding了。
5:27.900–5:29.460
好了,就给大家介绍到这里吧。
好了,就给大家介绍到这里吧。
5:29.460–5:34.420
可在私信中发送关键字工具。按发布日期获取本期分享。
可在私信中发送关键字工具。按发布日期获取本期分享。
5:34.420–5:38.060
如果视频对你有帮助,记得转发支持。我们下期再见。
如果视频对你有帮助,记得转发支持。我们下期再见。

影片筆記：你的 API 为什么一直报错？揭秘“伪原生”陷阱，教你用 CC Switch 满血复活 Claude Code

一句話總結

針對中國大陸用戶使用 Claude Code 時面臨的官方渠道門檻高、封號風險及第三方 API 格式不兼容（「偽原生」）等問題，影片推薦使用開源工具 CC-Switch 作為格式轉換中介，配合國內個人版 API 聚合站，並提供安裝避坑指南與 Obsidian 插件配置方法，以實現穩定且高性價比的開發體驗。

核心重點

  1. 官方渠道的局限性：Claude Code 官方模型雖具備強大的邏輯推理與「思考加執行」閉環能力，但對中國大陸用戶不友好，涉及註冊、充值及潛在的封號風險。
  2. 第三方 API 的選擇邏輯：
  • 排除官方渠道（門檻高、風險大）。
  • 排除國內大廠（主要主打國產模型，不支持國外原廠模型 API 轉發）。
  • 排除國外中轉站（如 OpenRouter，存在支付門檻與網絡延遲）。
  • 推薦方案：國內個人版 API 聚合站（基於 OneAPI/NewAPI 開發），具備按量計費、性價比高的特點。
  1. 解決「偽原生」格式問題：
  • 問題根源：第三方 API 通常偽裝成 OpenAI 格式（即「偽原生」），直接接入官方 Claude Code 會導致報錯。
  • 解決方案：使用開源工具 CC-Switch 作為「翻譯官」，將非標準數據清洗為原生格式。
  • 配置關鍵：需填入 API 密鑰、地址、模型名稱，並關鍵性地選擇正確的 API 格式。
  1. 安裝與使用避坑指南：
  • 調試建議：不要過度依賴 AI 調試，需自行檢查路徑配置。
  • 安裝加速：若安裝進度條不動，建議使用淘寶鏡像源加速。
  • 跳過登錄：安裝後運行前，先在終端執行代碼跳過官方帳號登錄，避免卡在瀏覽器授權頁面。
  1. Obsidian 生態整合：
  • 介紹如何在 Obsidian 中安裝與配置 Clouding 插件，以實現對 Obsidian 倉庫的管理。
  • 需下載核心文件，在設置中創建名為 Clouding 的資料夾並放入文件，啟用插件後設置 Cloud Code 的程序位置。

詳細大綱

1. Cloud Code 的核心優勢與困境

  • 優勢：
  • 邏輯推理與編碼能力強。
  • 具備「思考加執行」的閉環能力。
  • 能直接操作本地環境。
  • 困境：
  • 官方對中國大陸用戶不友好。
  • 涉及註冊、充值流程。
  • 存在封號風險。

2. 第三方 API 的選擇策略

  • 排除官方渠道：門檻高、有封號風險。
  • 排除國內大廠：主打國產模型，不支持國外原廠模型 API 轉發。
  • 排除國外中轉站：如 OpenRouter，存在支付門檻與網絡延遲問題。
  • 推薦國內個人版：
  • 基於 OneAPI/NewAPI 開發。
  • 按量計費，性價比高。

3. 解決格式兼容問題：CC-Switch

  • 問題描述：第三方 API 通常偽裝成 OpenAI 格式（偽原生），直接接入官方 Cloud Code 會報錯。
  • 解決方案：使用開源工具 CC-Switch 作為「翻譯官」，將非標準數據清洗為原生格式。
  • 配置步驟：
  1. 填入 API 密鑰。
  2. 填入地址。
  3. 填入模型名稱。
  4. 關鍵步驟：選擇正確的 API 格式。

4. Cloud Code 安裝與避坑指南

  • 避坑一：不要過度依賴 AI 調試，需檢查路徑配置。
  • 避坑二：安裝時若進度條不動，使用淘寶鏡像源加速。
  • 避坑三：安裝後運行前，先在終端執行代碼跳過官方帳號登錄，避免卡在瀏覽器授權頁面。

5. Obsidian 插件 Clouding 的配置

  • 下載三個核心文件。
  • 在 Obsidian 設置中創建名為 Clouding 的資料夾並放入文件。
  • 啟用插件。
  • 設置 Cloud Code 的程序位置（通過終端命令查詢）。

工具 / 模型 / 名詞整理

  • Cloud Code：影片主要討論的 AI 編碼工具。
  • Obsidian：筆記軟體，用於管理倉庫。
  • OpenCode：提及的工具名稱。
  • AgentClient：提及的工具名稱。
  • Clouding：Obsidian 插件名稱（依逐字稿原文）。
  • Cloud 3.53NET：模型/技術名稱（依逐字稿原文，疑點見下）。
  • OpenRouter：國外 API 中轉站，被排除的選項。
  • OneAPI：國內個人版 API 聚合站基於此開發。
  • NewAPI：國內個人版 API 聚合站基於此開發。
  • Cherry Studio：提及的工具名稱。
  • CC-Switch：開源工具，用於解決格式兼容問題，作為「翻譯官」。
  • 淘寶鏡像源：用於加速安裝過程。

操作流程整理

流程一：選擇與配置第三方 API

  1. 選擇國內個人版 API 聚合站（基於 OneAPI/NewAPI）。
  2. 獲取 API 密鑰、地址及模型名稱。
  3. 下載並配置 CC-Switch 工具。
  4. 在 CC-Switch 中填入上述資訊。
  5. 關鍵操作：在 CC-Switch 中選擇正確的 API 格式，以將「偽原生」數據轉換為原生格式。

流程二：安裝與啟動 Cloud Code

  1. 使用淘寶鏡像源進行安裝（若進度條不動）。
  2. 安裝完成後，不要直接運行。
  3. 在終端執行特定代碼，跳過官方帳號登錄。
  4. 啟動 Cloud Code，避免卡在瀏覽器授權頁面。
  5. 進行調試時，檢查路徑配置，不過度依賴 AI。

流程三：配置 Obsidian 插件 Clouding

  1. 下載三個核心文件。
  2. 打開 Obsidian 設置。
  3. 創建名為 Clouding 的資料夾。
  4. 將下載的文件放入該資料夾。
  5. 啟用 Clouding 插件。
  6. 通過終端命令查詢 Cloud Code 的程序位置。
  7. 在插件設置中填寫 Cloud Code 的程序位置。

值得注意的限制或風險

  1. 官方封號風險：使用官方渠道可能面臨封號風險，因此推薦第三方方案。
  2. 格式兼容性風險：第三方 API 若未正確配置 CC-Switch，會因「偽原生」格式導致報錯。
  3. 網絡延遲與支付門檻：國外中轉站（如 OpenRouter）可能存在網絡延遲及支付障礙。
  4. 登錄卡頓風險：若未在運行前跳過官方登錄，可能會卡在瀏覽器授權頁面。
  5. 依賴 AI 調試的風險：過度依賴 AI 調試可能忽略路徑配置等基礎問題。

逐字稿辨識疑點

  • Cloud 3.53NET：逐字稿提及「Cloud Code 是基於自家 Cloud 3.53NET 訓練微调」，此名稱與常見模型名稱（如 Claude 3.5 Sonnet 等）不符，需查證是否為聽寫錯誤或特定內部版本名稱。
  • Clouding：逐字稿多次提及「Clouding 插件」及「安裝 Clouding 插件」，通常 Obsidian 相關插件名稱為 "Cloud Code" 或 "Obsidian Cloud Code" 等，"Clouding" 可能為口誤或特定插件名稱，需查證。
  • 免灯代码：逐字稿提及「只要 CCSwitch 和免灯代码搞定了」，「免灯」疑似為「免登」（免登錄）的聽寫錯誤。
  • 记出免死金牌：逐字稿提及「记出免死金牌」，疑似為「記住」或「祭出」的聽寫錯誤。
  • Opsidin：逐字稿提及「管理 Opsidin 倉庫」，疑似為「Obsidian」的聽寫錯誤。
  • Clouding 的程序位置：逐字稿要求填寫「Cloud Code 的程序位置」，但設置界面中填寫的是「Clouding 的设置」，語意上需確認是指 Cloud Code 的可執行文件路徑。

可延伸追問

  1. 國內個人版 API 聚合站（基於 OneAPI/NewAPI）具體有哪些推薦的供應商或搭建方式？
  2. CC-Switch 的開源代碼倉庫地址為何？如何確保其安全性？
  3. 「Cloud 3.53NET」具體指代何種模型或技術？是否為影片講者的自定義名稱？
  4. Obsidian 插件「Clouding」的具體功能範圍為何？是否僅限於倉庫管理？
  5. 在跳過官方登錄時，終端執行的具體代碼是什麼？

尚未產生學習筆記

請在 Telegram 指令最後加上「學習」，例如：videonote 網址 英文 雙語 學習