Claude Code 安装

Claude Code 是 Anthropic 官方推出的命令行工具，让你可以在终端中直接与 Claude 交互，完成代码编写、调试、重构等任务。

中文站的一行安装命令会安装 lucky：这是我们提供的 Claude Code 体验版本，保留原生交互习惯，并内置登录、充值、账单、模型选择等能力。你可以把它理解成更适合中文用户的一行安装入口。

系统要求

• 操作系统：macOS 10.15+、Windows 10/11、Linux、WSL
• Node.js：18.0 或更高版本
• 内存：建议 4GB 以上

Windows 用户先确认 Git

Lucky 和 Claude Code 的项目操作依赖 Git。很多 Windows 新机器没有预装 Git，所以 PowerShell 一行安装脚本会先检测 git 命令；如果没有，会自动按系统架构下载 Git for Windows 2.54.0 并静默安装。

已实测可用的国内镜像：npmmirror、清华 TUNA。脚本下载顺序是 npmmirror 主入口 -> npmmirror CDN -> 清华 TUNA -> GitHub 官方兜底。x64 与 ARM64 会自动匹配。

匿名安装统计

为了判断安装链路是否稳定，脚本会发送匿名安装事件，例如开始安装、Git 是否存在、Windows Git 镜像下载是否成功、Lucky 安装是否成功。

统计字段只包含脚本类型、系统、CPU 架构和安装阶段，不包含邮箱、用户名、token、项目路径或命令内容。如果你不希望发送统计，可以在运行前设置 LUCKY_DISABLE_TELEMETRY=1。

一行安装 Lucky（推荐）

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")))

这条命令安装什么？

脚本入口保持为 https://claude-zh.cn/scripts/install.sh 和 https://claude-zh.cn/scripts/install.ps1，方便你记忆和分享。脚本内部会切到 Lucky 正式安装源，安装完成后使用 lucky 启动。

Lucky 会尽量还原 Claude Code 原生体验，可无缝接入 Claude Code 的常用工作流。无需担心因为使用 Lucky 版本而影响账号安全；模型访问和上游配置由服务端统一处理，终端侧只保留正常登录会话。

安装完成后运行：

lucky

进入交互界面后，常用命令如下：

命令	说明
/login	登录或注册 Lucky 账号
/recharge	充值
/billing	查看使用情况和余额
/model	查看和选择可用模型
/goal	管理当前任务目标
/invoice	查看账单记录

注册邮箱推荐使用 QQ、163、Outlook 或 Gmail。客服与使用交流 QQ 群：1107096515。

更多 Lucky 命令说明见 Lucky 使用指南。

官方手动安装

如果你希望完全按 Anthropic 官方方式安装，也可以保留下面的手动流程。

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

官方 API 配置

官方 Claude Code 需要可用的 Claude API。你可以选择三种方式：

方式	适合谁	配置思路
Anthropic 官方服务	能直接使用官方 API 的用户	设置 ANTHROPIC_API_KEY
OpenRouter	想使用聚合平台或 OpenAI-compatible 接口的用户	按 OpenRouter 文档配置 base URL 和 key
自定义 Provider / 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

如果你的服务商提供 OpenAI-compatible 或 Anthropic-compatible 接口，请按它的文档填写 base URL、token 和模型名。常见形式如下：

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、鉴权字段和模型名的要求不同。上面只是 OpenRouter 风格示例；如果你使用 cc switch 或其他切换工具，以工具生成的配置为准。

Claude Code 设置

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

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

启动

Lucky 一行安装版本：

lucky

官方手动安装版本：

claude

Shift+Tab 切换模式

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

Windows 用户须知

Windows 推荐使用 PowerShell 或 Windows Terminal 运行一行安装命令：

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

这条脚本会先检查 Git。如果没有 Git，会自动下载并静默安装 Git for Windows，然后继续安装 Lucky。

自动选择规则：

系统架构	安装包
Windows x64	Git-2.54.0-64-bit.exe
Windows ARM64	Git-2.54.0-arm64.exe

下载 fallback 顺序：

顺序	来源	说明
1	npmmirror	国内主镜像，已实测可用
2	npmmirror CDN	国内 CDN 直连备用，已实测可用
3	清华 TUNA	国内高校镜像备用，已实测可用
4	GitHub 官方	最后兜底

如果自动下载被公司或校园网络拦截，可以手动下载后安装，再重新运行 Lucky 安装命令：

架构	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

如果脚本执行受限，可以运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

常见问题

Q: 一行安装后应该运行 claude 还是 lucky？

运行 lucky。中文站的一行安装命令安装的是 Lucky 版本，入口命令是 lucky。

Q: 怎么登录和充值？

进入 lucky 后输入 /login 登录，输入 /recharge 充值，输入 /billing 查看使用情况。

Q: 提示 API key not found？

如果你使用 Lucky 一行安装版本，优先在 lucky 内使用 /login 完成登录。如果你使用官方手动安装版本，请检查是否已经设置官方 ANTHROPIC_API_KEY，或按自定义 provider 文档设置了对应 token/base URL。

Q: 连接超时？

检查网络连接、登录状态、模型名是否存在，以及当前 provider 是否支持 Claude 模型。Lucky 用户也可以加入 QQ 群 1107096515 反馈。

---

如需更多工具配置，请继续查看本站 Lucky、Codex、OpenCode、VS Code 插件和 OpenClaw 教程。