Claude Code官方安装脚本全解析：从零安装到权限配置

最近把主力终端工作流换成了 Claude Code，从安装到日常使用折腾了差不多一个礼拜。网上关于 Claude Code 的讨论很多，但大多停留在“一句话装完”的层面，真正把官方安装脚本、环境依赖、登录授权、权限设置、升级卸载这些环节讲透的内容不多。这篇我用自己的实操过程做底子，把 Claude Code 官方安装脚本从零到一拆开讲清楚，顺便把我在 macOS、Windows 和 Linux 三台机器上装出来的经验和坑一起放进去。

如果你正准备在自己的电脑或服务器上装一个命令行里的 AI 编程助手，想知道官方安装脚本到底做了什么事、和 npm 安装有什么区别、装完以后怎么登录、怎么放开文件读写和命令执行的权限，那这篇应该能直接照着做。新手不用慌，老手也能从后面的权限配置和排错清单里捞到一些有用的东西。

1. Claude Code 是什么，为什么值得装

1.1 终端里的 AI 结对程序员

Claude Code 是 Anthropic 官方推出的命令行 AI 编程工具，它的定位不是简单的代码补全插件，而是能直接“住在终端里”的 AI 协作者。你可以在任意目录下启动它，让它读取整个项目结构、搜索文件、理解代码逻辑，然后直接改代码、跑测试、执行 shell 命令，甚至帮你提交 Git commit。

对比你在网页端或者图形编辑器里使用的 AI 编程助手，Claude Code 最大的优势是离你的开发环境足够近。它天然运行在终端里，所以你写的命令、脚本、构建工具、环境变量它都能感知到。比如你让它“帮我看一下这个服务为什么启动失败”，它会自己去读日志、查进程、检查配置文件，而不是像网页端那样只能靠你手动贴代码。

我用它做得最多的几件事包括：批量重构老项目里的重复代码、给一个不熟悉的开源仓库梳理模块结构、写临时脚本处理数据、在排查线上问题时让它帮我分析一堆日志文件。这些场景如果靠传统方式，要么自己一页页翻，要么复制粘贴到网页端来回折腾，效率差很多。

1.2 适合谁、不适合谁

如果你平时的开发工作依赖命令行，比如后端开发、DevOps、数据分析、嵌入式开发，或者经常通过 SSH 连到服务器上改东西，那 Claude Code 可以说非常契合。它不需要图形界面，在远程终端里一样能跑，很多同学把它装到开发机上再搭配 VS Code Remote 用。

但如果你是纯前端或者偏向图形界面的用户，可能还需要一点适应成本。虽然它也支持在 VS Code 插件里运行，但它的核心交互方式仍然是命令行，习惯之后会觉得很顺手，初期可能会觉得不如点鼠标直观。更极端的纯业务用户，其实更适合图形化客户端的对话形式，命令行工具不是为这类场景设计的。

1.3 我为什么推荐优先用官方安装脚本

Claude Code 的安装方式不止一种，官方安装脚本、npm 全局安装、桌面客户端、VS Code 插件都有。我在这篇文章里重点讲官方安装脚本，是因为它最贴近“一条命令装好”的直觉，而且不需要你提前准备 Node.js 环境。

另外从安全角度讲，从官方脚本安装能减少依赖第三方转载带来的供应链风险。社区里确实有一些自定义安装包、魔改配置之类的方案，但我不太建议你用。AI 编程工具本身有读取代码和执行命令的权限，如果来源不可控，风险会放大很多。所以这篇文章严格围绕官方安装脚本和官方 npm 包来做，第三方魔改方案我会在后面简单提一下风险，不展开。

2. 安装前必读：三种安装方式怎么选

2.1 官方安装脚本：macOS 和 Linux 的默认首选

Anthropic 官方提供了一键安装脚本，主要面向 macOS 和 Linux。它做的事情说起来很简单：下载对应平台的 Claude Code 二进制包，放到用户目录下，建立一个 claude 命令的软链接，然后告诉你在终端里执行claude就可以启动。

官方给出的安装命令通常长这样：

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

这个命令的含义是：用 curl 下载远程脚本，然后把脚本内容交给 bash 执行。它在 macOS 和主流 Linux 发行版上都能跑，不需要系统里有 Node.js，这是它相对 npm 安装方式最省心的地方。

我个人在 macOS 和 Ubuntu 服务器上都用过这条路，整个过程大概十几秒。脚本本身很小，下载也很迅速，装完之后 claude 命令就可以直接用了。

2.2 npm 全局安装：Windows 用户和 Node 用户的首选

如果你用的是 Windows，或者你机器上已经有 Node.js 环境，那用 npm 全局安装其实更省事：

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

npm 安装方式的好处是跨平台一致，Windows、macOS、Linux 都能用，而且版本升级命令很直观：

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

Windows 用户我没有特地去用官方安装脚本，因为那个脚本设计上更偏 Unix 生态，在 PowerShell 里直接跑容易遇到各种路径和权限问题。反而 npm 方式在 Windows 上表现得更顺畅。如果你已经装了 Node.js，npm 方式是最不容易出错的。

2.3 VS Code 插件、桌面客户端和 CLI 的关系

顺带说一下，现在 Claude Code 已经不只有命令行版本了。官方还出了 VS Code 插件和桌面客户端，它们和 CLI 共享同一套登录状态和配置。也就是说，你用命令行登录一次，VS Code 插件里大概率可以直接识别，不用重复登录。

我实际使用的组合是：终端里用 CLI 做批量操作和服务器端任务，VS Code 里装插件做代码上下文改写。两者配合得很舒服。但无论哪种界面，底层核心仍然是同一个命令行引擎，所以安装 CLI 依然是整个流程的基础。这篇文章接下来就以 CLI 的安装和配置为中心，桌面端只是顺带提一下。

3. 安装前的环境检查与准备

3.1 操作系统与终端类型

官方对操作系统的要求其实不高。我在 macOS 12、Windows 11、Ubuntu 22.04 上都跑过，都是直接运行成功的。Linux 这边常见的发行版应该问题都不大，因为它本质上是把用户级二进制文件放到家目录里，不涉及系统级包的依赖，兼容性反而比很多系统级安装工具好。

终端类型上，macOS 用户直接用系统自带的 Terminal 或者 iTerm2 都可以；Windows 用户建议用 Windows Terminal 或者 PowerShell 7，老版本自带的命令提示符也能用，但体验会差一些，而且后面配置环境变量时 PowerShell 更顺手。

提示：如果你的系统里有多个终端工具，安装完成后记得重新打开终端窗口再执行 claude 命令，避免 PATH 环境变量没有刷新的问题。

3.2 Node.js 环境检查

虽然官方安装脚本不需要 Node.js，但如果你选择了 npm 安装方式，Node.js 就是硬前提。Claude Code 官方要求 Node.js 18 以上，我建议直接上 20 以上的 LTS 版本，日常使用会少很多兼容性问题。

先确认一下当前环境：

node -v npm -v

如果 node 命令找不到，或者版本太老，我建议不要直接去官网下载安装包手动装，而是用版本管理工具。macOS 和 Linux 推荐 nvm，Windows 推荐 nvm-windows。用版本管理工具的好处是以后想换 Node 版本很轻松，不会把系统环境搞得一团糟。

3.3 磁盘空间与权限准备

Claude Code 本体是一个二进制文件加一堆运行库，体积没多大，几百 MB 的磁盘空间怎么都够用。它不需要管理员权限，安装时默认写到家目录下，不会去动系统目录，所以不用担心安装时要密码之类的问题。

但要注意的是，真正使用 Claude Code 时它对文件系统的访问权限是很大的。它会询问你是否允许读取某个目录、是否允许执行某条 shell 命令。你需要理解这些授权的意义，而不是一路“允许”到底。后面我专门有一节讲权限配置，这里先提醒一句：安装可以不谨慎，授权必须谨慎。

4. 使用官方安装脚本完整实操

4.1 macOS 和 Linux 的一键安装记录

我在一台 macOS 机器上的实际安装过程是这样的。打开终端，执行官方命令：

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

脚本执行过程中会打印一些输出，核心是下载二进制文件、解压到目录、建立命令行链接。整个流程跑完以后，终端会提示你安装完成，可以执行 claude 启动。

装完之后先验证一下：

claude --version

如果提示 command not found，最常见的原因是安装目录没有进入 PATH。官方脚本一般默认会把 claude 命令放到~/.claude/local目录下，你需要检查这个目录是否在 PATH 环境变量里。临时生效可以用：

export PATH="$PATH:$HOME/.claude/local"

如果想永久生效，根据你用的 shell，在~/.zshrc或者~/.bashrc里加上这行导出语句，然后执行source ~/.zshrc或者重新打开终端。

注意：直接执行远程脚本前，我习惯先用编辑器或者less把脚本内容大致看一遍。一条curl | bash命令看似方便，但如果你不了解它到底做什么，风险是全盲的。官方脚本我检查过，内容干净，但这个习惯建议你自己也保留。

4.2 Windows 11 的安装记录

Windows 上没有官方的 Unix 安装脚本，我实测最顺的方式就是 npm 全局安装。先确保 Node.js 环境正常，然后在 PowerShell 里执行：

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

安装完成后同样验证：

claude --version

Windows 上有一个小坑：如果提示“因为在此系统上禁止运行脚本”之类的错误，通常不是 Claude Code 的问题，而是 PowerShell 执行策略的限制。你可以在管理员权限下执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

这条命令允许本机脚本运行，同时要求来自网络的脚本有签名，既解决了问题，又不会把安全策略全放开。

4.3 安装后第一次启动会发生什么

安装完成后，在任意项目目录下执行：

claude

第一次启动会进入登录引导流程，通常是在浏览器里打开一个授权页面，然后回到终端确认。整个过程我会在下一节详细讲。这里先提醒，首次启动前确保你有一个 Anthropic 账号，并且该账号开通了 Claude 相关服务的订阅或 API 权限，否则登录那一步过不去。

4.4 通过环境变量对接企业内网网关的场景

有几个热搜词提到“接入 deepseek”“切换模型”之类的内容。我在这里补充一个中立的实现思路：Claude Code 支持通过环境变量ANTHROPIC_BASE_URL指向一个兼容 Anthropic API 协议的服务地址，因此你完全可以把请求路由到公司内部的自建网关或者合规的第三方兼容服务，而不需要改代码。

具体做法是在启动 claude 之前设置环境变量：

export ANTHROPIC_BASE_URL="https://your-gateway.example.com" export ANTHROPIC_AUTH_TOKEN="your-token"

这样做的好处是统一出口、方便审计。但我要提醒一句：使用任何非官方服务地址，都要先确认它的合规性、数据私密性和服务可用性，别为了一时方便把代码和登录凭证暴露到未知服务里。我平时只在明确受信任的企业内网环境里这么配，公开项目和个人账号都老老实实用官方端点。

5. 登录认证与首次配置

5.1 Anthropic 账号登录流程

Claude Code 的登录方式走的是浏览器授权。首次运行 claude 后，终端会显示一个授权链接和一段一次性配对码。你需要在浏览器里打开那个链接，登录 Anthropic 账号，输入配对码完成授权。

授权完成后，CLI 会在本地保存登录信息，后续再启动就不需要重复登录了。不同账号体系之间也可以切换，命令是：

claude /login

如果你是用 API 的方式，也可以通过环境变量ANTHROPIC_API_KEY设置 API 密钥，这样就不依赖浏览器登录。两种方式选一种即可，我个人更推荐浏览器授权，因为密钥不用写进环境变量，泄露风险更小。

5.2 登录时遇到 “unable to connect” 的排查思路

热搜词里有一条“welcome to claude code unable to connect to anthropic services fail”，这个问题我遇到过几次，通常不一定是账号问题，而是环境层面导致的连接失败。排查顺序一般是：

第一步，确认本机网络能够正常访问官方服务端点。直接在终端里用curl测一下服务端点的连通性，返回正常响应说明网络层面没问题。

第二步，检查环境变量。因为 Claude Code 支持通过ANTHROPIC_BASE_URL修改服务地址，如果之前设置过这个变量，并且指向的地址已经失效，就会出现能启动但连不上服务的情况。排查时直接看这个变量有没有被设置：

echo $ANTHROPIC_BASE_URL

如果有值，先把它清掉再试。这一步我踩过坑，之前为了测试公司网关改了这个变量，后来忘了还原，结果折腾了半小时。

第三步，确认账号状态和订阅状态正常。如果账号欠费、API 额度用完或者服务端临时故障，终端也会有类似提示。

5.3 权限模型：CLI 如何给完全访问权限

很多同学第一次用 Claude Code 时，会觉得它每执行一个命令都要问一次“是否允许”，特别繁琐。这其实是 Claude Code 默认的安全机制。它涉及几种权限类型：

• 文件读取权限（Read）：允许 AI 读取指定文件或目录
• 文件编辑权限（Edit/Write）：允许修改文件
• 命令执行权限（Bash）：允许执行 shell 命令

在交互界面里输入：

/permissions

可以打开权限管理面板。你可以在里面把常用的命令或目录加入允许列表，这样后续就不用每次确认了。

如果你更喜欢直接改配置文件，Claude Code 也会在~/.claude/settings.json里保存权限相关设置。一个典型的配置片段是：

{ "permissions": { "allow": [ "Read(~/Projects/**)", "Bash(npm run *)", "Bash(git *)" ], "deny": [ "Bash(rm -rf *)" ] } }

allow 列表里每一项表示一条授权规则，Read(~/Projects/**)表示允许读取 Projects 目录下的所有内容，Bash(git *)表示允许执行所有以 git 开头的命令。deny 列表则用于硬性禁止某些危险操作。

5.4 我建议的授权策略

给“完全访问权限”不等于把一切都允许。我个人的策略是：只给当前工作目录的读写权限，并把常用的安全命令加入允许列表，比如 git、npm run、pnpm、python 等；易造成破坏的命令，例如删除目录、强制提交、改动系统配置，宁可让它多问我一次，也不放进白名单。

你可以在项目根目录放一个共享的配置文件，也可以只在用户级配置里设置。这样既能减少确认次数，又能守住底线。尤其是多人共用一台服务器的情况，这个策略能避免相当多的误操作。

6. 日常使用、升级卸载与常见问题排查

6.1 版本升级的正确姿势

Claude Code 迭代速度很快，建议定期升级。升级方式取决于当初的安装方式。

如果你是用官方安装脚本装的，重新执行一次官方安装命令即可，脚本会覆盖旧版本：

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

如果你是 npm 全局安装，升级命令是：

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

升级后建议执行claude --version确认版本号已经变化。有时候终端里还保留着旧的进程，需要退出重进，不用重启机器。

6.2 卸载与残留清理

想彻底卸载 Claude Code，同样看安装方式。npm 安装的：

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

官方安装脚本装的，直接把安装目录删掉就行：

rm -rf ~/.claude/local

但要注意，~/.claude目录下不仅有程序本体，还有你的登录状态、配置和对话历史。如果你确定以后不再用，可以全部删掉；如果只是暂时卸载，建议只删local子目录，保留登录和配置信息，下次安装后还能继续用。

Windows 上对应的残留目录一般在%USERPROFILE%\.claude和%USERPROFILE%\.claude.json，手动删除前先备份有用的配置。

6.3 常见问题速查表

我把安装和使用阶段最容易踩的问题整理成一张表，方便你直接对号入座。

6.4 最后的几个操作小习惯

写到最后，分享几个我自己的使用习惯。第一，新版本发布后我不急着升级，先看一眼社区反馈，如果没问题再执行升级，毕竟 AI 编程工具这类高频使用的软件，稳定性很影响日常效率。第二，我习惯把常用命令的授权规则写在项目级配置里，而不是全堆在用户级，这样换项目时权限边界更清楚。第三，在使用第三方兼容网关时，我会专门用一个独立的配置目录，避免和日常官方服务混在一起，万一网关出问题不至于影响主工作流。

如果你正准备把 Claude Code 纳入自己的开发工具链，安装只是最不起眼的一步，真正值钱的是后面的授权范围、工作目录规划和日常使用习惯。多花十分钟把环境配好，后面能省下大量反复确认、来回折腾的时间和耐心。