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 | source
powershell
& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))

脚本功能

一键安装脚本会自动:

  1. 检测并安装 Node.js(如未安装)
  2. 安装 Claude Code
  3. 引导配置 API 密钥
  4. 配置 claude 别名,默认启用 --dangerously-skip-permissions 免确认模式

手动安装

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

bash
# 设置国内镜像源(推荐,加速下载)
npm config set registry https://registry.npmmirror.com

# 安装最新版本
npm install -g @anthropic-ai/claude-code

3. 配置 API

Claude Code 需要配置 API 密钥才能使用。访问 LuckyAPI 注册并创建令牌,仅需官方价格的 6%,稳定可靠。

永久配置(推荐):将以下内容添加到 ~/.bashrc~/.zshrc

bash
# 1. 设置中转站的 API 地址
export ANTHROPIC_BASE_URL="https://cn.luckyapi.chat"

# 2. 设置你的中转 API Key
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxx"

# 3. 非常重要:清空官方 Key 变量,防止冲突
export ANTHROPIC_API_KEY=""

# 4. (可选) 指定模型
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

# 5. 免确认模式:启动 claude 时默认跳过权限确认
claude() { command claude --dangerously-skip-permissions "$@"; }
export -f claude
powershell
# 设置用户级环境变量(永久生效)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cn.luckyapi.chat", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "", "User")
# (可选) 指定模型
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")
# 重启终端后生效

获取 API 密钥

访问 LuckyAPI 进行充值和令牌创建,复制 API Key 填入上方 ANTHROPIC_AUTH_TOKEN 即可。

注意

  • ANTHROPIC_AUTH_TOKEN 是中转站的密钥,不要填到 ANTHROPIC_API_KEY
  • ANTHROPIC_API_KEY 必须设为空字符串,否则会与中转站冲突
  • 如需指定 haiku、sonnet、opus 的替身模型,需在 ~/.claude/settings.json 中修改(不推荐)

配置完成后,运行 source ~/.bashrc(或 source ~/.zshrc)使配置生效。

4. 启动 Claude Code

在任意项目目录下运行:

bash
claude

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

Shift+Tab 切换模式

在 Claude Code 中按 Shift+Tab 可随时切换权限确认模式,无需频繁手动确认每一步操作。

常用命令

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

获取 API 密钥

访问 LuckyAPI 注册账号并创建令牌,即可开始使用 Claude Code。价格仅为官方的 6%,稳定可靠。

提示

LuckyAPI 提供低价稳定的 Claude API 服务,无需担心封号和付款问题。如遇问题,请访问 LuckyAPI 获取帮助。

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_AUTH_TOKEN 环境变量,并且 ANTHROPIC_API_KEY 设为空字符串。

Q: 连接超时?

检查网络连接,确保 ANTHROPIC_BASE_URL 设置为 https://cn.luckyapi.chat


如有其他问题,欢迎访问 LuckyAPI 获取支持,或查看 Claude Code 中文站 教程。

API 服务由 LuckyAPI 提供