环境配置与认证

安装 Claude Code

要将 Claude Code 集成到您的开发工作流中，第一步是安装其命令行工具（CLI）。您可以选择两种主流方式：原生安装或通过包管理器安装。

原生安装通常使用 Node.js 的包管理器 npm。这种方式直接从官方源获取最新版本，让您能最快体验到新功能。它会将可执行文件放置在 Node.js 的全局路径下。如果您习惯于手动管理开发工具链，这是一种直接且透明的方法。

# 使用 npm 进行全局安装
npm install -g @anthropic-ai/claude-code

另一种方式是使用您操作系统偏好的包管理器，如 macOS 的 Homebrew 或 Windows 的 WinGet。这种方式将 Claude Code 的安装、更新和卸载都整合到您熟悉的系统级工作流中。例如，一个 brew upgrade 命令就能更新所有通过 Homebrew 安装的工具，包括 Claude Code。这简化了版本管理，但也意味着新版本的发布可能会有轻微延迟，因为它需要等待包维护者更新。

验证您的身份

安装完成后，您需要向 Claude 验证您的身份。这确保了只有授权用户才能使用其服务。Claude Code 提供了两种主要的认证路径，以适应不同的使用场景。

对于个人开发者，最简单的方式是使用 Claude.ai 账户进行网页授权。当您首次运行需要认证的命令时，CLI 会自动在浏览器中打开一个登录页面。您只需登录您的 Claude.ai 账户并授权，CLI 就会自动获取并存储一个认证令牌。这个过程基于 OAuth 2.0 协议，无需您手动处理任何敏感密钥。

# 首次运行时会自动触发浏览器登录
claude

对于企业级开发或在自动化脚本（如 CI/CD 流水线）中使用，更稳健的方法是使用。您可以在 Anthropic Console 的账户设置中生成一个密钥。获取密钥后，需要将其设置为一个环境变量。Claude Code 会自动检测名为 ANTHROPIC_API_KEY 的环境变量并用它来进行认证。这种方法避免了交互式登录，非常适合服务器环境。

# 将 API 密钥设置为环境变量 (macOS/Linux)
export ANTHROPIC_API_KEY='your-api-key-here'

# 在 PowerShell (Windows) 中设置
$Env:ANTHROPIC_API_KEY='your-api-key-here'

环境健康检查

为了确保一切准备就绪，Claude Code 提供了一个便捷的诊断工具：claude doctor。运行此命令会对您的本地环境进行一次全面的健康检查。

这个命令会验证几项关键内容：您的认证状态是否有效、CLI 是否能够成功连接到 Anthropic 服务器，以及所有必要的本地依赖项是否已正确安装。

其中一个核心依赖是，这是一个非常快的代码搜索工具。Claude Code 依赖它来快速理解您的代码库结构和内容，从而提供更精准的上下文感知辅助。如果 claude doctor 报告缺少 ripgrep，您需要先安装它。

# 运行环境检查
claude doctor

# 示例输出 (如果一切正常)
✅ Logged in.
✅ API connection is healthy.
✅ ripgrep is installed.

Your environment is configured correctly!

启动您的第一个会话

当 claude doctor 显示一切正常后，您就可以开始使用 Claude Code 了。只需在终端中输入 claude 即可启动一个交互式会话。

这个简单的命令背后，是本地 CLI 与远程 Anthropic API 之间的通信。您的指令、通过 ripgrep 扫描到的代码上下文，以及您的身份凭证被安全地发送到云端。模型处理请求后，将结果返回到您的终端。这个过程让您感觉像是在与一个能完全访问您本地开发环境的助手交谈。

您随时可以通过运行 claude --version 来检查当前安装的 CLI 版本，这对于调试或报告问题非常有用。

Quiz Questions 1/4

与原生 npm 安装相比，使用 Homebrew 等包管理器安装 Claude Code CLI 的主要优势是什么？

Quiz Questions 2/4

在 CI/CD 流水线等自动化脚本中使用 Claude Code 时，推荐使用哪种认证方式？

Claude Code 实战入门