Claude Code 安装与配置完全指南
Claude Code 安装与配置完全指南
本指南详细介绍 Claude Code 的安装过程、模型配置和启动方式，帮助你快速上手这个强大的 AI 开发工具。
一、前置准备
必需工具
在安装 Claude Code 之前，需要确保系统中安装了以下工具：
| 工具 | 用途 | 安装地址 |
|------|------|----------|
| Node.js | 运行环境 | https://nodejs.org |
| Git | 版本控制 | https://git-scm.com |
| API Key | 模型服务 | 智谱 GLM / 月之暗面 K2 / 阿里 Qwen 等 |
验证安装
# 检查 Node.js 版本
node -v
# 检查 Git 版本
git --version
要求版本：
- Node.js：14.0.0 或更高版本
- Git：任意版本均可
二、安装 Claude Code
全局安装（推荐）
使用 npm 进行全局安装：
npm install -g @anthropic-ai/claude-code
验证安装
# 检查 Claude Code 版本
claude --version
# 查看帮助信息
claude --help
其他安装方式
使用 npx 直接运行
# 不安装，直接使用 npx 运行
npx @anthropic-ai/claude-code
使用 Homebrew（macOS）
# 如果使用 Homebrew 包管理器
brew install claude-code
三、配置模型
Claude Code 支持多种模型配置方式，你可以根据自己的需求选择合适的模型。
方式一：手动配置（通用方式）
手动配置适用于所有兼容 Anthropic API 的模型。
Windows 系统
setx ANTHROPIC_BASE_URL "模型API地址"
setx ANTHROPIC_AUTH_TOKEN "你的API密钥"
setx ANTHROPIC_MODEL "模型名称"
macOS/Linux 系统
# 临时配置（当前终端会话有效）
export ANTHROPIC_BASE_URL=模型API地址
export ANTHROPIC_AUTH_TOKEN=你的API密钥
export ANTHROPIC_MODEL=模型名称
# 永久配置（添加到 ~/.bashrc 或 ~/.zshrc）
echo 'export ANTHROPIC_BASE_URL=模型API地址' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=你的API密钥' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL=模型名称' >> ~/.bashrc
source ~/.bashrc
国内模型配置示例
以下是国内常用模型的配置信息：
| 模型 | API 地址 | 模型名称 | 获取 API Key |
|------|----------|----------|--------------|
| 智谱 GLM-4.7 | https://open.bigmodel.cn/api/anthropic | glm-4.7 | https://open.bigmodel.cn/ |
| Kimi K2 | https://api.moonshot.cn/anthropic | kimi-k2-turbo-preview | https://platform.moonshot.cn/console/account |
| 通义千问 | https://dashscope.aliyuncs.com/apps/anthropic | qwen-coder-plus | https://bailian.console.aliyun.com/ |
| DeepSeek | https://api.deepseek.com/anthropic | deepseek-chat | https://platform.deepseek.com/ |
智谱 GLM 配置示例
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=your_glm_api_key
export ANTHROPIC_MODEL=GLM-4.7
注意： 配置环境变量后需要重启终端或运行 source ~/.bashrc 使配置生效。
方式二：使用自动化助手（仅适用于智谱 GLM）
如果选择使用智谱 GLM 系列模型，还可以使用自动化配置助手：
npx @z_ai/coding-helper
按照交互式提示完成配置：
- 选择界面语言
- 设置 Coding 套餐
- 配置 API 密钥
- 选择编码工具
国内模型对比
| 模型 | 提供商 | 代码能力 | 价格 | 优势 | 适用场景 |
|------|--------|----------|------|------|----------|
| glm-4.7 | 智谱 AI | ⭐⭐⭐⭐⭐ | 中等 | 中文理解强，有 Coding 套餐 | 中文项目为主 |
| kimi-k2-turbo-preview | 月之暗面 | ⭐⭐⭐⭐⭐ | 较低 | 超长上下文，MoE 架构 | 大型项目重构 |
| qwen-coder-plus | 阿里云 | ⭐⭐⭐⭐⭐ | 低 | 开源，性能优秀 | Python/JS 项目 |
| deepseek-chat | 深度求索 | ⭐⭐⭐⭐ | 极低 | 价格优势 | 预算有限的场景 |
四、启动 Claude Code
基本启动
# 启动交互式会话
claude
危险模式（跳过权限确认）
# 跳过权限确认，直接执行操作
claude --dangerously-skip-permissions
使用场景： 自动化脚本中，需要无交互执行时使用。
Headless 模式（非交互式）
# 从管道输入
git diff | claude -p "解释这些更改"
# 从文件输入
cat file.txt | claude -p "总结这个文件"
# 直接指定提示词
claude -p "检查代码质量" < src/main.js
其他启动选项
# 查看所有选项
claude --help
# 指定配置文件
claude --config /path/to/config.json
# 继续之前的会话
claude --continue
# 显示历史会话列表
claude --resume
# 传送云端会话到本地
claude --teleport session_id
五、配置验证
验证模型配置
# 在 Claude Code 中检查配置
/model
# 查看当前使用的模型
/cost
常见配置问题
问题 1：API Key 无效
错误信息：
Error: Invalid API key
解决方案：
- 检查 API Key 是否正确
- 确认 API Key 是否具有访问权限
- 验证 API 地址是否正确
问题 2：模型不支持
错误信息：
Error: Model not found
解决方案：
- 确认模型名称拼写正确
- 检查模型是否在 API 服务中可用
- 尝试使用其他模型名称
问题 3：网络连接失败
错误信息：
Error: Connection failed
解决方案：
- 检查网络连接
- 确认 API 地址可访问
- 检查防火墙设置
六、配置最佳实践
环境变量管理
建议使用 .env 文件管理配置：
# 创建 .env 文件
touch ~/.claude/.env
# 添加配置
echo 'ANTHROPIC_BASE_URL=https://api.example.com' >> ~/.claude/.env
echo 'ANTHROPIC_AUTH_TOKEN=your_api_key' >> ~/.claude/.env
echo 'ANTHROPIC_MODEL=your_model' >> ~/.claude/.env
# 在终端中加载
source ~/.claude/.env
多模型配置
如果需要使用多个模型，可以创建配置文件：
// ~/.claude/models.json
{
"default": "glm-4.7",
"models": {
"glm-4.7": {
"base_url": "https://open.bigmodel.cn/api/anthropic",
"auth_token": "your_glm_api_key"
},
"kimi-k2": {
"base_url": "https://api.moonshot.cn/anthropic",
"auth_token": "your_kimi_api_key"
}
}
}
七、总结
通过本指南，你已经完成了 Claude Code 的安装和配置。现在你可以：
- ✅ 安装 Claude Code 到系统中
- ✅ 配置适合自己的模型
- ✅ 启动和使用 Claude Code