安装与配置

按照当前官方方式安装 Claude Code，确认认证路径，并安全地准备第一个项目。

这篇指南聚焦当前更稳妥的 Claude Code 安装流程：选择官方安装方式、确认 claude 命令可用、检查认证路径，再从小项目开始使用。

选择安装方式

Claude Code 支持多种安装路径。应根据你的系统和团队工具管理方式选择：

环境	实用路径
macOS	使用官方安装器，或在团队统一管理开发工具时使用 Homebrew。
Windows	使用官方 Windows 路径，例如 WinGet；如果你的工作流依赖类 Unix 环境，再按当前 WSL 指引配置。
Linux	使用当前文档支持的发行版包管理器路径，或在适合时使用 npm。
CI 或自动化	固定版本和运行环境，不要依赖个人电脑上的临时安装状态。

认证不一定是 API Key

不要把 ANTHROPIC_API_KEY 当成安装 Claude Code 的必需前置条件。Claude Code 可能通过 Claude 订阅登录、Claude Console/API、团队或企业工作区，以及云服务商配置来使用。

登录后用 /status 确认当前使用的账号或凭证。如果 Shell 中设置了 ANTHROPIC_API_KEY，Claude Code 可能会走 API 认证，这会影响账单和用量口径。

验证 CLI

安装后打开新终端，运行：

claude --version
claude doctor

如果提示找不到 claude，先重启终端，再检查安装目录是否进入 PATH。Windows 用户要确认安装和测试发生在同一个环境中，例如 PowerShell、CMD、Git Bash 或 WSL。

准备第一个项目

正式项目之前，先用小仓库验证流程。

进入项目目录。
运行 claude。
完成登录或 provider 认证。
先让 Claude Code 检查一个小文件。
明确项目命令和边界后，再补 CLAUDE.md。

创建聚焦的 CLAUDE.md

CLAUDE.md 应用于沉淀稳定项目上下文，不要写成过长的项目百科。

# CLAUDE.md

## Project Commands

- npm run build: 构建应用
- npm run test: 运行测试
- npm run lint: 运行代码检查

## Working Rules

- 优先做小而可审查的改动。
- 总结实现前先运行必要测试。
- 涉及认证、支付或部署时，先给出计划再动手。

谨慎配置权限

第一次使用时，权限保持收窄。读取和搜索工具可以更宽松，编辑文件和执行 Shell 命令应根据任务逐步批准。

继续阅读：

官方来源

下一步: 基础使用 - 学习 Claude Code 的基本操作。