Claude CLI 详细安装教程 2025

完整的 Claude CLI 安装配置指南,支持 Windows、macOS、Linux 系统。 包含环境配置、API密钥设置、常见问题解答,让您快速上手 Claude 命令行工具。

🚀 快速开始

⚠️ 安装前准备

在安装 Claude CLI 之前,请确保您的系统已满足以下要求:

  • 已安装 Node.js (版本 16 或更高)
  • 拥有 Anthropic Claude API 密钥
  • 具备基本的命令行操作能力
✅ 一键安装命令

如果您已满足上述要求,可以直接使用以下命令安装:

npm install -g @anthropic-ai/claude-cli

📋 详细安装步骤

1

安装 Node.js

Windows 系统需要先安装 Node.js 运行环境:

# 访问 https://nodejs.org 下载最新 LTS 版本 # 或使用 Chocolatey 安装 choco install nodejs

安装完成后,打开命令提示符验证安装:

node --version npm --version
2

安装 Claude CLI

使用 npm 全局安装 Claude CLI:

npm install -g @anthropic-ai/claude-cli
权限问题

如果遇到权限错误,请以管理员身份运行命令提示符。

3

配置 API 密钥

设置您的 Anthropic API 密钥:

# 设置环境变量 set ANTHROPIC_API_KEY=your_api_key_here # 或使用 claude-cli 配置命令 claude configure
1

安装 Node.js

macOS 用户可以使用 Homebrew 安装 Node.js:

# 使用 Homebrew 安装 brew install node # 或从官网下载 https://nodejs.org

验证安装:

node --version npm --version
2

安装 Claude CLI

npm install -g @anthropic-ai/claude-cli

如果遇到权限问题,使用 sudo:

sudo npm install -g @anthropic-ai/claude-cli
3

配置 API 密钥

# 添加到 shell 配置文件 echo 'export ANTHROPIC_API_KEY=your_api_key_here' >> ~/.zshrc source ~/.zshrc # 或使用 claude-cli 配置 claude configure
1

安装 Node.js

使用包管理器安装 Node.js:

# Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # CentOS/RHEL curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash - sudo yum install -y nodejs
2

安装 Claude CLI

sudo npm install -g @anthropic-ai/claude-cli
3

配置 API 密钥

# 添加到 bash 配置 echo 'export ANTHROPIC_API_KEY=your_api_key_here' >> ~/.bashrc source ~/.bashrc # 或使用 claude-cli 配置 claude configure

✅ 验证安装

测试 Claude CLI

运行以下命令验证安装是否成功:

# 查看版本信息 claude --version # 测试对话 claude "你好,请介绍一下你自己"
成功标志

如果您看到 Claude 的回复,说明安装配置成功!

❓ 常见问题解答

如何获取 Anthropic API 密钥? +

1. 访问 Anthropic Console

2. 注册或登录您的账户

3. 在 API Keys 页面创建新的密钥

4. 复制密钥并妥善保存

安装时出现权限错误怎么办? +

Windows:以管理员身份运行命令提示符

macOS/Linux:使用 sudo 命令或配置 npm 全局目录

# 配置 npm 全局目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
Claude CLI 有哪些常用命令? +
# 基本对话 claude "你的问题" # 从文件读取输入 claude -f input.txt # 保存输出到文件 claude "你的问题" -o output.txt # 使用特定模型 claude --model claude-3-opus "你的问题"
如何更新 Claude CLI? +
# 检查更新 npm outdated -g @anthropic-ai/claude-cli # 执行更新 npm update -g @anthropic-ai/claude-cli