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 了。