文章目录
- 首先访问 Claude Code 官方文档了解基本信息: 官网链接:https://code.claude.com/docs/zh-CN/overview
- 根据你的操作系统,选择对应的安装命令: macOS / Linux / WSL curl -fsSL https://claude.ai/install.sh | bash Windows PowerShell irm https://claude.ai/install.ps1 | iex ⚠️ 注意:如果下载失败,请检查网络连接,或者尝试使用其他网络工具。 1.3 验证安装 安装完成后,在终端输入以下命令验证: claude –version
- Claude Code 的配置文件位于用户主目录下: macOS/Linux: ~/.claude.json Windows: %USERPROFILE%.claude.json
- 使用你喜欢的编辑器打开配置文件: # macOS/Linux nano ~/.claude.json # 或使用 VS Code code ~/.claude.json
- 在配置文件中添加以下 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” } }
- 配置项 说明 建议值 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分钟)
- # 进入你的项目文件夹 cd /path/to/your/project # 启动 Claude Code claude
- 成功启动后,你会看到类似以下的提示: ╭──────────────────────────────────────────────────────────────╮ │ ✻ Welcome to Claude Code! │ │ │ │ Model: kimi-k2.5 │ │ Current directory: /path/to/your/project │ ╰──────────────────────────────────────────────────────────────╯ 如果显示 kimi-k2.5 模型,说明配置成功!
- 原因:API Key 无效或过期 解决: 检查 ~/.claude.json 中的 ANTHROPIC_AUTH_TOKEN 是否正确 确认 API Key 没有过期 尝试重新生成 API Key
- 原因:模型名称配置错误 解决:确认 ANTHROPIC_MODEL 设置为 kimi-k2.5 或其他 Kimi 支持的模型
- 原因:可能是网络问题或模型负载高 解决: 检查网络连接 尝试调整 API_TIMEOUT_MS 为更大的值 避开使用高峰期
- 解决:登录 Kimi 开放平台,在「账户管理」中查看消费记录
- 原因:更新可能重置了配置 解决:重新编辑 ~/.claude.json 文件,确保配置正确
- Claude Code 支持在项目根目录创建 .claude.json 文件,实现项目级配置: { “env”: { “ANTHROPIC_MODEL”: “kimi-k2.5” } } 项目级配置会覆盖全局配置。
- Kimi 提供多个模型版本,可根据需求选择: 模型 适用场景 kimi-k2.5 通用场景,平衡速度与质量 kimi-k1.5 需要推理能力的复杂任务 moonshot-v1-8k 短文本快速处理
- 如果需要通过代理访问,可添加: { “env”: { “HTTP_PROXY”: “http://127.0.0.1:7890”, “HTTPS_PROXY”: “http://127.0.0.1:7890” } }
目录
- 前言
- 一、安装 Claude Code
- 1.1 官方文档
- 1.2 一键安装
- 二、初始配置
- 2.1 首次启动
- 2.2 退出初始配置
- 三、配置 Kimi API
- 3.1 找到配置文件
- 3.2 编辑配置文件
- 3.3 添加 Kimi API 配置
- 3.4 配置项说明
- 四、获取 Kimi API Key
- 4.1 注册 Kimi 开放平台账号
- 4.2 创建 API Key
- 4.3 充值(如需)
- 五、启动 Claude Code
- 5.1 在项目目录中启动
- 5.2 验证连接
- 六、常用命令与快捷键
- 6.1 基础命令
- 6.2 交互快捷键
- 6.3 特殊指令
- 七、常见问题解答 (FAQ)
- Q1: 提示 “Authentication failed”
- Q2: 提示 “Model not found”
- Q3: 响应速度很慢
- Q4: 如何查看 API 调用费用?
- Q5: Claude Code 更新后配置失效
- 八、进阶配置
- 8.1 配置多个项目
- 8.2 使用不同的 Kimi 模型
- 8.3 代理配置(如需)
- 九、总结
- 参考链接
Claude Code 是 Anthropic 推出的智能编程助手,但很多国内用户由于网络或 API 限制无法直接使用 Claude 的官方服务。好消息是,我们可以通过配置 Kimi API 来在 Claude Code 中使用 Kimi 的强大模型。本文将详细介绍整个配置过程。
首先访问 Claude Code 官方文档了解基本信息:
- 官网链接:https://code.claude.com/docs/zh-CN/overview
根据你的操作系统,选择对应的安装命令:
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
⚠️ 注意:如果下载失败,请检查网络连接,或者尝试使用其他网络工具。
1.3 验证安装
安装完成后,在终端输入以下命令验证:
claude --version
在目标项目文件夹内执行:
claude
首次启动会引导你进行配置:
- 颜色外观配置 – 选择你喜欢的主题风格
- API 配置 – Claude 官方提供的三种方式都不支持 Kimi,所以我们需要跳过此步骤
由于官方配置不支持 Kimi API,直接按 两次 Ctrl+C 退出 Claude Code,然后手动修改配置文件。
Claude Code 的配置文件位于用户主目录下:
- macOS/Linux: ~/.claude.json
- Windows: %USERPROFILE%.claude.json
使用你喜欢的编辑器打开配置文件:
# macOS/Linux nano ~/.claude.json # 或使用 VS Code code ~/.claude.json
在配置文件中添加以下 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"
}
}
| 配置项 | 说明 | 建议值 |
|---|---|---|
| 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 管理」
- 点击「创建 API Key」
- 复制生成的 sk- 开头的密钥
⚠️ 重要:API Key 只会显示一次,请务必妥善保存!
⚠️ 重要:API Key 只会显示一次,请务必妥善保存!
Kimi API 采用按量计费模式:
- 新用户通常有免费额度
- 可在「账户管理」中查看余额和充值
# 进入你的项目文件夹
cd /path/to/your/project
# 启动 Claude Code
claude
成功启动后,你会看到类似以下的提示:
╭──────────────────────────────────────────────────────────────╮ │ ✻ Welcome to Claude Code! │ │ │ │ Model: kimi-k2.5 │ │ Current directory: /path/to/your/project │ ╰──────────────────────────────────────────────────────────────╯
如果显示 kimi-k2.5 模型,说明配置成功!
| 命令 | 说明 |
|---|---|
| claude | 在当前目录启动 Claude Code |
| claude –help | 查看帮助信息 |
| claude –version | 查看版本号 |
| 快捷键 | 功能 |
|---|---|
| Ctrl+C | 取消当前操作 / 退出 |
| Ctrl+D | 退出 Claude Code |
| Tab | 自动补全 |
| ↑/↓ | 浏览历史输入 |
在 Claude Code 交互界面中,可以使用以下指令:
- /help – 显示帮助
- /clear – 清空对话历史
- /cost – 查看本次会话的 API 消耗
原因:API Key 无效或过期
解决:
- 检查 ~/.claude.json 中的 ANTHROPIC_AUTH_TOKEN 是否正确
- 确认 API Key 没有过期
- 尝试重新生成 API Key
原因:模型名称配置错误
解决:确认 ANTHROPIC_MODEL 设置为 kimi-k2.5 或其他 Kimi 支持的模型
原因:可能是网络问题或模型负载高
解决:
- 检查网络连接
- 尝试调整 API_TIMEOUT_MS 为更大的值
- 避开使用高峰期
解决:登录 Kimi 开放平台,在「账户管理」中查看消费记录
原因:更新可能重置了配置
解决:重新编辑 ~/.claude.json 文件,确保配置正确
Claude Code 支持在项目根目录创建 .claude.json 文件,实现项目级配置:
{
"env": {
"ANTHROPIC_MODEL": "kimi-k2.5"
}
}
项目级配置会覆盖全局配置。
Kimi 提供多个模型版本,可根据需求选择:
| 模型 | 适用场景 |
|---|---|
| kimi-k2.5 | 通用场景,平衡速度与质量 |
| kimi-k1.5 | 需要推理能力的复杂任务 |
| moonshot-v1-8k | 短文本快速处理 |
如果需要通过代理访问,可添加:
{
"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
到此这篇关于Claude Code使用Kimi Code API 教程的文章就介绍到这了,更多相关Claude Code使用Kimi API内容请搜索风君子博客以前的文章或继续浏览下面的相关文章,希望大家以后多多支持风君子博客!