简介
Claude Code 是 Anthropic 推出的命令行 AI 编程助手，它可以直接在终端中与 Claude AI 进行交互，帮助开发者编写代码、调试程序、分析项目等。本手册将详细介绍如何在 Windows 和 macOS 系统上安装和配置 Claude Code，并支持多种 AI 模型（包括 Kimi 2.5、GLM 等）。
Claude Code 不仅支持官方的 Claude 模型，还可以通过配置 API 密钥使用其他第三方大语言模型，如 Moonshot 的 Kimi、智谱 AI 的 GLM 等。
系统要求
硬件要求
- 内存：至少 4GB RAM（推荐 8GB 以上）
- 存储：至少 500MB 可用磁盘空间
- 网络：稳定的互联网连接
软件要求
- Node.js 18.0 或更高版本
- npm 9.0 或更高版本
- Git（可选，但推荐安装）
前置准备：安装 Node.js
Claude Code 基于 Node.js 运行，因此需要先安装 Node.js 环境。
访问 Node.js 官网：https://nodejs.org/
下载 LTS（长期支持）版本的 Windows 安装包（.msi 文件）
双击下载的安装包，按照向导完成安装
安装完成后，打开命令提示符（CMD）或 PowerShell，输入以下命令验证安装：
node --version
npm --version
方法一：使用官方安装包
访问 Node.js 官网下载 macOS 安装包
双击 .pkg 文件并按照向导安装
方法二：使用 Homebrew（推荐）
打开终端（Terminal）
执行以下命令安装 Node.js：
brew install node
安装 Claude Code
通过 npm 安装（推荐）
Claude Code 可以通过 npm 全局安装，适用于 Windows 和 macOS 系统。
打开终端（Windows 使用 CMD/PowerShell，macOS 使用 Terminal）
执行以下命令安装 Claude Code：
npm install -g @anthropic-ai/claude-code
等待安装完成，验证安装是否成功：
claude --version
通过官方安装脚本安装
如果遇到 npm 安装问题，可以使用官方提供的安装脚本。
powershell -c "irm https://anthropic.com/claude-code/install.ps1 | iex"
curl -fsSL https://anthropic.com/claude-code/install.sh | bash
配置 AI 模型
Claude Code 支持多种 AI 模型，包括官方的 Claude 模型以及第三方模型如 Kimi 2.5、GLM 等。
配置 Anthropic Claude 模型
获取 API Key：访问 Anthropic Console
注册或登录 Anthropic 账户
在控制台中创建新的 API Key
设置环境变量：
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key", "User")
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc
配置 Kimi 2.5 模型
访问 Moonshot AI 官网：https://platform.moonshot.cn/
注册账户并创建 API Key
设置环境变量：
# Windows
[Environment]::SetEnvironmentVariable("MOONSHOT_API_KEY", "your-api-key", "User")
# macOS/Linux
echo 'export MOONSHOT_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc
配置 GLM 模型
访问智谱 AI 开放平台：https://open.bigmodel.cn/
注册账户并获取 API Key
设置环境变量：
# Windows
[Environment]::SetEnvironmentVariable("ZHIPU_API_KEY", "your-api-key", "User")
# macOS/Linux
echo 'export ZHIPU_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc
使用 Claude Code
启动 Claude Code
在项目目录中启动 Claude Code：
claude
或者直接启动并指定目录：
claude /path/to/your/project
常用命令
| 命令 | 说明 |
|---|---|
claude |
在当前目录启动 Claude Code |
claude /path |
在指定路径启动 |
/help |
显示帮助信息 |
/model |
切换 AI 模型 |
/cost |
查看本次会话的 API 费用 |
/clear |
清除对话历史 |
/exit |
退出 Claude Code |
切换 AI 模型
在 Claude Code 中，可以通过以下方式切换使用的 AI 模型：
- 启动 Claude Code
- 输入
/model命令查看可用模型 - 选择要使用的模型（如 Claude、Kimi、GLM 等）
常见问题与解决方案
安装问题
| 问题 | 解决方案 |
|---|---|
| npm 命令未找到 | 检查 Node.js 是否正确安装，环境变量是否配置 |
| 权限不足 (EACCES) | Windows: 以管理员身份运行终端；macOS: 使用 sudo 命令 |
| 安装卡住 | 检查网络连接，尝试更换 npm 镜像源 |
| 版本不兼容 | 升级 Node.js 到 18.0 或更高版本 |
网络问题
解决方案：
- 检查网络连接是否正常
- 确认 API Key 是否正确设置
- 检查是否需要配置代理（在中国大陆可能需要）
- 查看 API 服务状态页面确认服务是否正常
卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g @anthropic-ai/claude-code
参考资源
- Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code/overview
- Anthropic API 文档：https://docs.anthropic.com/
- Moonshot AI (Kimi)：https://platform.moonshot.cn/
- 智谱 AI (GLM)：https://open.bigmodel.cn/
- Node.js 官网：https://nodejs.org/