安装 Claude Code Claude Code 有两种官方使用方式：
官方订阅：用 Claude Pro / Max 账号 /login 登录即可使用使用 API：配置官方 API key，或 OpenRouter 等平台的 key没有 Claude Pro 账号和 API key？推荐使用 Lucky，一键安装，开箱即用。
无需配置，开箱即用 CC 原生体验 macOS / Linux / WSLWindows PowerShellbashcurl -fsSL https://bridge.annealing.cn/install.sh | shpowershelliwr -useb https://bridge.annealing.cn/install.ps1 | iex安装后运行：
bashlucky进入交互界面后输入 /login 登录即可使用。常用命令见 命令参考。
兼容性
macOS 10.15+ / Windows 10+ / Linux / WSL。Windows 没有 Git Bash 时脚本会自动下载 lucky 私有 PortableGit（国内镜像优先），无需提前准备环境。
官方一行安装 macOS / Linux / WSLWindows PowerShellbashsource <(curl -fsSL https://claude-zh.cn/scripts/install.sh)powershell& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))安装完成后运行官方命令：
bashclaude需自行配置 ANTHROPIC_API_KEY 等，见下方 官方 API 配置。
高级：官方手动安装 TIP
上方一行安装已包含官方包；本节为分步说明，便于手动安装或查阅 API 配置。
1. 安装 Node.js macOSWindowsLinux/WSLbashbrew install nodebashwinget install OpenJS.NodeJS.LTSbashcurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs2. 安装官方 Claude Code bashnpm install -g @anthropic-ai/claude-code国内网络如果 npm 官方源较慢，可临时切换镜像：
bashnpm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
npm config set registry https://registry.npmjs.org3. 官方 API 配置 方式适合谁配置思路Anthropic 官方能直连官方 API 的用户设置 ANTHROPIC_API_KEYOpenRouter想用聚合平台或兼容接口配置 base URL + token自定义 / cc switch已有自有服务商工具/服务商给定的环境变量官方 Anthropic（~/.bashrc 或 ~/.zshrc）：
bashexport ANTHROPIC_API_KEY="sk-ant-xxxxxxx"Windows PowerShell：
powershell[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxx", "User")OpenRouter / 兼容 provider：
bashexport 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：
json{
"hasCompletedOnboarding": true,
"env": {
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"includeCoAuthoredBy": false
}启动：
bashclaudeShift+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 本地目录在：
powershell$env:LOCALAPPDATA\Programs\Lucky如果想把 lucky 主程序、命令入口、临时目录和 PortableGit 都安装到其他盘，先设置 LUCKY_HOME 再运行安装命令：
powershell$env:LUCKY_HOME="D:\Lucky"
& ([scriptblock]::Create((New-Object Net.WebClient).DownloadString("https://claude-zh.cn/scripts/install.ps1")))安装后大致目录：
textD:\Lucky\bin
D:\Lucky\channels\stable
D:\Lucky\tmp
D:\Lucky\deps\PortableGit下载顺序：
顺序来源1npmmirror2npmmirror CDN3清华 TUNA4GitHub 官方（兜底）如果脚本执行被策略拦截：
powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser如果公司/校园网络拦截了上述镜像，可以手动下载 Git 安装后再重跑安装命令：
架构npmmirror清华 TUNAx64Git-2.54.0-64-bit.exeGit-2.54.0-64-bit.exeARM64Git-2.54.0-arm64.exeGit-2.54.0-arm64.exe匿名安装统计 脚本会上报安装阶段（开始、Git 是否存在、镜像下载结果、整体成败），只包含系统、架构和安装阶段，不包含邮箱、用户名、token、项目路径或命令内容。如需关闭：在运行前设置 LUCKY_DISABLE_TELEMETRY=1。