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
首次启动会引导你进行配置：
颜色外观配置
- 选择你喜欢的主题风格
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_URLKimi API 的基础地址https://api.kimi.com/coding/ANTHROPIC_AUTH_TOKEN你的 Kimi API Key从 Kimi 开放平台获取ANTHROPIC_MODEL主要使用的模型kimi-k2.5ANTHROPIC_SMALL_FAST_MODEL快速响应模型kimi-k2.5CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC禁用非必要流量1API_TIMEOUT_MSAPI 超时时间（毫秒）600000(10分钟)
四、获取 Kimi API Key 4.1 注册 Kimi 开放平台账号 访问 Kimi 开放平台 使用手机号或邮箱注册账号 完成实名认证（如需） 4.2 创建 API Key 登录后进入控制台 点击左侧菜单「API Key 管理」 点击「创建 API Key」 复制生成的
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 Codeclaude --help查看帮助信息claude --version查看版本号
6.2 交互快捷键 快捷键功能
Ctrl+C取消当前操作 / 退出Ctrl+D退出 Claude CodeTab自动补全↑/↓浏览历史输入
6.3 特殊指令 在 Claude Code 交互界面中，可以使用以下指令：
/help
- 显示帮助
/clear
- 清空对话历史
/cost
- 查看本次会话的 API 消耗 七、常见问题解答 (FAQ) Q1: 提示 “Authentication failed” 原因 ：API Key 无效或过期 解决 ： 检查
~/.claude.json
中的
ANTHROPIC_AUTH_TOKEN
是否正确 确认 API Key 没有过期 尝试重新生成 API Key Q2: 提示 “Model not found” 原因 ：模型名称配置错误 解决 ：确认
ANTHROPIC_MODEL
设置为
kimi-k2.5
或其他 Kimi 支持的模型 Q3: 响应速度很慢 原因 ：可能是网络问题或模型负载高 解决 ： 检查网络连接 尝试调整
API_TIMEOUT_MS
为更大的值 避开使用高峰期 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 免责声明 ：本文仅供学习交流使用，请遵守各平台的使用条款和相关法律法规。