AI帮助文档 main claude/setup-claude-code.md

title: 安装和登录 Claude Code description: 面向新手说明 Claude Code 的官方安装地址、系统要求、逐步安装、登录和第一次安全使用。 keywords:

  • Claude Code
  • Anthropic
  • Claude Code 入门

安装和登录 Claude Code

Claude Code 是 Anthropic 的代码助手，可以在终端里读取项目、解释代码、修改文件和执行开发任务。本文按官方 Quickstart 和 Setup 页面整理成新手可照做的步骤。

官方安装地址

系统要求

官方文档当前列出的基础要求包括：

  • macOS 13.0+
  • Windows 10 1809+ 或 Windows Server 2019+
  • Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+
  • 4 GB 以上内存
  • x64 或 ARM64 处理器
  • 可用网络连接
  • Bash、Zsh、PowerShell 或 CMD

Windows 用户可以原生使用，也可以在 WSL 里使用。新手如果项目就在 Windows 里，先用原生 Windows；如果项目依赖 Linux 工具链，再考虑 WSL。

macOS / Linux / WSL 安装

  1. 打开终端。
  2. 复制下面命令并回车：
curl -fsSL https://claude.ai/install.sh | bash
  1. 等待安装完成。
  2. 重新打开终端。
  3. 输入下面命令确认安装：
claude --version

Windows PowerShell 安装

  1. 打开 PowerShell。
  2. 复制下面命令并回车：
irm https://claude.ai/install.ps1 | iex
  1. 等待安装完成。
  2. 重新打开 PowerShell。
  3. 输入下面命令确认安装：
claude --version

Windows CMD 安装

如果你打开的是 CMD，而不是 PowerShell，使用：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果看到 && 不是有效分隔符，说明你在 PowerShell 里，应改用 PowerShell 命令。如果看到 irm 不是内部或外部命令，说明你在 CMD 里，应改用 CMD 命令。

可选安装方式

macOS 用户也可以使用 Homebrew：

brew install --cask claude-code

Windows 用户也可以使用 WinGet：

winget install Anthropic.ClaudeCode

新手优先使用官方原生安装命令。Homebrew 和 WinGet 不一定自动更新，需要按对应包管理器方式升级。

检查安装状态

安装后先运行：

claude --version

如果版本号正常，再运行：

claude doctor

claude doctor 会做更完整的安装和配置检查。看到错误时，先复制错误信息，不要急着重装。

Claude Code 安装命令和版本确认

Claude Code doctor 检查结果

第一次登录

  1. 打开终端。
  2. 进入你的项目目录：
cd /path/to/your/project
  1. 启动 Claude Code：
claude
  1. 第一次启动会提示登录。
  2. 按浏览器提示完成登录。
  3. 如果浏览器没有自动打开，按终端提示复制登录链接到浏览器。
  4. 如果浏览器显示登录码，按提示把登录码粘回终端。

Claude Code 支持 Claude Pro、Max、Team、Enterprise、Claude Console，以及部分云服务提供商方式。免费 Claude.ai 计划是否可用以官方当前说明为准。

Claude Code 首次登录流程

通过 ARAI 和 CC Switch 接入

如果你准备用 ARAI 中转站给 Claude Code 提供 API 接入，推荐先用 ARAI 的一键导出能力，减少手动填写配置：

  1. 先完成 ARAI 注册和登录。
  2. 购买合适的订阅或额度。
  3. 进入 添加和管理 API Key，创建或选择要给 Claude Code 使用的 API Key。
  4. 使用 ARAI API Key 页面的一键导出 CC Switch 配置能力。
  5. 打开 CC Switch 基础用法，导入配置并应用到 Claude Code。
  6. 重新打开 Claude Code，用一个小请求测试连接。

如果一键导出暂时不可用，再按 CC Switch 页面里的手动添加供应商流程填写 API 地址、Key 和模型信息。

第一个安全问题

第一次不要直接让 Claude Code 改项目。建议先问：

请先阅读当前项目结构，告诉我每个主要目录是做什么的。先不要修改文件。

如果 Claude Code 能总结项目结构，说明它已经能读取当前目录。

Claude Code 第一个安全请求结果

验证结果

安装和登录完成后，确认：

  • claude --version 能输出版本号。
  • claude doctor 没有关键错误。
  • 在项目目录运行 claude 能进入交互界面。
  • 登录状态正常。
  • 第一个请求没有要求它修改文件。

常见问题

我不会终端能不能用

先完成这几项操作：打开终端、进入项目目录、复制命令、查看错误信息。

Claude Code 和 Claude 网页版一样吗

不一样。网页版更像聊天入口，Claude Code 更偏向在本地项目里协助开发。

登录后还是不能用怎么办

先运行 claude doctor，再检查账户类型、网络、额度和终端错误信息。

相关页面