一、前言

有些人可能还不知道 Claude Code 是什么。简单来说，Claude Code 是一个 AI 编程助手工具，可以帮助你更高效地编写代码、调试代码、生成文档等。

另外，还有些人认为 Claude Code 只能使用 Claude 模型，实际上并非如此。Claude Code 支持接入多种大模型，包括国产大模型如智谱 GLM-4.7、MinMax M2.1 等。

还有些人可能会觉得 Claude Code 很难安装和配置，是终端命令行高手才能使用的工具，会有抵触想法。其实不然，Claude Code 的安装和配置并不复杂，使用起来也很简单。

你可以回想一下，IDEA、VS Code 也有那么多功能，不是每个都功能你都用到吧！

本文旨教你如何安装和在 Claude Code 使用国产大模型 GLM-4.7、MinMax M2.1，并介绍基本功能和操作方法。

Claude Code 是目前最火热的 AI 编程工具之一。不仅可以使用 Claude 模型，还可以接入其他大模型如智谱 GLM-4.7、MinMax M2.1 等。

智谱 GLM-4.7、MinMax M2.1 是我认为目前国产大模型中表现较好的两个，集成到 Claude Code 后，可以大幅提升代码生成质量。目前，我主要使用 Claude Code + GLM-4.7 和 MinMax M2.1 来辅助编程。

我的安装环境为 Windows 11，其他操作系统的安装步骤大同小异。

二、前期准备

在开始之前，请确保你已经具备以下条件：

1. 有 git 的环境。

2. 有安装 Node.js（不是必须，但推荐安装以防默认安装失败，建议使用最新稳定版本）。

3. 可以访问外网（如果无法访问外网，可能无法完成安装）。

如果你还没有安装 git，安装 Clade Code 会有如下截图所示的错误：

git 未安装错误截图

限于篇幅，这里不再赘述 git 和 Node.js 的安装方法，建议参考官方文档或者网上的教程进行安装。

三、安装 Claude Code

Claude Code 有很多安装方式，但是官方推荐的方式是通过命令行安装，步骤如下：

1. 打开 Claude Code 官网：https://claude.com/product/claude-code

或者访问 gitHub 仓库：https://github.com/anthropics/claude-code

复制官网提供的安装命令，如截图所示：

Claude Code 官网安装命令截图

不同操作系统的安装命令略有不同，请根据你的操作系统选择对应的命令。

2. 打开终端（Terminal）或命令提示符（Command Prompt）。

irm https://claude.ai/install.ps1 | iex

安装可能需要一些时间，一般在几分钟内完成。如果提示 Installation complete! 基本上安装成功。

为什么算是“基本上”成功？因为我在安装过程中遇到了一个问题，死活安装不上。如以下截图所示：

安装失败截图

从截图可以看到，安装提示 Installation complete! ，但是有警告信息，提示 C:\Users\xxx\.local\bin 目录找不到 claude.exe 可执行文件。

我尝试了多次命令行安装，都无法成功。如果你知道怎么解决上面的问题，欢迎评论区留言。

3. 解决安装问题

如果你也遇到类似问题，可以尝试下载 node.js，通过 npm 全局安装 Claude Code：

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

安装完成后，可以通过以下命令验证是否安装成功：

claude --version

如果能正确显示版本号，说明安装成功。

四、配置国产大模型

如果你只想使用 Claude 模型，可以跳过这一步。

安装完成后，接下来配置国产大模型 GLM-4.7 和 MinMax M2.1。

Claude Code 默认只支持 Claude 模型，需要手动添加其他模型。

1. 获取 API Key

要使用 GLM-4.7 和 MinMax M2.1，需要先获取它们的 API Key。

• GLM-4.7：注册智谱 AI 账号，登录后在控制台获取 API Key。

• MinMax M2.1：注册 MinMax AI 账号，登录后在控制台获取 API Key。

智谱 GLM-4.7 API Key 获取步骤

智谱 GLM-4.7 和 MinMax M2.1 都有 Coding plan，相对于 Claude 模型，价格更低，而且模型能力也不错，适合日常编程使用。

打开智谱 Coding plan 介绍页面：https://www.bigmodel.cn/glm-coding?ic=OAHXRZSBLI

有几种计费方式，可以根据自己的需求选择合适的套餐，目前最便宜的 Lite 首月是 20 元，如下截图所示：建议包年套餐，通过上面链接购买可以有额外折扣。

智谱 GLM-4.7 计费方式截图

注册登录后，在右上角点击 API Key，如下截图所示：

智谱 API Key 截图

进入 API Key 页面后，点击 添加新 API Key，如下截图所示：

智谱 添加 API Key 截图

填写名称后，点击 确认，如下截图所示：

智谱 确认添加 API Key 截图

添加完成后，就可以看到你的 API Key 了，如下截图所示：

智谱 查看 API Key 截图

点击上图箭头指的位置，可以复制 API Key，备用。

MinMax M2.1 API Key 获取步骤

打开 MinMax Coding plan 介绍页面：https://platform.minimaxi.com/subscribe/coding-plan?code=GEWEzLqxLF&source=link

MinMax 也有几种计费方式，可以根据自己的需求选择合适的套餐，目前最便宜的 Starter 首月是 9.9 元，比 GLM-4.7 更便宜，个人觉得能力和 GLM-4.7 相当，如下截图所示：

MinMax M2.1 计费方式截图

注册登录后，在右上角点击，选择 账户管理，如上图箭头指的位置。

进入页面后，需要注意，不要在 账户信息 页面中，创建 API Key。而是点击左侧导航栏的 订阅管理 下的 Coding Plan，如下截图所示：

MinMax API Key 页面截图

注意：MinMax Coding Plan Api Key 一旦创建，下次就无法再复制了，只能重新创建一个新的 Api Key。

2. 手动配置模型

注意不同系统配置文件路径不一样，Windows 为用户目录/.claude/settings.json，MacOS & Linux 为 ~/.claude/settings.json。如果找不到该文件，可以手动创建。

智谱 GLM-4.7 的配置示例如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

注意替换里面的 your_zhipu_api_key 为您上一步获取到的 API Key。

再编辑或新增 .claude.json 文件，Windows 为用户目录/.claude.json，MacOS & Linux 为 ~/.claude.json，添加如下内容：

 {
  "hasCompletedOnboarding": true
}

MinMax M2.1 的配置示例如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "MINIMAX_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.1"
  }
}

MINIMAX_API_KEY 需替换为您的 MiniMax API Key。

同理，也需要在 .claude.json 文件中添加如下内容。如果已经添加过，可以跳过：

 {
  "hasCompletedOnboarding": true
 }

你现在已经成功配置了国产大模型 GLM-4.7 和 MinMax M2.1。

通过这种方式配置有一个问题，就是每次想切换模型时，都需要手动修改配置文件，比较麻烦。

推荐安装 CCSwitch 工具，可以方便地在不同模型间切换。

3. 安装 CCSwitch 工具

打开 gitHub 仓库：https://github.com/farion1231/cc-switch

在页面的右侧找到 Releases，下载最新版本的压缩包。如下截图所示：

CCSwitch Releases 截图

找到你的操作系统对应的安装包。如下截图所示：

CCSwitch 下载截图

下载安装，安装完成后，打开 CCSwitch 工具。界面如下所示：

CCSwitch 界面截图

点击 添加供应商，会跳转到配置页面。如下截图所示：

CCSwitch 添加供应商截图

智谱 GLM-4.7 和 MinMax M2.1 工具默认已经集成在 CCSwitch 中，你只需要填写 API Key 即可。

如上图所示，选择 Zhipu GLM，在下面找到 API Key 输入框，填写你的智谱 API Key，然后点击 添加，如下截图所示：

CCSwitch 配置智谱截图

同理，添加 MinMax M2.1，选择 MinMax，填写 API Key，然后点击 添加。这里不再赘述。

添加完成后，回到主界面，你就可以看到已经添加的供应商了。如下截图所示：

CCSwitch 供应商截图

你现在可以通过 CCSwitch 工具方便地在不同模型间切换了。鼠标移动到某个供应商上，点击的 启动 按钮即可。

五、使用 Claude Code

安装和配置完成后，就可以开始使用 Claude Code 了。

重新打开终端，输入以下命令启动 Claude Code：

claude

如果一切正常，会看到 Claude Code 的欢迎界面。如下截图所示：

Claude Code 欢迎界面截图

选择你喜欢的主题回车，就会显示如下截图：

Claude Code 使用方式

Claude Code 默认提供两种使用方式：

1. 账号登录使用 Claude 模型。

2. API Key 方式使用 Claude 模型。

如果你想使用国产大模型 GLM-4.7 或 MinMax M2.1，这一步无法选择。可以在 .claude.json 文件中添加如下内容：

 {
  "installMethod": "native"
 }

就可以跳过登录步骤，重新启动 Claude Code，即可直接使用配置的国产大模型。Claude Code 主界面如下截图所示：

Claude Code 主界面截图

你会在主界面左边看到你配置的模型名称，如上图箭头指的位置。

我不打算在这里详细介绍 Claude Code 的使用方法，官方文档已经写得非常详细，建议参考官方文档学习使用： https://code.claude.com/docs/en/overview

我这里只介绍几个常用的功能，这几个功能我觉得可以覆盖大部分使用场景。

1. 初始化 init 命令

Claude Code 使用 init 命令

不要一上来就开始让 Claude Code 帮你写代码，在 Claude Code 中，建议用 /init 命令，初始化项目。

它会在项目根目录下创建一个 CLAUDE.md 文件。

这个文件不是给人看的，是给 AI 看的。它会一直在 Claude 的上下文窗口里，充当项目的“核心准则”。

里面要放什么？

• 项目核心目标

• 架构概览

• 代码设计规范（比如命名规则、目录结构）

• 核心约束条件

注意： 别把所有文档都塞进去，保持精简，其他细节通过链接引用。

2. 使用 @ 提供上下文

Claude Code 使用 @ 提供上下文

Claude Code 有一个非常强大的功能，就是可以通过 @ 符号，快速提供上下文。

虽然 Claude Code 会自动读取项目文件，但有时候你需要让它关注某个特定文件或目录。这样会大幅提升它的理解和生成质量，也会节省 Token。

例如：

• @src/utils/helpers.ts — 让 Claude 关注这个文件的内容。

• @src/components/ — 让 Claude 关注这个目录下的所有文件。

• @mcp:context7 — 启用或禁用 MCP 服务器。

这样，Claude 就能快速获取你想要它关注的上下文，提升工作效率。

3. 使用 ! 运行 Bash 命令

Claude Code 使用 ! 运行 Bash 命令

Claude Code 支持直接在对话中运行 Bash 命令。 例如：

!git status

它会直接在终端运行 git status 命令，并返回结果。

4. 使用 /clear 清理上下文，开启新对话

Claude Code 使用 /clear 命令清理上下文，开启新对话

太长的对话上下文会影响大模型的理解能力，导致生成结果不准确。或者过于混乱。你可以使用 /clear 命令，清理当前对话上下文，开启一个新的对话。

5. 使用 /compact 压缩上下文

Claude Code 使用 /compact 命令压缩上下文

当对话上下文过长时，可以使用 /compact 命令，压缩当前对话上下文，只保留核心信息，删除冗余内容。这样可以提升大模型的理解能力，避免上下文过长导致的问题。

6. Claude Code 基本交互方式

Claude Code 切换交互模式

Claude Code 提供了三种基本交互方式，适用于不同的编程任务，你可以通过  Shift+Tab 循环切换：

1. 解释模式：默认交互方式，适用于代码解释、调试、优化等任务。

2. 修改模式：适用于代码生成、文档生成等任务。

3. 计划模式：适用于多轮对话、需求澄清。

默认在解释模式下，你可以直接输入问题或需求，Claude 会根据上下文进行回答，如果需要生成代码或文档，它会自动切换到修改模式，前提是经过你的允许。

如果你的任务比较复杂，建议使用计划模式，帮助 Claude 更好地理解任务需求。

IDE 中使用 Claude Code

如果你不习惯在终端中使用 Claude Code，可以在常用的 IDE 中使用，比如 VSCode、Cursor、JetBrains 中使用。

在 VSCode 中使用 Claude Code

打开 VSCode 的扩展市场，搜索 Claude Code，找到插件后点击安装。如下截图所示：

VSCode Claude Code 插件截图

安装完成后，你就可以在 VSCode 右下角看到 Claude Code 的图标了。如下截图所示：

VSCode 右下角 Claude Code 图标截图

点击图标，打开 Claude Code 面板，就可以开始使用了。如下截图所示：

VSCode Claude Code 面板截图

打开面板后，需要等待一段时间，就可以使用 Claude Code 了。

至于 Cursor 和 VSCode 类似，这里不再赘述，建议参考官方文档学习使用。

JetBrains 系列 IDE 也可以安装 Claude Code 插件，个人觉得在不好用，还不如直接在终端中使用。

六、总结

通过本文的介绍，相信你已经掌握了 Claude Code 的安装和基本使用方法。限于篇幅，本文只介绍了部分功能和操作方法，更多高级功能和技巧，我计划在后续的文章中进行介绍，敬请期待。

说一下我个人的使用体验：

1. Claude Code 的安装和配置并不复杂，按照本文的步骤操作，一般都能顺利完成。

2. Claude Code 不能代码补全，但是在代码生成、调试、文档生成等方面表现出色。如果需要代码补全功能，建议搭配使用其他工具，如 GitHub Copilot、Cursor 等。

3. Claude Code 没有撤回给你，建议每完成一个任务就提交一下代码，避免太大改动导致你无法确定哪些是 Claude Code 修改导致的问题。不过，你也可以告诉 Claude Code 让它帮你撤回代码，但不一定准确。

4. Claude Code 还有很多高级功能和技巧，建议参考官方文档，深入学习和探索。

希望本文能帮助你顺利安装和使用 Claude Code，提升编程效率。如果有任何问题或建议，欢迎在评论区留言讨论。

参考于陈豆豆和陈苗苗文章