Claude Code 官网入口怎么找:下载、文档与安装

Claude Code 官网入口可从官方文档开始,下载安装与排错再转到官方仓库。

截至 2026 年 11 月,Claude Code 的官网信息仍分散在文档站、安装脚本和 GitHub 仓库中,而且 npm 安装已被官方标记为弃用。现在最省事的做法,是先从 code.claude.com 确认产品与账号要求,再按操作系统使用官方安装命令;不要从搜索结果中的第三方下载页或旧教程找安装包。

先分清三个官方入口

Claude Code 是运行在终端里的智能编程工具,可以读取代码库、执行日常开发任务、解释代码,并通过自然语言命令处理 Git 工作流。它不只是一个聊天网页。

网上常见的“Claude Code 官网”可能分别指向文档、下载脚本或源代码仓库,功能并不相同。直接点击 Claude Code 官方文档总览,可以确认产品定位、安装方式与账号要求;需要查完整操作说明时,从文档左侧导航进入对应章节。

要找的内容 准确入口 页面路径或位置
产品说明与使用方式 官方文档总览 文档站首页,进入 Overview
官方安装命令 GitHub 官方仓库 README → Get started → Install Claude Code
下载脚本与卸载说明 安装文档 Overview 中的安装相关内容
容器开发环境 Development containers 文档 文档左侧导航 → Development containers
GitHub 账号入口 GitHub 登录页 登录后返回官方仓库

这里最容易混淆的是“Claude 应用”和“Claude Code”。Claude Code 的官方说明位于 code.claude.com,官方源代码和安装命令位于 anthropics/claude-code 仓库。搜索“Claude 官网”时,前者可能排在前面,但它并非所有下载链接的集合。

开始前完成三项准备

  1. 准备可用账号。 打开 Overview 文档,确认页面列出的 Claude 订阅或 Anthropic Console 账号要求;没有账号时先按页面提示注册或登录。

  2. 进入要操作的项目目录。 打开终端,用 cd 切换到代码所在目录,并运行 pwd;输出应是你准备让 Claude Code 处理的工程路径。

  3. 确认终端与 Shell。 macOS/Linux 的安装脚本要能执行下载;Windows 的 Shell 官方支持 PowerShell 和 CMD 两种(安装页原文:Shell: Bash, Zsh, PowerShell, or CMD;提示符带 PS 的是 PowerShell,不带的是 CMD),两条路各有安装命令,见下文。Git for Windows 是官方推荐项(原生 Windows 上装它,Claude Code 才能用 Bash 工具;没装则退回 PowerShell 当 shell 工具,WSL 不需要)。Windows Package Manager 仅在你选 WinGet 备选路时才用到——各条路的前置不同,别混为一谈。

账号负责提供 Claude Code 所需的服务权限;安装脚本只负责把程序放进本机,两者不能互相替代。已经在其他电脑上安装过 Claude Code,也不代表当前终端中的 claude 命令可以直接使用。

三步完成安装与启动

1. 按系统复制官方安装命令

macOS 或 Linux 推荐使用仓库 README 中的原生安装脚本:

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

已经使用 Homebrew 的 macOS 用户可以使用:

brew install --cask claude-code

Windows 用户,仓库 README 把原生 PowerShell 脚本列为推荐方式(原文 Windows (Recommended)):

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

用 CMD 的官方安装命令是另一条(原文 Windows CMD):

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

已装 Windows Package Manager 的也可以用 WinGet:

winget install Anthropic.ClaudeCode

这些命令来自 anthropics/claude-code 仓库 README 的 “Install Claude Code” 部分。仓库 README 当前的完整清单:macOS/Linux 用 curl -fsSL https://claude.ai/install.sh | bash(推荐)、Homebrew 备选、Windows 用 irm https://claude.ai/install.ps1 | iex(推荐)、WinGet 备选、NPM 已标记 Deprecated(npm install -g @anthropic-ai/claude-code,别再照旧教程装)。

2. 在项目目录启动 Claude Code

安装结束后,进入项目根目录并运行:

claude

这是官方仓库 README 给出的启动步骤。它必须在终端中运行,不是在浏览器里刷新某个页面。

如果习惯在 IDE 中使用 Claude Code,应以官方文档当前说明为准。官方仓库还说明 Claude Code 可用于终端、IDE,或在 GitHub 中通过 @claude 使用;不同入口的账号、项目授权和可用功能可能不同,不能把网页端登录状态直接等同于终端授权。

3. 按登录提示完成授权

首次运行 claude 后,按终端显示的提示登录,并确认授权的是准备使用的 Claude 订阅或 Anthropic Console 账号。若终端要求打开浏览器完成授权,请只进入页面显示的 Anthropic 官方地址。

完成登录后,用一个只读问题验证连接,例如让 Claude Code说明当前目录的项目结构。此时无需立即授予写入、运行命令或修改文件的权限;先确认它读取的是正确工程,再逐步开放权限,能减少误改文件的风险。

安装方式怎么选,官方警告也要看清

官方仓库当前明确写着:Installation via npm is deprecated. Use one of the recommended methods below. 也就是说,通过 npm 的安装方式已弃用,新装时不应继续照着旧教程执行下面的命令:

npm install -g @anthropic-ai/claude-code

这条命令仍然存在于仓库的历史安装列表中,但官方已明确标注 “NPM (Deprecated)”。对旧教程的判断不能只看“命令还能不能找到”,还要看同一页面是否把它标为弃用。

安装方式 适合谁 官方当前状态 注意事项
curl 原生脚本 macOS、Linux 新装用户 推荐 需要信任并执行 Anthropic 官方脚本
Homebrew 已使用 Homebrew 的 macOS 用户 提供 使用 claude-code cask
WinGet Windows 用户 提供 先确认系统可用 winget
npm 维护旧环境 已弃用 新装不再优先采用
开发容器 团队或容器化项目 有专门文档 需先准备容器环境

这不是“哪种方式功能最多”的比较,而是安装路径不同。原生脚本适合没有额外包管理器的用户;Homebrew 用户沿用现有软件管理习惯更省事;Windows 则可直接走 WinGet。团队需要统一开发环境时,再查看 Development containers,不要先把个人全局安装误当成容器方案。

常见卡点:分清弃用警告与登录故障

最常见的安装卡点是沿用旧教程。终端或文章中出现下面这条 npm 命令时:

npm install -g @anthropic-ai/claude-code

不要继续把它当成首选方案。执行前面的原生脚本或 WinGet 命令安装后,再用 claude 启动;如果此前通过 npm 安装过旧版本,应先按官方安装文档中的卸载说明处理旧安装,避免同机存在两套程序。

GitHub 登录页还可能出现这条官方页面报错:

Uh oh! There was an error while loading. Please reload this page .

可执行的处理是刷新当前 GitHub 登录页,再通过 官方仓库返回地址 登录。刷新后仍失败时,先检查账号能否正常访问 GitHub;只有 anthropics 组织的仓库需要提交 Issue,不需要为安装问题创建个人 fork。

还有一个边界要分清:官方仓库展示的 star、fork、Issue 数量会持续变化,不是安装状态。判断是否成功,不要看这些数字,而要看本机命令能否启动、项目目录是否正确、登录是否完成。

怎么确认已经装成功

安装成功的可观察结果有三项:

  1. 在系统终端运行 claude,程序能够启动,而不是停留在命令无法执行的状态。
  2. 运行 pwd 后显示项目目录,再启动 Claude Code,确保它打开的是预期工程。
  3. 完成授权后,用只读问题让它概括当前项目;界面能返回与目录内容相符的说明,说明命令、账号和项目路径都已连通。

如果只想继续查资料,直接打开 Claude Code 文档总览;如果需要看最新安装命令、提交问题或核对变更,则打开 官方 GitHub 仓库。这两处分别是操作文档与版本入口,职责不同,也构成了最可靠的官方信息组合。

评论区

0 条评论

登录后可评论。

小猫跳舞 37 阅读