Claude Code 安装
Claude Code 是 Anthropic 官方推出的命令行工具，让你可以在终端中直接与 Claude 进行交互，完成代码编写、调试、重构等任务。
系统要求
- 操作系统: macOS 10.15+、Windows 10/11、Linux (Ubuntu 20.04+/Debian 10+)
- Node.js: 18.0 或更高版本
- 内存: 建议 4GB 以上
一键安装（推荐）
复制以下命令到终端运行，即可自动完成安装和配置：
source <(curl -fsSL https://claude-zh.cn/scripts/install.sh)& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))脚本功能
一键安装脚本会自动：
- 检测并安装 Node.js（如未安装）
- 安装 Claude Code
- 配置
~/.claude/settings.json（跳过引导 + 禁用非必要流量 + 禁用 co-authored-by） - 引导配置 API 密钥
手动安装
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
# 安装稳定版本（2.1.112，npmmirror 可用的最新版）
npm install -g @anthropic-ai/claude-code@2.1.112
# 切回官方源（重要：避免 Claude Code 自动更新时拉到不完整的平台包）
npm config set registry https://registry.npmjs.org3. 配置 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-6"# 设置用户级环境变量（永久生效）
[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-6", "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/settings.json，添加以下配置以跳过首次引导、禁用非必要网络请求和 co-authored-by 标记：
{
"hasCompletedOnboarding": true,
"env": {
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"includeCoAuthoredBy": false
}这些配置的作用
hasCompletedOnboarding: 跳过首次启动的引导流程，避免因网络问题卡在引导页CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 禁用非必要的网络请求（遥测、更新检查等），减少因网络限制导致的问题includeCoAuthoredBy: 禁用 commit 信息中的 co-authored-by 标记
一键配置命令
mkdir -p ~/.claude && cat > ~/.claude/settings.json << 'EOF'
{
"hasCompletedOnboarding": true,
"env": {
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"includeCoAuthoredBy": false
}
EOF5. 启动 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。
卸载和重新安装
如果遇到问题需要重新安装 Claude Code:
# 卸载
npm uninstall -g @anthropic-ai/claude-code
# 重新安装
npm install -g @anthropic-ai/claude-code@2.1.112TIP
重新安装后,环境变量配置和 ~/.claude/settings.json 会保留,无需重新配置。
常见问题
Q: 提示 "API key not found"？
确保已正确设置 ANTHROPIC_AUTH_TOKEN 环境变量，并且 ANTHROPIC_API_KEY 设为空字符串。
Q: 连接超时？
检查网络连接，确保 ANTHROPIC_BASE_URL 设置为 https://cn.luckyapi.chat。
如有其他问题，欢迎访问 LuckyAPI 获取支持，或查看 Claude Code 中文站 教程。