Claude Code 与 Kimi K2 环境配置指南
本指南将引导您完成安装和配置 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'，同意即可安装。
验证安装: 在终端中运行 git --version 验证安装，成功的话会返回版本号。
Ubuntu: 在终端中运行以下命令进行安装。
sudo apt update && sudo apt install git
第二步：安装 Claude Code
接下来，我们将全局安装 Claude Code NPM 包。此步骤在不同操作系统下的主要区别在于是否需要管理员权限。
*注意：为了获得最佳的安装体验，建议连接稳定的网络环境运行安装命令。
Windows
- 以 管理员身份 打开您的 命令提示符（CMD） 或 PowerShell。
输入并运行以下安装命令：
npm install -g @anthropic-ai/claude-code
macOS / Ubuntu
-
打开您的 终端（Terminal）。
-
由于全局安装
npm包需要系统权限，您需要在命令前加上sudo。
输入并运行以下安装命令（过程中会提示您输入电脑的登录密码）：
sudo npm install -g @anthropic-ai/claude-code
验证安装 (所有系统通用)
安装完成后，在 新的终端窗口 中运行以下命令来验证。
claude --version
如果终端成功返回版本号，则代表 Claude Code 已成功安装。
第三步：获取 Kimi K2 API Key
Claude Code 安装成功，这时它还不能工作，因为需要登录官方或者其他模型厂商才可以。因为我们用 Kimi K2 API 运作，因此我们先去获取一个 Kimi K2 的 API Key 来登录。
你可以把这个 API Key 理解成访问 Kimi 模型时需要用到的凭证。
-
前往 Kimi API 平台：访问 Kimi 的 API 平台网站。
-
注册与登录：如果您没有账户，请先注册一个新账户并登录。
-
创建 API Key：在平台仪表盘中，找到创建 API Key 的选项。
-
关于费用：
- 新用户通常会获赠少量免费额度供测试使用。
- 若要长期或高频率使用，建议充值以解锁更高的请求速率（RPM），从而获得更流畅的体验。
重要提示：API Key 在创建后只会显示一次，请务必立即复制并妥善保存。
第四步：配置环境变量
为了让 Claude Code 能够成功连接到 Kimi API，让我们把 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 设置的变量需要 重启终端 才会生效。
macOS / Ubuntu
在 macOS 和 Ubuntu 系统中，环境变量通常配置在 Shell 的配置文件中。
- 确定您的 Shell 类型
在终端中运行
echo $SHELL。- 如果输出包含
zsh，您的配置文件是~/.zshrc。 - 如果输出包含
bash，您的配置文件是~/.bashrc。
- 如果输出包含
编辑配置文件
使用您喜欢的文本编辑器打开对应的文件。这里以 nano 为例（一个对新手友好的终端编辑器）。
# 如果您使用 Zsh (macOS 默认)
nano ~/.zshrc
# 如果您使用 Bash
nano ~/.bashrc
添加环境变量
在文件的末尾，添加以下两行。请将 你的 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 退出编辑器。
使配置生效 运行以下命令让配置立即生效（或直接重启终端）。
# 如果您修改了 .zshrc
source ~/.zshrc
# 如果您修改了 .bashrc
source ~/.bashrc
第五步：运行 Claude Code
到此所有准备工作已经完成！让我们启动 Claude Code & Kimi K2 吧！
- 打开一个新的终端窗口。
完成以上步骤后，您就可以开始使用由 Kimi K2 驱动的 Claude Code 了。我们尝试和它对话，收到它的回复后，就可以正常使用了。
登录成功，会显示如下界面。可以看到 API Base URL 是我们刚才配置好的；还可以看到黄色字体提示我在家目录下，建议我在项目目录下使用。
接着会询问你是否运行在当前目录使用 Claude，我们选 Yes, process 回车。
然后进入到安全提示页面，直接回车。
首次启动：在首次运行时，程序会提示你选择登录方式。请选择 'Anthropic Console account'。
输入 claude 命令，你会看到你选择主题的选项，方向键上下可以切换主题，我这里默认选 Dark mode，回车确认：
claude
第六步：报错原因
1、登录报错
一般都是 第四步：配置环境变量 中配置的不对，仔细再重新配置一下。只要配置对了，肯定能登陆成功的。
2、对话报错
向 AI 发送消息后，Claude Code 会提示一些错误。
这个原因是你没有充值，Kimi 官方赠送的免费额度每秒只能访问 3 次，而 Claude Code 会根据内置策略来多次调用 api，很容易就超过每秒 3 次。
解决方案也很简单，充值一定金额可以解决，具体请参考官方文档。
