安装 Claude Code

一行安装

macOS / Linux / WSL

source <(curl -fsSL https://claude-zh.cn/scripts/install.sh)

Windows PowerShell

& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))

安装完成后运行官方命令：

claude

需自行配置 ANTHROPIC_API_KEY 等，见下方 官方 API 配置。

可选：安装 lucky

纯新手推荐。 如果你不想申请官方 API key、不想研究 provider / base URL / 环境变量，也不想处理一堆依赖配置，可以安装本站 lucky 增强工具：登录即用，内置账号、充值、账单和模型切换。

和官方 claude 的区别很直接：

路径	适合谁	使用方式
lucky	想省事的新手、只想马上开始用	安装后运行 lucky，输入 /login 登录
官方 claude	已有 Anthropic / OpenRouter / 自有 provider 的用户	自行配置 API key、base URL、模型等环境变量

lucky 非 Anthropic 官方，非必须；它的价值是把繁杂配置收起来，让你先用起来。

macOS / Linux / WSL

curl -fsSL https://bridge.annealing.cn/install.sh | sh

Windows PowerShell

iwr -useb https://bridge.annealing.cn/install.ps1 | iex

安装后运行：

lucky

进入交互界面后输入 /login 登录即可使用。常用命令见 命令参考。

兼容性

macOS 10.15+ / Windows 10+ / Linux / WSL。Windows 没有 Git Bash 时脚本会自动下载 lucky 私有 PortableGit（国内镜像优先），无需提前准备环境。

---

高级：官方手动安装

TIP

上方一行安装已包含官方包；本节为分步说明，便于手动安装或查阅 API 配置。

1. 安装 Node.js

macOS

brew install node

Windows

winget install OpenJS.NodeJS.LTS

Linux/WSL

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装官方 Claude Code

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

国内网络如果 npm 官方源较慢，可临时切换镜像：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
npm config set registry https://registry.npmjs.org

3. 官方 API 配置

方式	适合谁	配置思路
Anthropic 官方	能直连官方 API 的用户	设置 ANTHROPIC_API_KEY
OpenRouter	想用聚合平台或兼容接口	配置 base URL + token
自定义 / cc switch	已有自有服务商	工具/服务商给定的环境变量

官方 Anthropic（~/.bashrc 或 ~/.zshrc）：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxx"

Windows PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxx", "User")

OpenRouter / 兼容 provider：

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_AUTH_TOKEN="你的-provider-key"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.5"

不同 provider 的 URL、鉴权字段和模型名要求不同；使用 cc switch 等切换工具时以工具配置为准。

4. Claude Code 设置

创建或编辑 ~/.claude/settings.json：

{
  "hasCompletedOnboarding": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "includeCoAuthoredBy": false
}

启动：

claude

Shift+Tab 切换权限模式

在 Claude Code 中按 Shift+Tab 可切换权限确认模式。

---

常见问题

一行安装后应该跑 claude 还是 lucky？

默认跑 claude（官方包）。仅在你额外安装了 lucky 时才用 lucky。

怎么登录和充值？

官方路径：在 Anthropic 或你的 provider 配置 API key。lucky 路径：进入 lucky 后 /login、/recharge，见 命令参考。

提示 API key not found？

一行安装后请配置 ANTHROPIC_API_KEY 等（见 官方 API 配置）。若使用 lucky，在 lucky 里 /login 即可。

连接超时？

检查网络、登录状态、模型是否存在、provider 是否支持当前模型。

---

Windows 故障排查

PowerShell 一行安装会先检查 Git Bash。如果没有可用的 Git Bash，会自动按系统架构下载 PortableGit 2.54.0 到 lucky 私有目录，并设置 CLAUDE_CODE_GIT_BASH_PATH，不会弹出 Git 安装器，也不要求重开 PowerShell。

默认 lucky 本地目录在：

$env:LOCALAPPDATA\Programs\Lucky

如果想把 lucky 主程序、命令入口、临时目录和 PortableGit 都安装到其他盘，先设置 LUCKY_HOME 再运行安装命令：

$env:LUCKY_HOME="D:\Lucky"
& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))

安装后大致目录：

D:\Lucky\bin
D:\Lucky\channels\stable
D:\Lucky\tmp
D:\Lucky\deps\PortableGit

下载顺序：

顺序	来源
1	npmmirror
2	npmmirror CDN
3	清华 TUNA
4	GitHub 官方（兜底）

如果脚本执行被策略拦截：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

如果公司/校园网络拦截了上述镜像，可以手动下载 Git 安装后再重跑安装命令：

架构	npmmirror	清华 TUNA
x64	Git-2.54.0-64-bit.exe	Git-2.54.0-64-bit.exe
ARM64	Git-2.54.0-arm64.exe	Git-2.54.0-arm64.exe

匿名安装统计

脚本会上报安装阶段（开始、Git 是否存在、镜像下载结果、整体成败），只包含系统、架构和安装阶段，不包含邮箱、用户名、token、项目路径或命令内容。如需关闭：在运行前设置 LUCKY_DISABLE_TELEMETRY=1。