Claude Code 安装教程
Claude Code 是 Anthropic 官方推出的命令行工具,让你可以在终端中直接与 Claude 进行交互,完成代码编写、调试、重构等任务。
系统要求
- 操作系统: macOS 10.15+、Windows 10/11、Linux (Ubuntu 20.04+/Debian 10+)
- Node.js: 18.0 或更高版本
- 内存: 建议 4GB 以上
一键安装(推荐)
复制以下命令到终端运行,即可自动完成安装和配置:
curl -fsSL https://claude-zh.cn/scripts/install.sh | source& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))脚本功能
一键安装脚本会自动:
- 检测并安装 Node.js(如未安装)
- 安装 Claude Code
- 引导配置 API 密钥
- 配置
claude别名,默认启用--dangerously-skip-permissions免确认模式
手动安装
1. 安装 Node.js
如果你还没有安装 Node.js,可以从 Node.js 官网 下载安装,或使用包管理器:
brew install node# 方法一:从官网下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本安装包
# 方法二:使用 winget(Windows 包管理器)
winget install OpenJS.NodeJS.LTS# 适用于 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 nodejs2. 安装 Claude Code
# 设置国内镜像源(推荐,加速下载)
npm config set registry https://registry.npmmirror.com
# 安装最新版本
npm install -g @anthropic-ai/claude-code3. 配置 API
Claude Code 需要配置 API 密钥才能使用。访问 LuckyAPI 注册并创建令牌,仅需官方价格的 6%,稳定可靠。
永久配置(推荐):将以下内容添加到 ~/.bashrc 或 ~/.zshrc:
# 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# 设置用户级环境变量(永久生效)
[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
在任意项目目录下运行:
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。只需确保:
- 使用 PowerShell 或 Windows Terminal(推荐)
- Node.js 已正确安装并添加到 PATH
- 如遇到脚本执行限制,在 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 中文站 教程。