Claude Code 使用 Kimi K2 驱动配置

Claude Code 使用 Kimi K2 驱动配置指南

一、准备工作

1. 环境要求

   • 操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或 Windows (通过 WSL 2)
   • Node.js 18+（推荐 v20+）
   • npm 包管理器

2. 获取 Kimi API Key

   • 访问 Moonshot AI 开放平台
   • 注册并创建 API Key（默认项目即可）
   • 保存 API Key 用于后续配置

二、安装 Claude Code

1. 全局安装

   # 卸载旧版本（如有）
   npm uninstall -g @anthropic-ai/claude-code
   
   # 安装最新版本
   npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
   
   # 验证安装
   claude --version  # 应显示 1.0.41+

三、配置 Kimi K2 驱动

方法一：环境变量配置（推荐）

1. 临时配置（当前终端有效）

   # Linux/macOS
   export ANTHROPIC_API_KEY="你的Kimi API Key"
   export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
   
   # Windows PowerShell
   $env:ANTHROPIC_API_KEY = "你的Kimi API Key"
   $env:ANTHROPIC_BASE_URL = "https://api.moonshot.cn/anthropic"

2. 永久配置

   # Linux/macOS（添加到 ~/.bashrc 或 ~/.zshrc）
   echo 'export ANTHROPIC_API_KEY="你的Kimi API Key"' >> ~/.bashrc
   echo 'export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"' >> ~/.bashrc
   source ~/.bashrc

方法二：配置文件方式

1. 创建项目专属配置

   mkdir -p ~/projects/claude-demo/.claude
   cat > ~/projects/claude-demo/.claude/settings.json << EOF
   {
     "env": {
       "ANTHROPIC_API_KEY": "你的Kimi API Key",
       "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
       "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 32000
     }
   }
   EOF

方法三：使用 kimi-cc 工具（一键配置）

bash -c "$(curl -fsSL https://raw.githubusercontent.com/LLM-Red-Team/kimi-cc/refs/heads/main/install.sh)"
# 按照提示输入 Kimi API Key

四、验证配置

1. 启动 Claude Code

   cd ~/projects/claude-demo
   claude --debug --print "hello world"

2. 成功标志

   • 终端显示 Connected to Moonshot API
   • 输出 hello world 及调试信息

五、VS Code 集成（Cline 插件）

1. 安装 Cline 插件

   • 在 VS Code 扩展商店搜索 Cline 并安装

2. 配置插件

   • 打开 Cline 设置
   • API Provider 选择 Anthropic
   • 输入 Kimi API Key
   • 勾选 Use custom base URL 并填入 https://api.moonshot.cn/anthropic
   • 模型选择 claude-opus-4-20250514（实际使用 Kimi K2）

六、常见问题解决

1. API 连接错误

   • 检查 Base URL 是否正确（国内用户必须使用 https://api.moonshot.cn/anthropic）
   • 验证 API Key 是否有效（可在 开放平台 重新生成）

2. 权限问题

   • 首次运行时同意文件访问权限
   • 或创建权限配置文件：

     // .claude/settings.local.json
     {
       "permissions": {
         "allow": ["Read(*)", "Edit(*)", "Write(*)"]
       }
     }

3. Node.js 版本问题

   # 升级 Node.js
   npm install -g n
   n stable

七、最佳实践

1. 性能优化

   • Kimi K2 建议温度值设为 0.6
   • 上下文窗口设置为 128000 tokens

   export CLAUDE_CODE_MAX_CONTEXT_TOKENS=128000

2. 成本控制

   • Kimi API 定价：输入 4 元/百万 tokens，输出 16 元/百万 tokens
   • 建议账户预存 50 元以上避免速率限制

3. 功能探索

   • 尝试生成 3D 场景：claude "创建一个3D HTML山脉场景，包含昼夜光照变化"
   • 代码重构：claude "将这个Python函数转换为Rust，并优化性能"

注意：Kimi K2 模型目前不支持图片理解功能，使用时请禁用浏览器工具。完整配置文档可参考 Moonshot AI 官方指南。