Claude Code 如何使用 Kimi API 完整教程

前言

Claude Code 是 Anthropic 推出的智能编程助手，但很多国内用户由于网络或 API 限制无法直接使用 Claude 的官方服务。好消息是，我们可以通过配置 Kimi API 来在 Claude Code 中使用 Kimi 的强大模型。本文将详细介绍整个配置过程。

---

一、安装 Claude Code

1.1 官方文档

首先访问 Claude Code 官方文档了解基本信息：

• 官网链接：https://code.claude.com/docs/zh-CN/overview

1.2 一键安装

根据你的操作系统，选择对应的安装命令：

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

⚠️ 注意：如果下载失败，请检查网络连接，或者尝试使用其他网络工具。

1.3 验证安装

安装完成后，在终端输入以下命令验证：

claude --version

---

二、初始配置

2.1 首次启动

在目标项目文件夹内执行：

claude

首次启动会引导你进行配置：

1. 颜色外观配置 - 选择你喜欢的主题风格
2. API 配置 - Claude 官方提供的三种方式都不支持 Kimi，所以我们需要跳过此步骤

2.2 退出初始配置

由于官方配置不支持 Kimi API，直接按 两次 Ctrl+C 退出 Claude Code，然后手动修改配置文件。

---

三、配置 Kimi API

3.1 找到配置文件

Claude Code 的配置文件位于用户主目录下：

• macOS/Linux: ~/.claude.json
• Windows: %USERPROFILE%\.claude.json

3.2 编辑配置文件

使用你喜欢的编辑器打开配置文件：

# macOS/Linux
nano ~/.claude.json

# 或使用 VS Code
code ~/.claude.json

3.3 添加 Kimi API 配置

在配置文件中添加以下 env 配置段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_AUTH_TOKEN": "sk-kimi-xxxxx",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000"
  }
}

3.4 配置项说明

配置项	说明	建议值
ANTHROPIC_BASE_URL	Kimi API 的基础地址	https://api.kimi.com/coding/
ANTHROPIC_AUTH_TOKEN	你的 Kimi API Key	从 Kimi 开放平台获取
ANTHROPIC_MODEL	主要使用的模型	kimi-k2.5
ANTHROPIC_SMALL_FAST_MODEL	快速响应模型	kimi-k2.5
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	禁用非必要流量	1
API_TIMEOUT_MS	API 超时时间（毫秒）	600000 (10分钟)

---

四、获取 Kimi API Key

4.1 注册 Kimi 开放平台账号

1. 访问 Kimi 开放平台
2. 使用手机号或邮箱注册账号
3. 完成实名认证（如需）

4.2 创建 API Key

1. 登录后进入控制台
2. 点击左侧菜单「API Key 管理」
3. 点击「创建 API Key」
4. 复制生成的 sk- 开头的密钥

⚠️ 重要：API Key 只会显示一次，请务必妥善保存！

4.3 充值（如需）

Kimi API 采用按量计费模式：

• 新用户通常有免费额度
• 可在「账户管理」中查看余额和充值

---

五、启动 Claude Code

5.1 在项目目录中启动

# 进入你的项目文件夹
cd /path/to/your/project

# 启动 Claude Code
claude

5.2 验证连接

成功启动后，你会看到类似以下的提示：

╭──────────────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code!                                   │
│                                                              │
│ Model: kimi-k2.5                                            │
│ Current directory: /path/to/your/project                    │
╰──────────────────────────────────────────────────────────────╯

如果显示 kimi-k2.5 模型，说明配置成功！

---

六、常用命令与快捷键

6.1 基础命令

命令	说明
claude	在当前目录启动 Claude Code
claude --help	查看帮助信息
claude --version	查看版本号

6.2 交互快捷键

快捷键	功能
Ctrl+C	取消当前操作 / 退出
Ctrl+D	退出 Claude Code
Tab	自动补全
↑/↓	浏览历史输入

6.3 特殊指令

在 Claude Code 交互界面中，可以使用以下指令：

• /help - 显示帮助
• /clear - 清空对话历史
• /cost - 查看本次会话的 API 消耗

---

七、常见问题解答 (FAQ)

Q1: 提示 “Authentication failed”

原因：API Key 无效或过期

解决：

1. 检查 ~/.claude.json 中的 ANTHROPIC_AUTH_TOKEN 是否正确
2. 确认 API Key 没有过期
3. 尝试重新生成 API Key

Q2: 提示 “Model not found”

原因：模型名称配置错误

解决：确认 ANTHROPIC_MODEL 设置为 kimi-k2.5 或其他 Kimi 支持的模型

Q3: 响应速度很慢

原因：可能是网络问题或模型负载高

解决：

1. 检查网络连接
2. 尝试调整 API_TIMEOUT_MS 为更大的值
3. 避开使用高峰期

Q4: 如何查看 API 调用费用？

解决：登录 Kimi 开放平台，在「账户管理」中查看消费记录

Q5: Claude Code 更新后配置失效

原因：更新可能重置了配置

解决：重新编辑 ~/.claude.json 文件，确保配置正确

---

八、进阶配置

8.1 配置多个项目

Claude Code 支持在项目根目录创建 .claude.json 文件，实现项目级配置：

{
  "env": {
    "ANTHROPIC_MODEL": "kimi-k2.5"
  }
}

项目级配置会覆盖全局配置。

8.2 使用不同的 Kimi 模型

Kimi 提供多个模型版本，可根据需求选择：

模型	适用场景
kimi-k2.5	通用场景，平衡速度与质量
kimi-k1.5	需要推理能力的复杂任务
moonshot-v1-8k	短文本快速处理

8.3 代理配置（如需）

如果需要通过代理访问，可添加：

{
  "env": {
    "HTTP_PROXY": "http://127.0.0.1:7890",
    "HTTPS_PROXY": "http://127.0.0.1:7890"
  }
}

---

九、总结

通过以上步骤，你已经成功配置了 Claude Code 使用 Kimi API。现在你可以：

• 在熟悉的编辑器中使用 AI 辅助编程
• 利用 Kimi 的强大模型能力
• 享受更稳定的国内访问体验

如果在配置过程中遇到问题，欢迎留言交流！

---

参考链接

• Claude Code 官方文档
• Kimi 开放平台
• Claude Code GitHub

---

免责声明：本文仅供学习交流使用，请遵守各平台的使用条款和相关法律法规。