目录

在 Claude Code 中配置 Kimi Code：完整使用指南

随着 AI 编程助手的多样化，开发者们希望能够在不同工具之间灵活切换。本文将详细介绍如何在 Claude Code 中配置 Kimi Code，让你能够同时享受两款优秀 AI 编程助手的功能。

一、Claude Code 配置体系概述

Claude Code 通过 settings.json 文件进行配置，支持以下核心功能：

• 自定义环境变量：设置 API Key、代理等
• Hooks（钩子）：在特定事件触发时执行命令
• MCP 服务器：集成第三方服务和工具
• 权限控制：精细化控制工具执行权限

配置文件位置

# 全局配置（推荐）
~/.claude/settings.json

# 项目级配置
<project-root>/.claude/settings.json

基本配置结构

{
  "env": {
    "ANTHROPIC_API_KEY": "your-api-key"
  },
  "hooks": {
    "PreToolUse": [],
    "PostToolUse": []
  },
  "mcpServers": {},
  "permissions": {
    "allow": [],
    "deny": []
  }
}

二、Kimi Code 简介

Kimi Code 是月之暗面（Moonshot AI）推出的 AI 编程助手，具有以下特点：

• 长上下文支持：支持超长文本理解和代码分析
• 中文优化：针对中文开发者场景优化
• 代码补全：智能代码补全和生成
• 多语言支持：支持 Python、JavaScript、Go、Rust 等主流语言

三、前置准备：安装 Claude Code

如果你尚未安装 Claude Code，可以参考 Kimi Code 官方文档 - 第三方 Agent 接入指南 进行安装。

安装 Node.js（MacOS / Linux）

推荐使用 fnm 安装 Node.js：

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 新开一个 terminal，让 fnm 生效
fnm install 24.3.0
fnm default 24.3.0
fnm use 24.3.0

安装 Claude Code

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

初始化配置

跳过首次启动的引导流程，直接生成配置文件：

node --eval "
    const fs = require('fs');
    const path = require('path');
    const os = require('os');
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }, null, 2), 'utf-8');
    }"

安装完成后，继续下面的 Kimi Code 配置步骤。

四、配置步骤详解

步骤 1：获取 Kimi API Key

首先，你需要在 Kimi 开放平台获取 API Key：

1. 访问 Kimi 开放平台
2. 注册/登录账号
3. 进入「API Key 管理」
4. 创建新的 API Key
5. 复制并妥善保存

步骤 2：配置环境变量

编辑 Claude Code 的 settings.json，添加 Kimi 相关环境变量：

{
  "env": {
    "ANTHROPIC_API_KEY": "your-anthropic-api-key",
    "KIMI_API_KEY": "your-kimi-api-key",
    "KIMI_BASE_URL": "https://api.moonshot.cn/v1"
  }
}

步骤 3：配置 Kimi Code MCP 服务器

在 settings.json 中添加 Kimi Code MCP 服务器配置：

{
  "mcpServers": {
    "kimi-code": {
      "command": "npx",
      "args": ["-y", "@kimi/code-mcp@latest"],
      "env": {
        "KIMI_API_KEY": "${KIMI_API_KEY}",
        "KIMI_BASE_URL": "${KIMI_BASE_URL}"
      }
    }
  }
}

或者，如果你使用 stdio 方式连接：

{
  "mcpServers": {
    "kimi-code": {
      "type": "stdio",
      "command": "kimi-code-mcp",
      "args": [],
      "env": {
        "KIMI_API_KEY": "${KIMI_API_KEY}",
        "KIMI_BASE_URL": "${KIMI_BASE_URL}"
      }
    }
  }
}

步骤 4：配置 SSE 模式（可选）

如果你希望通过 HTTP SSE 方式连接 Kimi Code：

{
  "mcpServers": {
    "kimi-code": {
      "type": "sse",
      "url": "http://localhost:3000/sse",
      "env": {
        "KIMI_API_KEY": "${KIMI_API_KEY}"
      }
    }
  }
}

步骤 5：完整配置示例

以下是一个完整的 settings.json 配置示例：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-xxxxxxxx",
    "KIMI_API_KEY": "sk-xxxxxxxx",
    "KIMI_BASE_URL": "https://api.moonshot.cn/v1"
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "pattern": "rm|del|remove",
        "command": "echo '⚠️ 警告：正在执行删除操作，请确认' && read -n 1"
      }
    ],
    "PostToolUse": []
  },
  "mcpServers": {
    "kimi-code": {
      "command": "npx",
      "args": ["-y", "@kimi/code-mcp@latest"],
      "env": {
        "KIMI_API_KEY": "${KIMI_API_KEY}",
        "KIMI_BASE_URL": "${KIMI_BASE_URL}"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
    }
  },
  "permissions": {
    "allow": [
      {
        "tool": "Bash",
        "command": "git *"
      },
      {
        "tool": "Bash",
        "command": "npm *"
      }
    ],
    "deny": [
      {
        "tool": "Bash",
        "command": "rm -rf /"
      }
    ]
  }
}

五、使用技巧

1. 快速切换 AI 助手

在 Claude Code 中，你可以通过指定工具来使用 Kimi Code：

使用 kimi-code 分析这个函数的复杂度

2. 利用 Kimi 的长上下文优势

对于需要分析大量代码或文档的场景：

请使用 kimi-code 阅读整个项目 src 目录，分析代码架构

3. 组合使用 Claude 和 Kimi

先用 kimi-code 分析这段代码的潜在问题，然后用 Claude 给出修复建议

4. 配置文件热重载

Claude Code 支持配置文件的热重载，修改 settings.json 后无需重启：

# 在 Claude Code 中执行
/reload

六、常见问题排查

问题 1：MCP 服务器连接失败

现象：提示 Failed to connect to MCP server

解决方案：

1. 检查 API Key 是否正确
2. 确认网络可以访问 Kimi API
3. 查看日志：~/.claude/logs/mcp-server.log

# 测试 API 连通性
curl https://api.moonshot.cn/v1/models \
  -H "Authorization: Bearer $KIMI_API_KEY"

问题 2：权限被拒绝

现象：工具执行被阻止

解决方案：
在 settings.json 的 permissions 中添加允许规则：

{
  "permissions": {
    "allow": [
      {
        "tool": "kimi-code",
        "command": "*"
      }
    ]
  }
}

问题 3：环境变量未生效

现象：提示 API Key 未设置

解决方案：

1. 确认环境变量名称正确
2. 使用绝对路径而非相对路径
3. 重启 Claude Code 会话

问题 4：中文输出乱码

解决方案：
在 settings.json 中添加：

{
  "env": {
    "LANG": "zh_CN.UTF-8",
    "LC_ALL": "zh_CN.UTF-8"
  }
}

七、高级配置

自定义 Kimi 模型参数

{
  "mcpServers": {
    "kimi-code": {
      "command": "npx",
      "args": ["-y", "@kimi/code-mcp@latest"],
      "env": {
        "KIMI_API_KEY": "${KIMI_API_KEY}",
        "KIMI_MODEL": "kimi-k2-0711-preview",
        "KIMI_TEMPERATURE": "0.3",
        "KIMI_MAX_TOKENS": "8192"
      }
    }
  }
}

配置代理

如果需要代理才能访问 Kimi API：

{
  "env": {
    "HTTP_PROXY": "http://127.0.0.1:7890",
    "HTTPS_PROXY": "http://127.0.0.1:7890",
    "KIMI_API_KEY": "your-api-key"
  }
}

项目级配置覆盖

在特定项目中使用不同的 Kimi 配置：

// <project>/.claude/settings.json
{
  "env": {
    "KIMI_MODEL": "kimi-k2-0711-preview"
  },
  "mcpServers": {
    "kimi-code": {
      "command": "npx",
      "args": ["-y", "@kimi/code-mcp@latest"],
      "env": {
        "KIMI_API_KEY": "${KIMI_API_KEY}"
      }
    }
  }
}

八、最佳实践

1. 密钥管理：不要将 API Key 硬编码在配置文件中，使用环境变量注入

   # 在 ~/.zshrc 或 ~/.bashrc 中
   export KIMI_API_KEY="your-api-key"

2. 版本锁定：锁定 MCP 服务器版本避免意外更新

   "args": ["-y", "@kimi/code-mcp@1.0.0"]

3. 分层配置：全局配置基础设置，项目配置覆盖特定需求

4. 定期备份：保存好你的 settings.json 配置

5. 日志监控：定期查看 MCP 日志排查问题

   tail -f ~/.claude/logs/mcp-server.log

九、总结

通过在 Claude Code 中配置 Kimi Code，你可以：

• 灵活切换：根据任务特点选择最适合的 AI 助手
• 取长补长：利用 Claude 的代码能力和 Kimi 的长上下文优势
• 统一体验：在一个界面中管理多个 AI 工具

配置完成后，你就可以在 Claude Code 中自由调用 Kimi Code，享受双倍的 AI 编程辅助体验！

---

相关资源：

• Claude Code 官方文档
• Kimi Code 文档
• MCP 协议规范

如有问题，欢迎在评论区留言交流！

文章作者：阿文

文章链接： https://www.awen.me/post/d0017ff4.html

版权声明：本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 阿文的博客！