Skip to content

Claude Code 安装教程

Claude Code 是 Anthropic 官方推出的命令行工具,让你可以在终端中直接与 Claude 进行交互,完成代码编写、调试、重构等任务。

系统要求

  • 操作系统: macOS 10.15+、Windows 10/11、Linux (Ubuntu 20.04+/Debian 10+)
  • Node.js: 18.0 或更高版本
  • 内存: 建议 4GB 以上

一键安装(推荐)

复制以下命令到终端运行,即可自动完成安装和配置:

bash
curl -fsSL https://claude-zh.cn/scripts/install.sh | bash
powershell
irm https://claude-zh.cn/scripts/install.ps1 | iex

脚本功能

一键安装脚本会自动:

  1. 检测并安装 Node.js(如未安装)
  2. 安装 Claude Code
  3. 引导配置 API 密钥

手动安装

1. 安装 Node.js

如果你还没有安装 Node.js,可以从 Node.js 官网 下载安装,或使用包管理器:

bash
brew install node
bash
# 方法一:从官网下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本安装包

# 方法二:使用 winget(Windows 包管理器)
winget install OpenJS.NodeJS.LTS
bash
# 适用于 Ubuntu/Debian 以及 Windows 的 WSL 环境
# WSL 是 Windows 上的 Linux 子系统,安装方式与 Linux 相同
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 Claude Code

使用 npm 全局安装 Claude Code:

bash
npm install -g @anthropic-ai/claude-code

3. 配置 API

Claude Code 需要配置 API 密钥才能使用。我们推荐使用 LuckyAPI 获取 API 密钥,价格更优惠且稳定可靠。

在终端中设置环境变量:

bash
export ANTHROPIC_BASE_URL="https://cn.luckyapi.chat"
export ANTHROPIC_API_KEY="你的API密钥"
powershell
$env:ANTHROPIC_BASE_URL="https://cn.luckyapi.chat"
$env:ANTHROPIC_API_KEY="你的API密钥"
cmd
set ANTHROPIC_BASE_URL=https://cn.luckyapi.chat
set ANTHROPIC_API_KEY=你的API密钥

永久配置(推荐)

bash
# 添加到 ~/.bashrc 或 ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://cn.luckyapi.chat"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc
powershell
# 设置用户级环境变量(永久生效)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cn.luckyapi.chat", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API密钥", "User")
# 重启终端后生效

4. 启动 Claude Code

在任意项目目录下运行:

bash
claude

首次运行会进入交互式配置,按提示完成即可。

常用命令

命令说明
claude启动交互式会话
claude "你的问题"直接提问
claude --help查看帮助信息

获取 API 密钥

访问 LuckyAPI 注册账号并获取 API 密钥,即可开始使用 Claude Code。

提示

LuckyAPI 提供稳定的 Claude API 服务,无需担心封号和付款问题。

Windows 用户须知

关于 Windows 原生支持

Claude Code 完全支持 Windows 原生环境,无需安装 WSL。只需确保:

  1. 使用 PowerShell 或 Windows Terminal(推荐)
  2. Node.js 已正确安装并添加到 PATH
  3. 如遇到脚本执行限制,在 PowerShell 中运行:
    powershell
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

什么是 WSL?

WSL(Windows Subsystem for Linux)是 Windows 上的 Linux 子系统,可以让你在 Windows 中运行 Linux 环境。如果你更熟悉 Linux 命令行,也可以选择使用 WSL 来运行 Claude Code。

常见问题

Q: 提示 "API key not found"?

确保已正确设置 ANTHROPIC_API_KEY 环境变量,并且密钥有效。

Q: 连接超时?

检查网络连接,确保 ANTHROPIC_BASE_URL 设置正确。


如有其他问题,欢迎访问 LuckyAPI 获取支持。

API 服务由 LuckyAPI 提供