客户端教程操作教程

Claude Code 安装教程:三种方式与首次配置

Claude Code 的官方安装方式(原生安装脚本 / npm)、系统要求、首次登录流程与国内网络环境下的安装加速方法。

Claude Code 安装教程:三种方式与首次配置的网络技术概念插图
梯子k原创概念插图
本文目录

直接回答:安装 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 模式下天然一致),否则回调会失败。

装好之后

常见问题

安装需要什么前置条件?

macOS / Linux / Windows(WSL 或原生)均可;npm 方式需要 Node.js 18+。终端能访问 anthropic.com 是唯一的网络前提。

安装很慢或超时?

安装脚本与 npm 包都从海外源下载:先让终端走代理(TUN 或环境变量)再安装,速度立刻正常。

装好后用什么账号登录?

Claude Pro/Max 订阅或 Anthropic API Key 二选一。首次运行 claude 命令会引导浏览器完成 OAuth 登录。

所属专题AI 工具与网络