Claude Code 怎么装怎么选：4 种安装方式与数据去向说明

Claude Code 是 Anthropic 的终端编程智能体：装到本机后，它能读你的代码库、改文件、跑命令、处理 git。这篇只解决两件事——怎么把客户端装起来（4 种官方方式），以及你的代码、会话、反馈数据分别流向了哪里。

下文里凡标注「第三方实测」的，来自中文社区博客的实验；其余命令、数据条款均出自 Anthropic 官方仓库与官方文档，抓取日期 2026-11-01。

现在值得重看一遍安装路径，原因有两个：官方仓库 README 明确写了 “Installation via npm is deprecated”，npm 通道已不再推荐；而「把 Claude Code 云会话跑进自己机房」的自托管环境在 2026-08-06 进入公开测试（公告页 Date 字段；检索接口的发布日期字段为 08-05，同一页面的两种日期口径），官方文档又在 2026-10-23 更新了可用性与限制条款。如果你按旧教程敲 npm 命令，或者默认「装到本机 = 数据不出本机」，这两处正好最容易踩空。

先分清三种「本地」，数据边界完全不同

搜「Claude Code 本地部署」时最常见的误会，是把下面三件事混成一件。它们对数据的处理差别很大：

所以「本地部署」到底指第几行，决定了你后面所有的合规结论。第一行不需要任何服务器，第二行需要一整套 runner 基础设施，第三行需要一台撑得住本地模型的机器。

安装：4 种官方方式，命令逐字来自官方 README

前置条件三件事，做完再往下：

1. 一台 macOS / Linux / Windows 机器和可用终端，执行 curl 或 winget --version 确认命令存在。
2. 一个 Anthropic 账号与可用订阅计划，终端会话需要登录后使用；自托管环境目前只在 Team 与 Enterprise 计划公开测试。
3. 如果要走本地模型路线，准备一台能装下目标模型显存的机器——第三方实测用的是 NVIDIA DGX Spark 跑 2840 亿参数 DeepSeek V4。

直接复制执行：

# macOS / Linux（二选一）
curl -fsSL https://claude.ai/install.sh | bash
brew install --cask claude-code

# Windows（二选一，在 PowerShell 中）
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode

选法上有个容易忽略的差别：Homebrew 和 WinGet 的好处是以后升级走 brew upgrade --cask claude-code / winget upgrade Anthropic.ClaudeCode，版本可追踪；两个官方脚本每次跑都是最新快照，排查问题时不好确定「当时装的是哪一版」。第一次装建议用脚本，长期用建议 brew 或 winget。

官方 README 单独标注了一行：npm 安装已弃用（”Installation via npm is deprecated”），npm install -g @anthropic-ai/claude-code 只建议留给旧环境排障用，新装别走这条。

装完后，官方给的流程是进入你的项目目录再运行：

cd /path/to/your/project
claude

数据到底去了哪：官方 README 写明的范围

官方仓库 README 的「Data collection, usage, and retention」一节写得很具体：使用 Claude Code 时会收集反馈信息，其中包括使用数据（例如代码被接受还是被拒绝）、相关的会话数据，以及你通过 /bug 命令提交的用户反馈。用途指向官方数据使用政策；保护措施列了三条——对敏感信息采用有限保留期、限制对用户会话数据的访问、以及有明确的政策不把反馈用于模型训练。完整口径在官方 Commercial Terms of Service 与 Privacy Policy 里。

据此可以推出一个官方没有直说的边界（这是我的判断，不是官方结论）：既然「代码接受或拒绝」和「相关会话数据」属于会被回传的反馈，那么把客户端装在本机，并不等于内容不出本机——留在本机的是文件本身，回传的是围绕它产生的反馈与会话数据。注意自托管也不等于“什么都不外传”，而且它的推理后端只有官方支持的两条路：默认用 Anthropic API，或把 runner 配置为发到 Amazon Bedrock 或 Google Cloud 的 Agent Platform——官方原话补了一刀：在这两种情况下，会话内容都会发送给 Anthropic。也就是说自托管解决的是“执行发生在你的网络内”，不解决“会话内容不出网”。

这是两条不同的路径，别混用：① 自托管推理后端（上表这条路）——执行在内网、模型走 Anthropic/Bedrock/GCP，会话内容仍回传 Anthropic；② 客户端换本地模型（第三方方案，直接改 base URL 指向本地推理）——模型不出网，但那是客户端侧改造，不属于官方自托管能力，要自己扛推理性能与模型许可。按“要数据合规”还是“要完全离线”选边，别指望一条路同时满足。

自托管环境：让云会话跑进你自己的网络

官方文档把自托管拆成三个部件：环境（云会话可发送到的命名目标，在 claude.ai 管理员设置里创建）、运行器（在你网络内主机上跑、实际执行会话的程序）、会话（开发者发起的一个 Claude Code 任务）。运行器的思路和自托管 CI 运行器一致，一次为一个所有者服务，并在认领第一个会话时锁定该所有者，所以检出的代码不会在所有者之间混合。

启动入口之一是终端里的 claude --cloud；也可以从 claude.ai、移动与桌面应用、云端定时任务发起。文档写明 Anthropic 从不连接到你的网络，出站主要是到 api.anthropic.com 的 HTTPS。

几个硬限制直接决定你能不能选这条路：默认关闭，需要所有者在云环境管理页面打开，且组织需启用 cloud sessions；仅 Team 与 Enterprise 公开测试；对启用了零数据保留或应用了 HIPAA 配置的组织不可用；会话使用 Anthropic API，除非你把运行器配置为把模型请求发到别处。官方文章还给了一句建议：对大多数企业，官方更推荐托管方案，把自托管留给网络、工具链或合规要求确实需要自己掌控执行环境的团队，并提醒要安排工程人力长期维护。

换后端模型：把模型请求指向本地推理

第三方实测（中文社区博客，未在官方文档核实）给出的做法很直接：Claude Code 调用的是 Anthropic 消息接口 /v1/messages，但并不限制服务提供方，只要后端遵循同一套接口协议就能交互。把环境变量指向本地兼容服务即可：

export ANTHROPIC_BASE_URL=http://localhost:8080

该文称用了两款兼容 Anthropic 标准的本地推理服务：其自研的 DS4 推理引擎，以及 Ollama。这是本文唯一涉及本地模型性能对比的第三方结论——本地模型的能力上限低于顶级云端模型，且它引用的是 NVIDIA DGX Spark 这类高配硬件，属于硬件条件下的结果，不能直接套到普通工作站。

跨源对比一下这两条路线：官方自托管的默认状态仍然是「代码在内网、模型走 Anthropic API」，而第三方方案直接换 base URL，等于模型也在本地。合规口径不同——前者要谈 runner 运维与出站白名单，后者要谈推理服务本身的性能与模型许可。

常见卡点与成功标志

卡点一：按旧教程装 npm。 官方 README 的原话就是 “Installation is deprecated”（安装通道已弃用），后续问题多与版本混乱有关。解法：改用上面的四种方式之一重装，并卸载旧的 npm 版本避免 claude 指向旧路径。

卡点二：自托管开关找不到。 官方文档写明「默认关闭」，且前提是组织已启用 cloud sessions，只有 Team 与 Enterprise 的公开测试可用。解法：让组织所有者在 claude.ai 的云环境管理页面打开允许自托管环境，不是开发者能自行开启的选项。

卡点三：开了零数据保留或 HIPAA 才发现用不了自托管。 这是官方列明的排除项，无法通过配置绕开。解法：回到终端内会话（开发者本机运行），或确认组织合规口径后评估换本地模型后端。

算成功的标志有三个：终端里跑 claude 出现交互提示符且能读取当前目录；自托管环境下，你的环境名出现在各入口的会话选择器中，且运行器认领会话时完成 owner 锁定；换后端时，终端会话不再向 api.anthropic.com 发出模型请求，而是打到你自己 ANTHROPIC_BASE_URL 指向的地址。

参考来源

• Self-hosted environments for Claude Code – Skip to main content

• Claude Code 官方仓库 README：安装命令、弃用提示、数据收集与保留条款原文。

• 自托管环境官方文档（中文）：环境/运行器/会话三部件、可用性与限制。

• Run Claude Code sessions on your own compute（官方文章，2026-08-05）：公开测试状态与官方选型建议。

• 如何省下数千美元成本，本地部署 Claude Code（中文社区第三方实测，2026-07-30）：ANTHROPIC_BASE_URL 本地后端做法与本地模型性能对比，属第三方结论。