零基础保姆级教程:Claude Code + Kimi Code 安装配置与使用指南
你不需要会编程,也不需要懂技术。跟着这篇教程一步步来,10 分钟就能拥有一个会帮你写代码的 AI 助手。
一、先搞清楚:这俩东西是什么?
在开始动手之前,我们先用最简单的话解释一下。
Claude Code 是什么?
Claude Code 是 Anthropic 公司出品的一款命令行 AI 编程工具。你可以把它理解为——一个住在你电脑「黑框框」里的超级程序员。你只需要用中文告诉它你想做什么,它就会自动帮你写代码、改代码、运行代码。Kimi Code 是什么?
Kimi Code 是月之暗面(Moonshot AI)推出的 AI 编程服务。它提供了强大的 AI 大模型 Kimi K2.5,专门为写代码这件事做了深度优化。为什么要把它们组合在一起?
这是一个「强强联合」的黄金搭档:
| Claude Code | Kimi Code Plan | |
|---|---|---|
| 角色 | 操作界面(工具) | AI 大脑(模型) |
| 比喻 | 像一辆好车 | 像一台强劲的发动机 |
| 作用 | 负责与你对话、执行操作 | 负责理解需求、生成代码 |
而且,Kimi Code Plan 的价格比直接使用 Claude 官方 API 便宜不少,对新手非常友好。
二、准备工作清单
开始之前,请确认你有以下东西:
💡 不需要提前安装任何编程软件,本教程会从头教起。
三、第一步:订阅 Kimi Code Plan
在安装工具之前,我们先搞定「引擎」—— 开通 Kimi Code 服务并获取 API Key。
3.1 注册 / 登录 Kimi
3.2 选择并订阅 Kimi 会员套餐
💡 新手建议: Kimi Code 权益包含在 Kimi 会员套餐中。订阅后每周会自动刷新额度,每 5 小时可支持 300-1200 次请求,日常学习完全够用。
3.3 获取你的 API Key(重要!)
这一步就像拿到你的「钥匙」,后面要用它来启动引擎。
⚠️ 重要提醒: API Key 只会显示一次!请务必复制并保存好。建议保存到备忘录或记事本中。它的格式类似:sk-kimi-xxxxxxxxxxxxxxxxxxxx
四、第二步:安装 Claude Code
现在来安装「方向盘」。下面分 Mac 和 Windows 两种系统分别说明。
🍎 Mac 用户安装指南
#### 方法一:一键安装(推荐,最简单)
Command + 空格,输入 「终端」,回车打开curl -fsSL https://claude.ai/install.sh | bash
claude --version
如果显示了版本号(如 1.x.x),恭喜你,安装成功!
#### 方法二:用 Homebrew 安装
如果你已经安装过 Homebrew(Mac 上的软件管理工具),可以用这个方法:
brew install --cask claude-code
#### 方法三:用 npm 安装
需要先安装 Node.js,步骤如下:
# 第 1 步:安装 Node.js 版本管理器
curl -fsSL https://fnm.vercel.app/install | bash
# ⚠️ 第 2 步:关闭终端,重新打开一个新终端窗口
# 第 3 步:安装 Node.js
fnm install 24.3.0
fnm default 24.3.0
fnm use 24.3.0
# 第 4 步:安装 Claude Code(使用国内镜像加速)
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
🪟 Windows 用户安装指南
#### 第 1 步:打开 PowerShell
💡 如果你看到的是「命令提示符」而不是「PowerShell」,请在开始菜单中搜索「PowerShell」
#### 第 2 步:安装 Git 和 Node.js
在 PowerShell 中,逐行粘贴并执行以下命令:
# 安装 Git(代码版本管理工具)
winget install --id Git.Git -e --source winget
# 安装 Node.js(JavaScript 运行环境)
winget install OpenJS.NodeJS
# 设置脚本执行权限(允许运行安装脚本)
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
⚠️ 安装完成后,关闭当前终端窗口,重新打开一个新的 PowerShell 窗口,这样新安装的工具才能生效。
#### 第 3 步:安装 Claude Code
在新打开的 PowerShell 中执行:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
等待安装完成,如果看到一堆文字滚动后停下来了,说明安装成功。
#### 第 4 步:验证安装
claude --version
看到版本号(如 1.x.x)就说明安装成功了!
五、第三步:配置 Kimi Code API(连接引擎)
这是最关键的一步——把 Kimi 的 AI 大脑连接到 Claude Code 上。
原理很简单:通过设置两个「环境变量」,告诉 Claude Code「去找 Kimi 的服务器要答案」。
🍎 Mac 用户配置
#### 临时配置(每次重启终端需重新设置)
在终端中执行以下两行命令(注意替换你自己的 API Key):
export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
export ANTHROPIC_API_KEY=sk-kimi-你的密钥粘贴在这里
#### 永久配置(推荐!设置一次,永久生效)
在终端中执行以下三行命令:
echo 'export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-kimi-你的密钥粘贴在这里' >> ~/.zshrc
source ~/.zshrc
💡 解释: ~/.zshrc 是 Mac 终端的配置文件,写进去的内容每次打开终端都会自动加载。
🪟 Windows 用户配置
#### 临时配置(每次重启终端需重新设置)
在 PowerShell 中执行:
$env:ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
$env:ANTHROPIC_API_KEY="sk-kimi-你的密钥粘贴在这里"
#### 永久配置(推荐!设置一次,永久生效)
方法一:通过图形界面设置Win + I 打开 Windows 设置| 变量名 | 变量值 |
|---|---|
ANTHROPIC_BASE_URL | https://api.kimi.com/coding/ |
ANTHROPIC_API_KEY | sk-kimi-你的密钥 |
在 PowerShell 中执行:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.kimi.com/coding/", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-kimi-你的密钥粘贴在这里", "User")
设置后重新打开 PowerShell 即可永久生效。
六、第四步:启动并验证
6.1 启动 Claude Code
在终端(Mac)或 PowerShell(Windows)中输入:
claude
你会看到 Claude Code 的欢迎界面,出现一个输入光标等待你的指令。
6.2 确认 Kimi 模型已连接
输入以下命令检查状态:
/status
如果看到模型相关信息(例如显示 base URL 为 kimi 的地址),说明连接成功!
💡 小技巧: 在 Claude Code 中按 Tab 键可以切换模型,例如切换到 Kimi K2.5 Thinking 获得更强的推理能力。
6.3 试一下!你的第一个指令
让我们来测试一下,输入你的第一个请求:
帮我用 HTML 写一个好看的个人主页,要有我的名字、一段自我介绍、好看的渐变背景色
Claude Code 会自动帮你:
index.html 文件几秒钟后,一个完整的网页就生成好了!你可以在浏览器中打开这个 HTML 文件查看效果。
七、日常使用小贴士
🎯 常用命令速查表
| 命令 | 作用 | 说明 |
|---|---|---|
claude | 启动 Claude Code | 在项目文件夹中执行 |
/status | 查看连接状态 | 确认模型和 API 是否正常 |
/help | 查看帮助信息 | 列出所有可用命令 |
/clear | 清空当前对话 | 开始全新的对话 |
Tab 键 | 切换模型 | 在不同模型间切换 |
/quit | 退出 | 结束 Claude Code 会话 |
💬 如何跟它对话?
你完全可以用中文跟它交流,就像跟朋友聊天一样。例如:
📂 三个超实用技巧
技巧一:先进入项目文件夹再启动在终端中先 cd 到你的项目目录,再输入 claude,这样它就能看到并操作项目里的所有文件。
# Mac 示例
cd ~/Desktop/my-project
claude
# Windows 示例
cd C:\Users\你的用户名\Desktop\my-project
claude
技巧二:需求描述越具体越好
不要说「做个网站」,而要说:
「帮我做一个卖咖啡的网站,要有首页、产品列表、联系我们三个页面,用深棕色和奶白色配色,风格要文艺简约」
AI 编程最大的秘诀就是:描述越详细,结果越惊艳。
技巧三:逐步迭代,不要一步到位- 先让它做一个基础版本,然后不断提出修改意见:
- 先说「帮我做一个计算器网页」
- 看到结果后说「按钮再大一点,加上圆角」
- 再说「加一个计算历史记录功能」
就像和一个耐心的同事合作,一步步打磨到满意为止。
八、常见问题 FAQ
❓ Q1:安装时报错「command not found」?
原因: 终端还没加载新安装的工具。 解决: 关闭当前终端窗口,重新打开一个新的,再试一次。这是最常见的问题,90% 的「找不到命令」都能通过重启终端解决。❓ Q2:提示「API Key 无效」或连接失败?
逐一检查:sk-kimi- 开头,复制时不要漏掉任何字符echo $ANTHROPIC_API_KEY 看看是否输出了你的 Key
- Windows:执行 echo $env:ANTHROPIC_API_KEY
❓ Q3:Mac 用户执行命令提示「Permission denied」权限不足?
在命令前面加上 sudo(超级管理员权限),然后输入电脑开机密码:
sudo npm install -g @anthropic-ai/claude-code
💡 输入密码时屏幕上不会显示任何字符(包括星号),这是正常的,直接输完按回车就行。
❓ Q4:Windows 提示「无法加载文件」或「无法运行脚本」?
执行以下命令开启脚本权限:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
输入 Y 确认,然后重新尝试。
❓ Q5:额度用完了怎么办?
- Kimi Code Plan 的额度每周自动刷新(从你订阅日算起,每 7 天刷新一次)。如果当周额度用完了:
- 可以等待下周自动刷新
- 也可以在 Kimi 官网升级到更高档位的会员套餐
❓ Q6:Claude Code 可以用来做什么?
几乎所有你能想到的编程任务它都能帮忙:
九、总结
恭喜你!你已经拥有了一个强大的 AI 编程助手。让我们回顾完成的四个步骤:
第一步 → 订阅 Kimi Code Plan,获取 API Key>
第二步 → 安装 Claude Code(Mac 或 Windows)>
第三步 → 配置环境变量,连接 Kimi 模型>
第四步 → 启动验证,发出第一个指令
从现在开始,不管你想做网站、做游戏、做小工具,只需要打开终端,输入 claude,然后用中文告诉它你的想法就好了。
本教程由 斜杠无界 出品 | 更多 AI 实战课程欢迎关注我们