本指南详细介绍 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

按照交互式提示完成配置：

1. 选择界面语言
2. 设置 Coding 套餐
3. 配置 API 密钥
4. 选择编码工具

国内模型对比

| 模型 | 提供商 | 代码能力 | 价格 | 优势 | 适用场景 |
|------|--------|----------|------|------|----------|
| 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

解决方案：

1. 检查 API Key 是否正确
2. 确认 API Key 是否具有访问权限
3. 验证 API 地址是否正确

问题 2：模型不支持

错误信息：

Error: Model not found

解决方案：

1. 确认模型名称拼写正确
2. 检查模型是否在 API 服务中可用
3. 尝试使用其他模型名称

问题 3：网络连接失败

错误信息：

Error: Connection failed

解决方案：

1. 检查网络连接
2. 确认 API 地址可访问
3. 检查防火墙设置

六、配置最佳实践

环境变量管理

建议使用 .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 的安装和配置。现在你可以：

1. ✅ 安装 Claude Code 到系统中
2. ✅ 配置适合自己的模型
3. ✅ 启动和使用 Claude Code