国内小白安装Claude Code桌面版完整指南：从下载到跑起来，我踩过的坑你不用再踩 说实话，我第一次装Claude Code的时候，前前后后折腾了一下

五竹的成长日记
6,879 阅读6分钟

大家好，我只五竹。

说实话，我第一次装Claude Code的时候，前前后后折腾了一下午。

不是因为它有多难，而是Claude Code更新的太快，尤其是对咱们限制这块，恨不得一天一个策略，昨天的安装方法，可能进行就不能用了。。。

把这些新出来的坑踩完了，回头看看，其实很简单！

这两天我自己摸索出来了一套最简单的方案，从零到跑起来大概10分钟。今天把这个过程完整写出来，完全不懂技术的朋友也能跟着做!!

先说一下前提：安装Claude Code需要魔法。

这个绕不过去，下载安装包和首次配置都需要。但配好之后，日常使用可以完全走国内网络，不需要一直开着翻墙工具。

Claude Code是什么？30秒讲清楚

如果你已经知道Claude Code是什么，跳过这段。

Claude Code是Anthropic做的一个AI工具。注意，是工具，不是模型。

普通的AI（ChatGPT、Claude、DeepSeek），你跟它聊天，它只能动嘴不能动手。你说"帮我整理一下文件"，它只能告诉你怎么做，活还是你自己干。

Claude Code不一样。它直接跑在你电脑上，能读你的文件、能创建新文件、能执行命令、能自己规划步骤然后一步步完成任务。

它不是在跟你聊天，它是在帮你干活。

而且它不只能写代码。公众号创作、文档整理、数据分析、自动化工作流，这些它都能干。叫"Code"只是名字起歪了。

两种安装方式

Claude Code有两种安装方式：

命令行版：在终端里输入命令安装和使用，适合有一定技术基础的人。对于小白来说，哪个黑色的命令框决定就是噩梦！咱也不教了，感兴趣的自己去搜吧！

桌面版：跟装普通软件一样，双击安装，有图形界面，适合小白。

本文重点讲Windows桌面版的安装方式。

今天这篇文章跑下来你都搞不定，你可以直接放弃了

第一步：前置准备

在开始之前，你需要准备1样东西：**魔法工具 **

下载Claude Code桌面版和CCSwitch都需要访问GitHub和claude.ai，国内直连不了。如果你已经有翻墙工具，确保能正常访问GitHub就行。

第二步：获取国产模型API Key

先说一下，国内主流的大模型基本都能接入Claude Code，包括DeepSeek、Kimi（月之暗面）、豆包（字节）、通义千问（阿里）、智谱GLM等。

个人推荐用智谱GLM，原因有两个：

  1. 智谱是完整适配了Anthropic协议的国产模型，接入Claude Code最丝滑，兼容性最好，基本不会出奇怪的报错
  2. 试用下来看GLM-5.1的效果最接近Claude大模型、

获取智谱API Key：

  1. 打开智谱开放平台：www.bigmodel.cn/invite?icod…

直接用手机登录即可，然后先进账号设置进行实名认证

image.png

image.png

2.去财务页面充米，现在不送了，有的就跳过。

image.png

  1. 然后再去www.bigmodel.cn/apikey/plat… 创建API Key

image.png

第三步：安装CCSwitch

为什么要装CCSwitch？

这是一个开源的大模型管理工具，可以让你很方便的一键切换不同模型，就不用手动修改Claude Code的配置信息了。 最重要的原因是：Claude Code桌面版新版本限制了第三方模型的接入，必须通过本地路由服务来绕过。CCSwitch就是干这个的。

下面开始安装

1.下载安装

打开GitHub发布页（需要翻墙）：github.com/farion1231/…

找到最新版本，下载 CC-Switch-vX.X.X-Windows.msi（Windows用户选这个）。

a7de22b419ce63a036cb4841960c45b2.png

双击安装，一路下一步就行。

打开如下图所示

image.png

可以看到，这个CCSwitch不仅可以为Claude Code配置大模型，同时还可以为Codex、OpenClaw等工具配置，这里咱们暂时只关注Claude Code也就是第一个！

image.png

2.配置供应商，也就是添加大模型

安装完打开CCSwitch，点右上角的橙色「+」按钮添加供应商。

image.png

下面来配置信息：

选择智谱大模型，输入api key

image.png

配置具体的智谱模型，推荐使用5和5.1版本。

image.png

这里说一个小插曲，其实HaiKu Sonnet和Opus是Claude模型的不同版本，CCSwitch为了欺骗Claude Code做了一个映射，Claude Code以为是Claude模型，其实最终调用的gmlmix

image.png

回到CCSwitch主页 ，找到添加的智谱大模型，点击启用。这里会遇到一个查询失败的问题，不用管！不影响正常使用！

image.png

4.开启路由服务

点CCSwitch左上角的齿轮图标进入设置，选择「路由」标签页。

image.png

image.png

这时候CCSwitch就在你本地跑了一个路由服务，地址是 http://127.0.0.1:15721。后面Claude Code桌面版要用这个地址。

第三步：安装Claude Code桌面版

下载：

打开 claude.ai/download，

下载Windows版安装包（需要魔法）。

双击安装，跟装普通软件一样，一路下一步。

开启开发者模式：

安装完打开Claude Code后，会进入首页，此时千万别点击登录，而是点顶部菜单栏的「Help」→「Troubleshooting」→「Enable Developer Mode」。

image.png

弹出提示点「Enable」，软件会自动重启，就会进入开发模式。

重启后顶部菜单栏会多出一个「Developer」选项，说明开发者模式开启成功。

配置Gateway连接：

点顶部菜单栏的「Developer」→「Configure Third-Party Inference」。

image.png

然后就会进入配置页面

image.png

  • Connection：选择「Gateway」
  • Gateway base URL：填 http://127.0.0.1:15721（就是CCSwitch的本地路由地址）
  • Gateway API key：随便填，不重要了

往下拉到「Model list」，点「Add」添加模型。这里必须填Anthropic官方模型名（这只最近Claude Code的限制），比如填 claude-opus-4。记得勾选「Offer 1M Context variant」。

image.png

填完后点右下角「Apply locally」，然后点「Relaunch now」重启。

image.png

第四步：验证是否成功

重启后，Claude Code 就可以直接进入主页面了。如下图所示

image.png

输入框里随便发一条消息，比如"你好，你是什么模型？"

image.png

如果能收到回复，说明配置成功了。

虽然界面上显示的是Claude的模型名，但实际回复来自智谱的GLM模型。

还记得咱们在CCSwitch里配置的映射吗？

image.png

如果报错，检查以下几点：

  1. CCSwitch是否还在运行？路由总开关是否开着？
  2. 智谱API Key是否正确？账户是否有余额？
  3. Gateway URL是否填的 http://127.0.0.1:15721？

整个流程走下来，其实就是：获取API Key → 装CCSwitch配好路由 → 装桌面版指向本地路由 → 搞定。

我踩坑的最大的坑就是Claude Code桌面版目前不能直接填国产模型名！太坑爹了~

今天就到这吧，后面我会持续分享关于Claude Code桌面版的一些用法。

说实话，如果还在用"打开网页→问问题→复制粘贴答案"这种方式用AI的人。。。真的有点像2010年拿着智能手机只打电话的那批人。

不是说不行，是太亏了。

AI已经能帮你干活了，你还在跟它聊天。这就像你雇了一个全能助理，结果每天只让他陪你唠嗑。。。

装上Claude Code，让它真正动起手来。你会发现，之前那些每天重复的破事，根本不需要你自己干。

avatar
文章
阅读
粉丝