Claude Code + Kimi K2 环境配置与使用指南

Oct 23, 2025

# Claude Code + Kimi K2 环境配置与使用指南

Claude Code 是 Anthropic 开发的 AI 编程助手，结合 Kimi K2 更适合中国宝宝体质。本文将详细介绍安装配置和使用方法。

# 什么是 Claude Code

Claude Code 是 Anthropic 公司开发的命令行 AI 编程工具，它可以：

  • 直接在终端中与 AI 对话
  • 分析和修改代码文件
  • 执行终端命令
  • 提供代码建议和重构
  • 支持多种编程语言

# 环境要求

  • 操作系统: macOS, Linux, Windows (WSL)
  • Node.js: 16.0 或更高版本

# 安装步骤

# 1. 安装 Node.js（若已安装请忽略此步骤）

首先确保系统已安装 Node.js：

# 检查 Node.js 版本
node --version

如果没有安装，请参考官方文档的安装指南

https://nodejs.org/zh-cn/download

# 2. 安装Claude code

或者使用 yarn：

yarn global add @anthropic-ai/claude-code

详情查看官方文档：

https://www.anthropic.com/claude-code

# 3. 检验 Claude Code 安装成功

在任意路径下，直接敲claude命令

 claude

╭─── Claude Code v2.0.21 ──────────────────────────────────────────────────────╮
│                                               │ Tips for getting started     │
│                 Welcome back!                 │ Run /init to create a CLAUD… │
│                                               │ ──────────────────────────── │
│                   ▗ ▗   ▖ ▖                   │ Recent activity              │
│                                               │ No recent activity           │
│                     ▘▘ ▝▝                     │                              │
│                                               │                              │
│   kimi-k2-turbo-preview · API Usage Billing   │                              │
│      /Users/libo/Develop/blog_playharder      │                              │
╰──────────────────────────────────────────────────────────────────────────────╯

看到welcome to Claude code可以证明是已经进入Claude code了，但此时还无法连到Claude的服务

# 4. 连接 Kimi 的大模型服务

step 1. 访问开放平台 https://platform.moonshot.cn/console/api-keys 创建获取 API Key，选择 default 默认项目。

step 2. 配置 Kimi K2 模型

请按照以下方式设置环境变量使用 kimi-k2-turbo-preview 模型，并启动 Claude。

注：kimi-k2-turbo-preview比较贵，如果你对价格敏感，可以选择 kimi-k2 慢速版模型——将下方模型替换为 kimi-k2-0905-preview 或 kimi-k2-0711-preview 来使用。

# macOS和Linux 

# Linux/macOS 启动高速版 kimi-k2-turbo-preview 模型
export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_AUTH_TOKEN=${YOUR_MOONSHOT_API_KEY}
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview
claude

# Windows 

# Windows Powershell 启动高速版 kimi-k2-turbo-preview 模型
$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic";
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"
$env:ANTHROPIC_MODEL="kimi-k2-turbo-preview"
$env:ANTHROPIC_SMALL_FAST_MODEL="kimi-k2-turbo-preview"
claude

有趣的是，Kimi的官方文档中有关于 如何在Claude code中使用Kimi的介绍

# 验证

执行完上述步骤之后，可以启动 claude 验证配置是否成功

 claude

╭─── Claude Code v2.0.21 ──────────────────────────────────────────────────────╮
│                                               │ Tips for getting started     │
│                 Welcome back!                 │ Run /init to create a CLAUD… │
│                                               │ ──────────────────────────── │
│                   ▗ ▗   ▖ ▖                   │ Recent activity              │
│                                               │ No recent activity           │
│                     ▘▘ ▝▝                     │                              │
│                                               │                              │
│   kimi-k2-turbo-preview · API Usage Billing   │                              │
│      /PATH/TO/CURRENT/DIR      │                              │
╰──────────────────────────────────────────────────────────────────────────────╯

如果输出上述内容，就代表已经成功了，此时可以通过在Claude Code中输入/status确认模型url, 或者用/model查看现在的模型

> /model 
────────────────────────────────────────────────────────────────────────────────
 Select model
 Switch between Claude models. Applies to this session and future Claude Code 
 sessions. For other/previous model names, specify with --model.

   1. Default (recommended)   Use the default model (currently Sonnet 4.5) ·
                              $3/$15 per Mtok
   2. Opus                    Legacy: Opus 4.1 for complex tasks · $15/$75 per
                              Mtok
   3. Haiku                   Haiku 4.5 for simple tasks · $1/$5 per Mtok
 ❯ 4. kimi-k2-turbo-preview   Custom model ✔

 Enter to confirm · Esc to exit

# 5. 优化启动方式

我们肯定不想每次启动Claude code的时候，都先输入4个export
所以需要把这四个命令持久写入到shell配置中，这样每次启动Claude code的时候，就只需要输入一个命令即可

# macOS和Linux 

# 通过这个命令查看当前shell是zsh还是bash
echo $SHELL

根据shell的类型分别往～/.bashrc 或～/.zshrc 文件的末尾，粘贴你这四个命令

export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_AUTH_TOKEN=${YOUR_MOONSHOT_API_KEY}
export ANTHROPIC_MODEL=kimi-k2-turbo-preview
export ANTHROPIC_SMALL_FAST_MODEL=kimi-k2-turbo-preview

# Windows

在 PowerShell 中输入以下命令来查看您的配置文件路径：

$PROFILE

这个变量会显示当前用户的 PowerShell 配置文件（通常是 Microsoft.PowerShell_profile.ps1）的完整路径。
如果文件不存在，您可以使用以下命令创建它，并用记事本（或其他文本编辑器，如VS Code）打开它进行编辑：

# 检查目录是否存在，如果不存在则创建
if (-not (Test-Path (Split-Path $PROFILE))) {
    mkdir (Split-Path $PROFILE)
}

# 如果文件不存在，则创建它，并用记事本打开
if (-not (Test-Path $PROFILE)) {
    New-Item -Path $PROFILE -Type File -Force | Out-Null
}

notepad $PROFILE

在记事本打开的 $PROFILE 文件中，添加环境变量设置和可能的别名

# =======================================================
# Kimi/Moonshot API 配置
# =======================================================

# 设置 Moonshot API Base URL
$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"

# !!! 替换为你的真实 API 密钥 !!!
# 为了安全，更好的做法是使用 Windows 凭据管理器，但为了简便，先直接设置
$env:ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"

# 设置 Kimi 模型名称
$env:ANTHROPIC_MODEL="kimi-k2-turbo-preview"
$env:ANTHROPIC_SMALL_FAST_MODEL="kimi-k2-turbo-preview"

就是这样