Claude Code & Kimi K2 环境配置指南 (Windows/macOS/Ubuntu)

Claude Code & Kimi K2 环境配置指南 (Windows/macOS/Ubuntu)

本指南将引导您完成安装和配置 Claude Code 和 Kimi K2 的所有必要步骤，以利用 Kimi K2 API 的强大功能。

第一步：安装 Node.js 和 Git

在开始之前，您的系统需要安装好 Node.js 和 Git。

1. Node.js

• 下载与安装：请前往 Node.js 官方网站 下载并安装最新版本的 Node.js（建议使用 v18 或更高版本）。根据您的操作系统下载对应的安装包。
• 验证安装：安装完成后，打开您的终端（Terminal）或命令提示符（CMD），运行以下命令来验证。

  node -v
  

  如果成功安装，将会显示 Node.js 的版本号。

2. Git

• Windows: 下载并安装 Git for Windows。安装时直接使用默认选项“下一步”即可。
• macOS: Git 通常已预装。您可以在终端中运行 git --version 来检查。如果没有，系统会自动提示您安装“Command Line Developer Tools”，同意即可安装。
• Ubuntu: 在终端中运行以下命令进行安装。

  sudo apt update
  sudo apt install git
  

第二步：安装 Claude Code

接下来，我们将全局安装 Claude Code NPM 包。此步骤在不同操作系统下的主要区别在于是否需要管理员权限。

注意：为了获得最佳的安装体验，建议连接稳定的网络环境（例如使用科学上网）运行安装命令。

Windows

• 1. 以 管理员身份 打开您的 命令提示符（CMD） 或 PowerShell。
• 2. 输入并运行以下安装命令：

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

macOS / Ubuntu

• 1. 打开您的 终端（Terminal）。
• 2. 由于全局安装 npm 包需要系统权限，您需要在命令前加上 sudo。
• 3. 输入并运行以下安装命令（过程中会提示您输入电脑的登录密码）：

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

验证安装 (所有系统通用)

安装完成后，在 新的终端窗口 中运行以下命令来验证。

claude --version

如果终端成功返回版本号，则代表 Claude Code 已成功安装。

第三步：获取 Kimi K2 API Key

Claude Code 将通过 Kimi K2 API 运作，因此您需要获取一个 API Key。

1. 前往 Kimi API 平台：访问 Kimi 的 API 平台网站。
2. 注册与登录：如果您没有账户，请先注册一个新账户并登录。
3. 创建 API Key：在平台仪表盘中，找到创建 API Key 的选项。
   • 重要提示：API Key 在创建后只会显示一次，请务必立即复制并妥善保存。
4. 关于费用：
   • 新用户通常会获赠少量免费额度（例如 15 元）供测试使用。
   • 若要长期或高频率使用，建议充值至少 50 元，以解锁更高的请求速率（RPM），从而获得更流畅的体验。

第四步：配置环境变量

为了让 Claude Code 能够成功连接到 Kimi API，您需要配置两个重要的环境变量。

Windows

您可以选择以下任一方法进行配置：

• 方法一：使用命令提示符
  打开命令提示符（无需管理员），并执行以下两条命令。请确保将 "你的Kimi_API_Key" 替换为您真实的 API Key。

  setx ANTHROPIC_AUTH_TOKEN "你的Kimi_API_Key"
  setx ANTHROPIC_BASE_URL "https://api.moonshot.cn/anthropic"
  

  注意：使用 setx 设置的变量需要 重启终端 才会生效。

• 方法二：使用系统属性面板

  1. 在 Windows 搜索栏中输入“环境变量”，并选择“编辑系统环境变量”。
  2. 在“系统属性”窗口中，点击“环境变量…”。
  3. 在“系统变量”区域，点击“新建…”，并添加两个新变量。

macOS / Ubuntu

在 macOS 和 Ubuntu 系统中，环境变量通常配置在 Shell 的配置文件中。

1. 确定您的 Shell 类型
   在终端中运行 echo $SHELL。

   • 如果输出包含 zsh，您的配置文件是 ~/.zshrc。
   • 如果输出包含 bash，您的配置文件是 ~/.bashrc。

2. 编辑配置文件
   使用您喜欢的文本编辑器打开对应的文件。这里以 nano 为例（一个对新手友好的终端编辑器）。

   # 如果您使用 Zsh (macOS 默认)
   nano ~/.zshrc
   
   # 如果您使用 Bash
   nano ~/.bashrc
   

3. 添加环境变量
   在文件的末尾，添加以下两行。请将 你的Kimi_API_Key 替换为您真实的 API Key。

   export ANTHROPIC_AUTH_TOKEN="你的Kimi_API_Key"
   export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
   

   添加后，按下 Ctrl + O 保存文件，然后按 Ctrl + X 退出编辑器。

4. 使配置生效
   运行以下命令让配置立即生效（或直接重启终端）。

   # 如果您修改了 .zshrc
   source ~/.zshrc
   
   # 如果您修改了 .bashrc
   source ~/.bashrc
   

第五步：运行 Claude Code

完成所有配置后，您现在可以启动 Claude Code 了。

1. 打开一个新的终端窗口。
2. 输入以下命令：

   claude
   

3. 首次启动：在首次运行时，程序会提示您选择登录方式。请选择 “Anthropic Console account”。

完成以上步骤后，您就可以开始使用由 Kimi K2 驱动的 Claude Code 了。

第六步：报错原因

向AI发送消息后，Claude Code会提示一些错误, 比如这样：

这个原因是你没有氪金，Kimi官方赠送的免费额度每秒只能访问3次，而 Claude Code 会根据内置策略来多次调用api，很容易就超过每秒3次。

解决方案也很简单，氪金50块钱可以解决，哈哈哈哈。自己抉择吧，散会~！