Claude Code 完整安装与配置教程

Xdong
9 阅读4分钟

Claude Code 完整安装与配置教程

本教程将指导你在 Windows 系统上安装 Claude Code，并解决安装过程中可能遇到的环境变量问题，同时介绍如何配置 MiniMax-M2.5 模型以替代官方模型使用。

一、安装 Claude Code

1.1 官方下载方式

以管理员身份打开终端（PowerShell 或命令提示符），运行以下命令进行全局安装：

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

1.2 验证安装

安装完成后，在终端输入以下命令检查版本号，确认安装成功：

claude --version

如果正常显示版本号（如 0.3.1），则说明安装成功。

二、常见问题：环境变量配置

如果在运行 claude --version 时遇到找不到命令的错误，通常是因为 npm 的全局安装路径没有添加到系统环境变量中。请按以下步骤解决：

步骤 1：查找 npm 全局安装路径

在终端中运行：

npm config get prefix

系统会输出一个路径，通常为：C:\Users\你的用户名\AppData\Roaming\npm

步骤 2：检查路径下是否存在 claude 文件

打开文件资源管理器，进入上述路径，查看是否存在 claude 或 claude.cmd 等文件。

  • 如果有：说明安装文件已存在，只需进行下一步的环境变量配置。
  • 如果没有：说明安装未成功，请返回第一步，确保以管理员身份重新运行安装命令。

步骤 3：添加路径到系统环境变量

  1. 右键点击“此电脑” → 选择“属性” → 点击“高级系统设置” → 点击“环境变量”。
  2. 在“用户变量”列表中找到并选中 Path 变量，点击“编辑”。
  3. 点击“新建”，将你在步骤1中获取的路径（例如 C:\Users\你的用户名\AppData\Roaming\npm）粘贴进去。
  4. 点击“确定”保存所有更改。

步骤 4：重新验证

关闭所有已打开的终端窗口，然后重新打开一个新终端，再次输入 claude --version，此时应该能正常显示版本号。

三、高级配置：使用 MiniMax-M2.5 模型

如果你希望使用 MiniMax 的 M2.5 模型来驱动 Claude Code（例如国内用户访问更流畅），可以按照以下方法进行配置。重要提示： 配置前，请确保系统中没有设置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 这两个环境变量，以免干扰新配置。

方法一：使用 cc-switch 工具（强烈推荐）

1. 安装 cc-switch

npm install -g cc-switch

2. 添加 MiniMax 配置

  • 在终端运行 cc-switch 启动工具。
  • 点击界面右上角的 “+” 号。
  • 选择预设的 MiniMax 供应商，并填入你从 MiniMax 平台获取的 API Key。

3. 配置模型名称

  • 在配置界面中，将所有的模型名称字段（如 ANTHROPIC_MODEL）都修改为 MiniMax-M2.5。
  • 点击右下角的 “添加” 保存配置。

4. 启用配置

  • 回到 cc-switch 主界面，找到你刚刚添加的 MiniMax 配置，点击 “启用”。

5. 完成初始化配置

  • 编辑或创建文件：C:\Users\你的用户名\.claude.json。
  • 在该文件中添加以下内容，以标记 Claude Code 已完成初始化引导： 
    {
  "hasCompletedOnboarding": true
}

方法二：手动编辑配置文件

如果你更习惯手动操作，可以直接修改 Claude Code 的配置文件。

1. 配置 API 端点

  • 编辑或创建文件：C:\Users\你的用户名\.claude\settings.json。
  • 将以下内容填入文件，请务必将 你的MiniMax-API-Key 替换为你的真实 Key： 
    {
  "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.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.5"
  }
}

2. 完成初始化配置

  • 与上方方法一中的步骤5相同，编辑或创建 C:\Users\你的用户名\.claude.json 文件，并添加 {"hasCompletedOnboarding": true} 内容。

四、启动并使用 Claude Code

完成上述所有配置后，你就可以开始使用 Claude Code 了。

  1. 打开终端，进入你想要让 Claude 工作的项目目录（例如 cd D:\MyProject）。
  2. 在项目目录下，直接运行命令： 
    claude
  3. 首次在某个文件夹中启动时，Claude Code 会请求权限。请选择 “信任此文件夹 (Trust This Folder)”，以允许它读取和操作该目录下的文件。

现在，Claude Code 已经成功安装并配置好了 MiniMax 模型，你可以开始在终端中与它进行 AI 编程对话了。

额外提示：VS Code 插件配置

如果你使用的是 VS Code 的 Claude Code 插件，可以在插件设置中搜索 claude-code.selectedModel 并将其值设置为 MiniMax-M2.5。同时，需要在 VS Code 的设置 JSON 文件中，将 claudeCode.environmentVariables 数组配置为与上面手动配置文件中 env 对象相同的内容。

希望这篇教程能帮助你顺利安装和使用 Claude Code！如果在配置过程中遇到其他问题，欢迎随时提出。

avatar
文章
阅读
粉丝