Claude Code 安装与初始配置：Windows、macOS、Linux

这篇教程会带你把 Claude Code 装到电脑里，登录账号，并让它完成第一次文件修改。使用的是官方原生安装方式，无需先安装 Node.js。

资料核对日期：2026 年 9 月 8 日。这里介绍终端版；想使用图形界面，可以接着看 Claude Code 多端教程。

安装前准备

官方目前列出的系统包括 macOS 13 及以上、Windows 10 1809 及以上，以及 Ubuntu 20.04、Debian 10 等受支持的 Linux 发行版。电脑需要联网，建议至少有 4GB 内存。

Claude Code 需要符合条件的 Claude 订阅或 Anthropic Console 账户。免费的 Claude 聊天账户不等于已经具备 Claude Code 使用权限；组织账号也可能受管理员设置限制。

先在官方网页确认能正常登录自己的账号，再安装客户端，便于区分账户问题和安装问题。

macOS 安装

打开“终端”，粘贴并运行官方命令：

curl -fsSL https://claude.ai/install.sh | bash

安装结束后重新打开终端，检查版本：

claude --version

如果你平时已经使用 Homebrew，也可以选择：

brew install --cask claude-code

两种方式选一种即可。原生安装会自动更新；Homebrew 安装默认需要自己执行 brew upgrade claude-code。

Windows 安装

打开 PowerShell，运行：

irm https://claude.ai/install.ps1 | iex

安装完成后关闭旧终端，重新打开 PowerShell，运行：

claude --version

这条安装命令用于 PowerShell，不能原样放进 CMD。PowerShell 的提示符通常以 PS 开头。

也可以使用系统里的 WinGet：

winget install Anthropic.ClaudeCode

通过 WinGet 安装的版本默认需要手动更新：

winget upgrade Anthropic.ClaudeCode

官方当前支持直接在 Windows 上运行。Git for Windows 可为 Claude Code 提供 Git Bash；未安装时，原生 CLI 可以使用 PowerShell 工具。实际开发项目仍建议安装 Git for Windows。

已经在用 WSL 2

打开 Ubuntu 等 WSL 终端，在 Linux 环境内部运行 Linux 安装命令。之后也在该终端中启动 claude，项目优先放在 ~/projects/ 一类 Linux 路径中。

Windows 与 WSL 有各自的程序、环境变量和配置文件。在 PowerShell 装好一次，不代表 WSL 中也已安装。

Linux 安装

Ubuntu、Debian 等常见桌面发行版可以在终端运行：

curl -fsSL https://claude.ai/install.sh | bash

接着检查：

claude --version
claude doctor

如果提示找不到 curl，先通过发行版的软件包管理器安装它。Alpine 等使用 musl 的系统有额外依赖，按 官方系统设置文档 的对应章节操作。

登录并进入项目

先进入你的项目目录，再启动：

cd "你的项目路径"
claude

第一次启动会引导你在浏览器登录。完成后回到终端，确认工具显示的工作目录就是刚才选中的项目。

首次打开项目还可能出现目录信任提示。先确认路径，再决定是否让 Claude Code 在这个目录工作。

如果你本来想使用订阅登录，客户端却要求确认 API 密钥，检查当前环境是否设置了 ANTHROPIC_API_KEY。该变量会影响登录流程。需要重新登录时，在 Claude Code 会话里使用 /login。

先做这两项配置

1. 给项目写一份 CLAUDE.md

在项目根目录创建 CLAUDE.md，可以从下面这份最小内容开始：

# 项目约定

使用简体中文交流。
修改前先阅读 README，确认项目的启动和测试方法。
完成后说明改了什么，以及怎样验证结果。
如果当前项目没有测试命令，请直接说明。

这个文件用来放项目背景和长期约定。把真实的启动命令、目录说明补进去，会比堆很多泛泛要求更有用。

2. 按需设置更新渠道和模型

在终端会话中输入 /config 可以调整个人选项。原生安装如果希望使用更新较稳的渠道，可以在用户配置文件里设置：

{
  "autoUpdatesChannel": "stable"
}

用户配置文件位置：

如果文件已经有内容，把这个字段合并进去，保留原有设置。JSON 不能带注释，也不能在最后一项后面多写一个逗号。

模型通过 /model 菜单选择，先使用账号默认提供的选项即可。权限模式可以从工具提供的菜单查看，初次练习可选择 Manual，先了解每次修改会做什么。

做一次完整练习

在练习项目中创建 README.md，写两三句话。然后发送：

读取 README.md，先用三句话解释这个项目。然后把文档整理成“用途、使用方法、待完成事项”三个部分，不编造当前项目没有的功能。

检查三件事：

1. Claude Code 读到了正确的文件。
2. 你能看到它提出或完成的具体修改。
3. 用自己的编辑器打开 README.md，内容确实更新了。

能完成这一步，安装、登录和项目访问就已经连通。

常见问题

遇到下载错误时，保留具体报错，按 官方安装排错指南 对照处理。

下一步：把 Claude Code 用到桌面、IDE、网页和手机。

官方参考

• Claude Code 安装与系统要求
• 配置文件与作用范围
• CLAUDE.md 与项目记忆