Claude Code 官网下载入口与版本选择

这篇解决什么问题

“Claude Code 下载”这个搜索词下全是坑：第三方搬运站、来路不明的镜像网盘、过时的安装教程。本文只做三件事：把官方入口列全并说清各自用途，把两条安装路线走一遍，把版本怎么选、怎么更新、怎么锁版本讲明白。装完能干什么，属于另一件事，可以从 Claude Code 官网下载入口与版本选择之外的实战文继续深入。

认准官方入口

Claude Code 是 Anthropic 官方的终端编程工具，一切下载都以 Anthropic 自有域名为准。值得收藏的入口就这五个：

入口	地址	用途
产品页	claude.com 站内 Claude Code 产品页【待补：确认当前最终落地页】	了解功能与订阅
官方文档	docs.claude.com 的 Claude Code 分栏	安装、配置的权威说明
npm 包	npmjs.com/package/@anthropic-ai/claude-code	npm 安装源、全部历史版本列表
GitHub 仓库	github.com/anthropics/claude-code	提 issue、看更新日志
账号入口	claude.ai	Pro/Max 订阅与登录管理

判断入口真伪的经验法则：域名不在 claude.com / claude.ai / anthropic.com / npmjs.com / github.com 这个集合里的”下载页”，直接关掉。安装器要执行任意代码，入口错了风险远大于省的那点事。

环境要求

官方口径的最低要求如下，先自查再装：

平台	要求
macOS	10.15 及以上
Linux	Ubuntu 20.04+ / Debian 10+
Windows	Windows 10 build 10.0.19041+ 可原生运行，或走 WSL
内存	4GB 起步
Node.js	仅 npm 安装路线需要，18.0 以上

Windows 用户注意：原生支持和 WSL 两条路都能跑，细节差异见 Claude Code Windows/WSL 环境配置。

第一步：npm 路线安装

已有 Node 环境的，npm 全局安装一条命令：

node -v   # 18.0 以上
npm install -g @anthropic-ai/claude-code
claude --version   # 【待补：当前最新版本号输出】

装完在终端任意目录敲 claude 就能进交互会话。国内网络下 npm 慢，先切镜像源再装（方法与坑见 Claude Skills 国内安装指南：目录、代理与常见报错，两件事是同一套网络问题）。

第二步：原生安装脚本路线

不想依赖 Node 的，用官方安装脚本，macOS 与 Linux 一行：

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

Windows 在 PowerShell 里：

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

脚本地址以官方文档当前给出的为准【待补：复核两个安装脚本地址，域名迁移后可能有变化】。原生路线自带运行时，系统干净、升级独立，是新机器的首选；npm 路线的优势是版本管理和团队统一更顺手。两条路线装的是同一个工具，可以共存，which claude 看当前实际生效的是哪个。

第三步：登录、订阅与模型选择

首次运行 claude 会引导登录，两条认证路线：

订阅账号：claude.ai 的 Pro/Max 订阅直接用，额度内使用，当前价格与额度条款【待补：官方定价页数据】；
API 计费：Anthropic Console 建 API key，按 token 付费，环境变量 ANTHROPIC_API_KEY 或登录时选择该方式。

企业走 AWS Bedrock 或 Google Vertex 的，设置 CLAUDE_CODE_USE_BEDROCK=1 或 CLAUDE_CODE_USE_VERTEX=1 后按对应云的认证方式接入。会话内用 /login 换账号、/model 换模型档位，当前可选模型【待补：/model 列表】。

版本怎么选：自动更新、手动升级与锁版本

Claude Code 默认自动更新，多数人什么都不用管。三个手动开关要知道：

claude update      # 手动升级到最新
claude doctor      # 体检：安装健康状况、更新通道诊断
claude --version   # 看当前版本

npm 路线可以锁版本——团队协作最怕”你俩版本不一样行为不一样”，把版本写死进文档或安装脚本：

npm install -g @anthropic-ai/claude-code@<目标版本号>

自动更新在某些网络环境下反而添乱：公司代理拦住更新请求，每次启动都卡一阵还失败【待补：报错原文】。这种情况显式关掉自动更新、改成定期手动升级：

export DISABLE_AUTOUPDATER=1

该变量写进 ~/.claude/settings.json 的 env 字段即可长期生效。回退旧版本没有专门命令，npm 路线用 @<版本号> 重装即达成回退；历史版本号清单在 npm 包页可查【待补：当前最新版本号与发布日期】。

常见坑

坑一：装完敲 claude 提示命令不存在。 npm 全局安装的包落在 npm 的全局 bin 目录，这个目录不在 PATH 里时终端找不到命令。排查：npm bin 对应目录加进 PATH；npm 新版用 npm config get prefix 查前缀。Linux 上别用 sudo 装 npm 全局包，权限问题会向后传递，改用用户级前缀更干净【待补：实际报错原文】。

坑二：自动更新在公司网络下反复失败。 症状是每次启动先卡一段再报网络错误。处理：给 Claude Code 会话配代理变量（HTTPS_PROXY），或直接 DISABLE_AUTOUPDATER=1 关掉自动更新，锁版本手动升。

坑三：从第三方”汉化版""整合版”安装。 这些打包者改过什么没人知道，出问题也无法对照官方更新日志排查。中文环境的使用问题另有解法，参考 Claude Code 中文使用指南，本体永远只从本文列出的官方入口拿。

高频问答

多台机器要用，配置怎么同步？ 用户级配置都在 ~/.claude/ 下：settings.json、自定技能、全局 CLAUDE.md 约定，整目录拷贝或放进 dotfiles 仓库即可迁移；登录态出于安全设计不跨机器迁移，新机器需要重新认证一次。

npm 路线和原生路线能混装吗？ 能共存，which claude 决定实际生效的是哪一个，但两套的升级各管各的，容易出现”明明升级了怎么没生效”——建议一台机器只留一条路线，另一条卸干净。

升级会丢配置吗？ 不会。升级只替换程序本体，settings.json、CLAUDE.md、技能目录都在用户配置里，与程序文件分离。

内网服务器能用吗？ 纯离线不行——工具需要与模型 API 通信。企业内网可以走 AWS Bedrock 或 Google Vertex 接入，让出网流量收敛在自有云账号内，配合前文的 CLAUDE_CODE_USE_BEDROCK 等开关使用。

最终效果

验收清单：claude --version 有版本号输出【待补：截图】；claude 能进交互会话并完成登录【待补：截图】；claude doctor 各项检查通过【待补：输出截图】。

claude doctor 体检输出截图

到此安装与版本策略就绪，下一步把 Claude Code 用进真实项目——MCP 扩展、hooks 自动化、技能体系，本站都有对应的实战文，见下方相关阅读。