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

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

第一步：安装 Node.js 和 Git

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

下载与安装 ：请前往 Node.js 官方网站下载并安装最新版本的 Node.js（建议使用 v18 或更高版本）。根据您的操作系统下载对应的安装包。
验证安装 ：安装完成后，打开您的终端（Terminal）或命令提示符（CMD），运行以下命令来验证。
bash 复制代码
```
node -v
```
如果成功安装，将会显示 Node.js 的版本号。

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

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

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

1. 打开您的 终端（Terminal）。
1. 由于全局安装 npm 包需要系统权限，您需要在命令前加上 sudo。
1. 输入并运行以下安装命令（过程中会提示您输入电脑的登录密码）：
  bash 复制代码
```
sudo npm install -g @anthropic-ai/claude-code
```

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

bash 复制代码

claude --version

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

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

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

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

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

方法一：使用命令提示符

打开命令提示符（无需管理员），并执行以下两条命令。请确保将 "你的Kimi_API_Key" 替换为您真实的 API Key。
bash 复制代码
```
setx ANTHROPIC_AUTH_TOKEN "你的Kimi_API_Key"
setx ANTHROPIC_BASE_URL "https://api.moonshot.cn/anthropic"
```
注意：使用 setx 设置的变量需要 重启终端 才会生效。
方法二：使用系统属性面板
1. 在 Windows 搜索栏中输入"环境变量"，并选择"编辑系统环境变量"。
2. 在"系统属性"窗口中，点击"环境变量..."。
3. 在"系统变量"区域，点击"新建..."，并添加两个新变量。

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

确定您的 Shell 类型

在终端中运行 echo $SHELL。
- 如果输出包含 zsh，您的配置文件是 ~/.zshrc。
- 如果输出包含 bash，您的配置文件是 ~/.bashrc。
编辑配置文件

使用您喜欢的文本编辑器打开对应的文件。这里以 nano 为例（一个对新手友好的终端编辑器）。
bash 复制代码
```
# 如果您使用 Zsh (macOS 默认)
nano ~/.zshrc

# 如果您使用 Bash
nano ~/.bashrc
```
添加环境变量

在文件的末尾，添加以下两行。请将 你的Kimi_API_Key 替换为您真实的 API Key。
bash 复制代码
```
export ANTHROPIC_AUTH_TOKEN="你的Kimi_API_Key"
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
```
添加后，按下 Ctrl + O 保存文件，然后按 Ctrl + X 退出编辑器。
使配置生效

运行以下命令让配置立即生效（或直接重启终端）。
bash 复制代码
```
# 如果您修改了 .zshrc
source ~/.zshrc

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

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

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