安装与初始配置

原生安装与自动更新

不同于传统的 IDE 插件，Claude Code 是一个“终端优先”的开发工具。为了获得最佳体验，我们推荐使用原生安装方法。这种方式不仅流程简单，还能确保你的工具可以自动更新到最新版本，让你随时享用新功能和性能优化。

根据你的操作系统，在终端执行以下对应指令即可。

# macOS / Linux (使用 curl)
curl -sSL https://install.claude.sh | sh

对于 Windows 用户，请打开 PowerShell (建议以管理员身份运行) 并执行以下命令：

# Windows (使用 PowerShell)
pwsh -c "irm https://install.claude.sh/windows | iex"

安装脚本会自动检测你的系统架构和 Shell 环境，并将 claude 可执行文件放置在正确的路径下。安装完成后，你可能需要重启终端才能使 claude 命令生效。

首次运行 claude 命令时，系统会提示你进行身份认证。你有两种选择：或 OAuth。

API Key: 这种方式适合通过 Anthropic 控制台管理 API 的开发者。你需要生成一个密钥，并将其配置在本地环境中。这对于自动化脚本和 CI/CD 流水线尤为重要。
: 如果你是 Claude Pro 或 Max 的订阅用户，这可能是最便捷的方式。它会通过浏览器打开一个登录页面，让你授权 Claude Code 访问你的账户。整个过程无需手动处理密钥。

选择哪种方式取决于你的使用场景。自动化流程几乎总是使用 API Key，而日常的交互式编码则可以方便地使用 OAuth。

如果你选择了 API Key 认证，最佳实践是将其设置为。这样可以避免将敏感信息硬编码到脚本或配置文件中，提高了安全性。

你需要将从 Anthropic 控制台获取的 API Key 设置为名为 ANTHROPIC_API_KEY 的环境变量。

在 macOS 或 Linux 上，你可以通过编辑 ~/.zshrc、~/.bash_profile 或其他 shell 配置文件来永久设置它：

# 将下面这行代码添加到你的 shell 配置文件中
# 将 YOUR_API_KEY_HERE 替换成你的真实密钥
export ANTHROPIC_API_KEY='YOUR_API_KEY_HERE'

修改配置文件后，记得执行 source ~/.zshrc (或相应的文件) 或重启终端使改动生效。

在 Windows 上，你可以在系统属性的高级设置中添加或编辑环境变量。

完成所有配置后，最后一步是验证安装是否成功。只需在终端运行以下命令：

claude --version

如果一切正常，它会输出你当前安装的 Claude Code 版本号。保持工具是最新版本可以确保你获得最佳的性能和功能。现在，你已经准备好在终端与 Claude 开始协作编码了。