客户端教程操作教程
Claude Code 安装教程:三种方式与首次配置
Claude Code 的官方安装方式(原生安装脚本 / npm)、系统要求、首次登录流程与国内网络环境下的安装加速方法。

本文目录
直接回答:安装 Claude Code 最简单的方式是官方一键脚本(macOS/Linux:curl -fsSL https://claude.ai/install.sh | bash),或用 npm:npm install -g @anthropic-ai/claude-code。国内环境先让终端走代理再安装,否则会超时。
安装前:先打通终端网络
Claude Code 的下载源与运行时 API 都在海外。安装前确认终端已走代理:
curl -s ipinfo.io
出口显示支持地区即可开始;显示 CN 则先开客户端 TUN 模式或设置环境变量(方法见 Claude Code 网络环境指南)。
三种安装方式
# 方式一:官方脚本(macOS / Linux,推荐)
curl -fsSL https://claude.ai/install.sh | bash
# 方式二:npm(需 Node.js 18+,全平台)
npm install -g @anthropic-ai/claude-code
# 方式三:Windows PowerShell
irm https://claude.ai/install.ps1 | iex
装完执行 claude --version 验证;进入任意项目目录运行 claude 即启动。
首次登录
首次运行会引导浏览器 OAuth:用 Claude 订阅账号授权,或选择 API Key 方式。注意浏览器与终端保持同一网络出口(TUN 模式下天然一致),否则回调会失败。
装好之后
- 连接不稳 / 报错:见Claude Code 连接失败怎么办;
- 节点与分流的最佳实践:见Claude 网络环境指南。
常见问题
安装需要什么前置条件?
macOS / Linux / Windows(WSL 或原生)均可;npm 方式需要 Node.js 18+。终端能访问 anthropic.com 是唯一的网络前提。
安装很慢或超时?
安装脚本与 npm 包都从海外源下载:先让终端走代理(TUN 或环境变量)再安装,速度立刻正常。
装好后用什么账号登录?
Claude Pro/Max 订阅或 Anthropic API Key 二选一。首次运行 claude 命令会引导浏览器完成 OAuth 登录。

