NEXT AI EDITORIAL
Claude Code 安装教程（2026）：Windows、macOS、Linux 配置与登录
Claude Code 怎么安装？本文按 Anthropic 当前官方方案说明 Windows PowerShell、WinGet、macOS、Linux 与 WSL 安装，包含登录方式、首次运行、更新和常见报错排查。
文章目录
一、先选使用方式：CLI、桌面端还是网页版
| 方式 | 适合谁 | 是否安装 | 特点 |
|---|---|---|---|
| Claude Code CLI | 开发者、终端和仓库工作流 | 需要 | 可读写项目、运行命令、处理 Git |
| Claude 桌面端 | 偏好图形界面、刚接触终端 | 需要 | Windows / macOS 上手更直观 |
| Claude Code on the web | 希望从浏览器发起 GitHub 任务 | 通常不需要本地安装 | 需要连接仓库并配置环境 |
| IDE 集成 | 在编辑器里工作 | 通常先安装 Claude Code | 与终端会话和代码上下文联动 |
结论 · 本文默认路线
想完整体验 Claude Code 的仓库能力，优先装官方 CLI；完全不想使用终端时，再选桌面端或网页版。
二、安装前检查与官方入口
- 只从 claude.com、code.claude.com、docs.anthropic.com 或官方 GitHub 仓库获取安装信息。
- Windows 10/11 可原生安装；Git for Windows 有助于 Claude Code 使用 Bash 工具，WSL 方案也受支持。
- macOS、Linux 与 WSL 可使用官方原生安装脚本；原生版本无需另外用 npm 全局安装。
- 需要能访问 Anthropic 的认证与服务端点；企业网络可能需要管理员放行代理或防火墙。
- 准备一个可登录的 Claude 账号、Anthropic Console 账单账户，或企业提供的 Bedrock / Vertex 等环境。
注意 · 不要混装
原生安装、旧版 npm 全局安装和历史本地安装同时存在时，可能出现版本不一致。安装前可用 where.exe claude（Windows）或 which -a claude（macOS / Linux）检查。
三、Windows 安装：PowerShell 与 WinGet
方法 A：官方 PowerShell 原生安装器（推荐）
irm https://claude.ai/install.ps1 | iex在 PowerShell 中运行官方命令。安装完成后关闭并重新打开终端，再检查版本和诊断状态：
claude --version
claude doctor方法 B：使用 WinGet
winget install Anthropic.ClaudeCodeWinGet 安装不会像官方原生安装器那样自动更新，后续可用 winget upgrade Anthropic.ClaudeCode 更新。若命令提示找不到 claude，先重开终端，再检查 %USERPROFILE%\.local\bin 是否进入 PATH。
提示 · Git Bash 说明
原生 Windows 建议安装 Git for Windows。使用便携版 Git 时，可按官方文档设置 CLAUDE_CODE_GIT_BASH_PATH 指向 bash.exe；WSL 环境则无需依赖 Windows Git。
四、macOS、Linux 与 WSL 安装
官方原生安装器（推荐）
curl -fsSL https://claude.ai/install.sh | bash安装结束后重新打开终端，运行 claude --version 与 claude doctor。原生安装器会在后台检查更新，通常不需要手动维护 npm 包。
macOS 使用 Homebrew
brew install --cask claude-codeHomebrew 稳定通道通常会晚于最新发布，并且不会自动更新；后续使用 brew upgrade claude-code。若你以前用 npm 安装过，先确认 PATH 中没有重复的 claude 二进制。
注意 · 旧版 npm 教程
npm install -g @anthropic-ai/claude-code 仍可能出现在旧教程中，但官方当前优先推荐原生安装。不要为了修权限问题使用 sudo npm install -g。
五、登录方式与费用来源
| 登录方式 | 费用从哪里扣 | 适合场景 |
|---|---|---|
| Claude 个人方案账号 | Pro / Max 等方案包含的 Claude Code 用量 | 个人日常开发 |
| Anthropic Console | API 账户按量计费或预付余额 | 开发者、独立项目 |
| 企业 Claude 账号 | 组织分配的用量池 | 公司统一管理 |
| Amazon Bedrock / Google Vertex 等 | 对应云平台账户 | 企业云与合规环境 |
第一次在项目目录运行 claude 时，根据提示选择与你实际账户一致的登录方式。Claude 网页订阅和 Console API 账单不是同一套计费来源；不要在不清楚费用归属时随意粘贴第三方 API Key。
结论 · 先确认费用从哪里扣
Claude Code 可以使用个人 Claude 方案、Console API 或企业云账户等不同计费来源。登录前先确认要使用哪一个账户，避免把个人订阅和 API 账单混为一谈。
红线 · 账号安全
OAuth 登录应在 Anthropic 官方页面完成。任何第三方教程、群聊或远程协助如果索要 Claude 密码、邮箱验证码、恢复码或完整 API Key，都应立即停止。
六、第一次在项目里运行 Claude Code
cd 你的项目目录
claude首次进入仓库后，不要立刻让工具大范围改代码。先让它阅读项目说明、查看 Git 状态并解释结构，再从一个可验证的小任务开始。
- 确认当前目录就是目标仓库，并先提交或备份已有改动。
- 先问“请只读取项目并说明结构，不要修改文件”。
- 让 Claude Code 给出计划，核对将要修改的文件和测试方式。
- 执行一个小改动后查看 git diff，再运行项目自己的测试。
- 确认结果正确后再继续下一项，不把密钥、生产数据或个人信息写进提示。
| 常用命令 | 用途 |
|---|---|
| claude | 启动交互会话 |
| claude -c | 继续最近一次会话 |
| claude -p "问题" | 一次性输出结果后退出 |
| claude update | 手动更新原生安装 |
| claude doctor | 检查安装类型和环境问题 |
七、常见安装与登录报错排查
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
| claude 不是内部或外部命令 | 终端是否重开、PATH、安装目录 | 检查 %USERPROFILE%\.local\bin\claude.exe 或 ~/.local/bin/claude |
| 版本反复变化 | 是否存在多个安装 | 用 where.exe / which -a 找出重复版本，只保留一种 |
| 安装下载超时 | 企业代理、防火墙、DNS 和 TLS | 确认 downloads.claude.ai 可访问，按官方代理文档配置 |
| Windows 无法调用 Bash | Git for Windows 或 WSL | 安装 Git，或设置官方 Git Bash 路径变量 |
| 登录后仍提示额度或账单 | 登录方式是否选错 | 区分个人方案、Console API 与企业用量 |
| npm 权限错误 | 是否仍在使用旧 npm 安装 | 迁移到原生安装，不要用 sudo 强行安装 |
where.exe claude
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"如果仍无法解决，记录操作系统、安装方式、claude --version、claude doctor 输出和完整错误信息，再对照官方故障排查页。日志中如含 Token、邮箱或项目路径，提交前先脱敏。
八、安装完成后的安全清单
- 确认下载和登录域名属于 Anthropic 官方域名。
- 让 Claude Code 先读后改，重要仓库先检查 Git 状态。
- 不要把 .env、API Key、数据库备份或生产凭据直接粘贴进会话。
- 只授予任务需要的工具和目录权限，完成后复核 git diff。
- 使用项目已有的测试、类型检查和构建命令验证修改。
- 遇到第三方“国内一键包”时先核对来源、安装脚本和凭据去向。
结论 · 完成标准
claude --version 能输出版本、claude doctor 无关键错误、能在测试项目中启动并完成一次只读问答，就说明基础安装和登录已经跑通。
资料来源与核验说明
本文由 NEXT AI 编辑团队依据下列官方公开页面整理。功能、价格、方案名称和可用地区可能调整，请以官方页面及你账号内当日显示的信息为准。
常见问题
Claude Code 必须安装 Node.js 吗？
使用当前官方推荐的原生安装器时不需要为了 Claude Code 单独安装 Node.js。旧版 npm 全局安装才依赖 Node，并容易与原生版本混装。
Windows 能直接安装 Claude Code 吗？
可以。Windows 10/11 可使用官方 PowerShell 安装器或 WinGet；Git for Windows 有助于 Bash 工具运行，也可以选择 WSL。
Claude Pro 能用 Claude Code 吗？
Anthropic 当前个人方案说明中，Pro 和 Max 可通过 Claude 账号使用 Claude Code；具体用量和可见功能以账号页面为准。
Claude Code 和 Claude API 是一回事吗？
不是。Claude Code 是编程工具；使用 Console API 登录时会按 API 账户计费，使用个人或企业方案登录时则消耗对应方案的用量。
安装后提示找不到 claude 怎么办？
先重开终端，再检查 PATH 和安装目录。Windows 可用 where.exe claude；macOS / Linux 可用 which -a claude。
Claude Code 怎么更新？
官方原生安装通常自动更新，也可运行 claude update；Homebrew 或 WinGet 安装需要使用各自的 upgrade 命令。
国内使用时登录失败怎么办？
先确认所在地区和网络环境符合 Anthropic 的可用性要求，再检查企业代理、防火墙、DNS 与账户登录方式；不要使用来源不明的代理脚本或共享密钥。
已经决定订阅，但没有海外支付方式？
如果你已经根据本文确认了所需方案，而官方结算受银行卡或支付地区限制，可以查看本站代充服务。购买前请先核对账号归属、交付方式、所需资料和质保范围。