Claude Code 安装及使用（初级）

木子乐一
86 阅读8分钟

概述：本文会详细描述 Claude Code的安装，以及使用cc-switch来配置大模型，以及在vs code中如何安装claude code插件，以及在ccswitch中如何切换大模型

1. Claude Code安装

[Claude Code官方安装教程]（code.claude.com/docs/en/set…

系统：windows

npm install -g @anthropic-ai/claude-code
claude --version
claude

注：如果出现上图，说明claude安装成功了，但是没有配置API Key，官方的API Key需要梯子代理 登录或者注册之后获取，需要国外手机号，而且不稳定，容易被封号，我办公网根本翻不出去，所以根据其他参考文档，选择了配置国内大模型

2. cc-switch安装

cc-switch下载地址：github.com/farion1231/…

根据自己的系统环境选择相应的包，下载后安装

3. 配置国内大模型

3.1 MiniMax

MiniMax官网地址：( platform.minimaxi.com/docs/token-… )，这个地址有教大家如何配置MiniMax API的具体教程，下面是我的操作

第一步：获取MiniMax的API Key

打开链接( platform.minimaxi.com/user-center… )，会出现以下页面，点击"获取你的Key"，将出现的API Key复制，后续将用来配置到cc-switch中，这个时候还不可以用，因为你打开左边侧边栏的"余额"可以发现你的余额是0，所以接口是调不通的，下一步就是点击"开始实名认证"，这一步通过你的身份证号和银行卡来实名认证后，认证成功就会送15元的代金券，这个15元的代金券可以直接作为充值金额使用的，如下图2，现在刚刚复制的API Key就可以生效了

第二步：在cc-switch中配置MiniMax

点击右上角"+"号，弹出以下页面，选择供应商MiniMax，下面的一些内容会自动填充，唯一需要填写的是API Key，就是上一步你复制的那个API Key

第三步：配置模型名称

点击"高级选项"，看到模型映射下面的模型输入框，填入"MiniMax-M2.7"，注意模型名称一定不要填错，否则不能使用，完成后对照检查一下配置JSON，看一下ANTHROPIC_BASE_URL和模型名称是否一致，完成后点击"添加"

第四步：回到首页，点击"启用"按钮，当前Claude Code就已经成功配置MiniMax国内大模型使用了

注：这个时候你可能和我一样会关注MiniMax的"查询失败"这个字样，觉得这样就是有问题的，没配好，想要想办法把他搞好，但其实这个不影响Claude后续的使用，我也没有解决这个问题，好像是要在MiniMax上面购买套餐获取到Token Plan才会消失，我没有尝试，如果后续大家有解决方案，请告知我

第五步：在执行Claude之前，需要改一个Claude的配置，Claude之前用node安装成功后会有一个配置文件".claude.json"文件，位置在C:\用户\你的用户名.claude.json，增加一个 hasCompletedOnboarding 参数，用于绕过 claude code 的区域限制，调过Antoropic的官方登录验证

{
  "hasCompletedOnboarding": true
}

第六步：继续在终端输入Claude，出现以下情况说明Claude Code已经配置好可以使用了

第七步：查看claude的模型配置情况

启动claude后，在他的输入框中输入"/status"命令，查看模型配置

主要查看Anthropic Base Url地址和Model，你就知道在当前项目中你正在使用的模型

4. 利用Claude创建一个新项目

作为尝试，我让Claude帮我开发一个欢迎首页，目前还没有安装Claude Code插件，用的是命令行CLI交互形式

输入：使用React框架 开发一个欢迎首页

然后Claude开始运行，他会帮你创建项目文件，每一步会问你是否进行文件覆盖，你可以大致看一下，一直选择是，然后他会帮你安装好依赖包并启动，以下两张图是最后的效果和文件

这个时候我们再去MiniMax网站上查询一下我们的余额看生成这个项目用了多少token,我的花了0.32元

至此，已经掌握了配置Claude环境和使用Claude生成一个新项目

注：Claude目前都是在终端CLI环境运行的，不像其他的AI IDE一样可视化，但是我们可以安装VSCODE的插件来辅助

5. 安装VSCode的Claude Code 插件

在vscode侧边栏点击extensions，搜索"Claude Code"，点击install

如果你像我一样报这个错误，是因为vscode的版本太低了，不支持，需要更新最新版本

vscode更新版本（windows）：

  1. 完全退出vscode，关闭打开的所有vscode的窗口
  2. 不要以管理员身份打开，以普通用户权限重新打开，管理员会禁用自动更新的这个选项
  3. 点击顶部菜单 help -> Check for updates
  4. 如果有新版本，会自动下载并提示 "Restart to Update"，点击后完成更新
  5. 重新搜索插件包 Claude Code，点击install安装

安装成功后，左侧工具栏会出现Claude Code的橘色图标，点击他 会开一个侧边分栏窗口，进行可视化操作，如图所示，这个时候在对话开给你输入命令，AI会进行执行并需要你确认，这样可以继续使用啦

6. 切换别的大模型

  6.1 阿里云百炼的Qwen模型

第一步：获取API Key

阿里云百炼 必须在注册认证后，每个模型会送百万的token新人免费额度，具体操作如下

[新人免费额度链接]help.aliyun.com/zh/model-st…

来到模型广场( bailian.console.aliyun.com/cn-beijing?… )，选择其中你想尝试的模型，如图一，点击该卡片，进入模型详情页面，如图二，往下翻，可以看到你当前拥有的该模型的免费额度，我现在Qwen3.6-Plus的额度使用完了，如图三，现在我切换到Qwen3.7-Max模型，显示还有100%的额度，如果大家使用的话，为了防止超量造成的欠费，可以打开"免费额度用完即停"这个选项

图一

图二

图三

现在我们要获取API Key,刚刚的页面选择最左侧工具栏的API Key，可以看到一个页面，如果是空的，点击创建API Key就可以了，如图所示，然后复制当前的API Key以便后续配置cc-switch

第二步：cc-switch添加新的百炼模型

cc-switch中配置bailian的官方文档：( help.aliyun.com/zh/model-st… )，文档中的Token Plan,Coding Plan和按量计费的ANTHROPIC_BASE_URL是不一样的，如果使用免费额度，那么我们用的是"按量计费"的华北2的ANTHROPIC_BASE_URL地址，当然，这个地址在选择bailian供应商后会自动填写

点击右上角的"+"，选择供应商"Bailian"，将刚刚复制的API Key添加到对应位置

第三步：选择模型

点击高级选项，将你选择的比如 Qwen3.6-plus或者Qwen3.7-Max模型添加到对应的主模型的位置上，注意，模型名称一定要对，可以直接在详情页复制模型名称，如图二

第四步：启用模型

返回cc-switch首页，点击Bailian的启用，显示使用中则表示启用成功，点击第三个按钮"测试模型",可以查看是否成功连接，如图一，是模型已经配置成功；如图二，报错原因是 模型额度用完了；如图三，报错原因是 模型名称写错了，正常是"qwen3.7-max",但是如果配成"Qwen3.7-max",就是这种报错，所以模型名称一定要写对

第五步：VS Code中使用 Claude Code插件

注意，当你从MiniMax切换成Bailian模型，如果是终端命令的形式，之前的claude的命令行一直没关闭，那么这个时候使用的还是MiniMax，需要把之前的对话框关掉，用ctrl+c可以关掉，然后重新输入 claude重新启动，然后输入 /status，查看当前使用的model模型

如果是vs code的claude code插件，在切换模型的时候，有历史的claude对话框界面存在，那切换后打开原来的对话框继续输入内容，还是之前的MiniMax模型，需要重新打开一下Claude Code插件，重新加载后就是新的模型

第六步：分析错误情况

如图，

  1. 第一个API Error:500，是我在使用MiniMax模型的时候，15元的免费额度用完了，处于欠费的状态，当分析后就报了API Error:500的错误，
  2. 这个时候我成功切换了Bailian的模型，继续输入刚刚的问题，那他报了API Error:400的错误，是我切换后没有重新打开Claude对话框，导致他发现MiniMax模型已经停用了，所以包了API Error:400的错误，当我重新打开对话框，输入刚刚的问题，就可以正常使用了，如图二

avatar
文章
阅读
粉丝