Claude Code 入门教程：安装、登录、代理设置与第一个任务

很多开发者第一次运行 Claude Code 时，浏览器里的 Claude 网页版明明正常，终端却卡在登录或提示连接失败。原因几乎都是同一个：终端不读取系统代理。这篇教程按「准备 → 安装 → 代理 → 登录 → 第一个任务 → 常见错误」的顺序展开，所有命令可直接复制。网页版与应用的基础使用见Claude 使用指南。

准备工作

项目	要求	检查命令
Node.js	18 或更高版本	node -v
npm	随 Node 安装	npm -v
操作系统	macOS、Linux、Windows（原生或 WSL）	—
账号	Claude Pro / Max 订阅，或 Anthropic API Key	—
终端	macOS / Linux 任意 shell，Windows 推荐 PowerShell 或 WSL	—
网络	终端可通过代理访问 Anthropic 服务	见第二步

登录方式有两种：用 Claude 订阅账号登录（Pro、Max 以及 Team / Enterprise 中启用了 Claude Code 的席位），或者用 API Key 按量计费。两种方式的资格与计费规则以官方说明为准。

第一步：安装

Claude Code 安装只需一条 npm 命令：

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

看到版本号即安装成功。权限报错时不要加 sudo，改用用户级 npm 目录：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

官方还提供不依赖 npm 的原生安装脚本与 Homebrew 等方式，命令以文档页面为准。Windows 用户直接在 PowerShell 中执行 npm 命令即可，也可以在 WSL 里安装以获得更接近 Linux 的体验。

第二步：让终端走代理

这是整篇教程最关键的一步，要在登录之前完成。两种方式二选一。

方式一：环境变量

端口以你客户端的混合端口为准，Clash Verge Rev 默认 7897，其他客户端常见 7890。

# macOS / Linux
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1

# Windows PowerShell
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:NO_PROXY = "localhost,127.0.0.1"

验证代理是否生效：

curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://api.anthropic.com/v1/models

返回 401 或类似状态码且耗时在两秒内，说明代理已生效；长时间无响应或超时，说明没走代理。想永久生效，把 export 行写入 ~/.zshrc 或 ~/.bashrc。

方式二：TUN 模式

在 Clash Verge Rev、Mihomo Party 或 sing-box 中开启 TUN 模式，所有流量在网络层被接管，终端无需任何设置。两种方式不要同时使用，否则排查问题时难以判断是哪一层出了问题。Windows 下的 TUN 设置见Windows 客户端使用指南。

第三步：登录

1. 确认第二步的代理已生效，并且浏览器当前使用的是同一个节点。

2. 进入一个项目目录运行 claude：

   cd your-project
   claude

3. 首次运行会引导选择登录方式。选订阅账号时终端会打开浏览器完成授权，在浏览器里确认后回到终端。

4. 选 API Key 时按提示粘贴，或在运行前提前导出：

   export ANTHROPIC_API_KEY=sk-ant-...
   claude

5. 看到交互界面即登录成功。登录状态会保存在本机，以后直接运行 claude 即可；需要切换账号时在会话里输入 /login。

第四步：常用命令与第一个任务

用法	命令	说明
交互模式	claude	进入对话式界面
单次任务	claude "解释这个仓库的目录结构"	带着任务启动
非交互输出	claude -p "..."	打印结果后退出，适合脚本
初始化项目说明	/init	生成 CLAUDE.md，记录项目约定
查看帮助	/help	列出会话内命令
清空上下文	/clear	开始新任务前使用
环境自检	/doctor	检查安装与配置问题
继续上次会话	claude --continue	恢复上一次对话

推荐的第一个任务是只读的：

claude "阅读这个项目的 README 和目录结构，总结它是做什么的，并指出三个可能的改进点"

Claude Code 会列出读取的文件、给出分析，然后等待你的下一步。修改文件或执行命令前它会请求确认，熟悉之后再考虑放宽权限。

常见错误对照

现象	原因	处理
command not found: claude	全局 bin 目录不在 PATH	把 npm config get prefix 下的 bin 加入 PATH
登录时浏览器打不开回调	浏览器与终端代理出口不一致	统一节点后重新 /login
fetch failed / ETIMEDOUT	终端未走代理	导出代理变量或开启 TUN
任务跑到一半断开	节点丢包或空闲连接被切	换支持长连接的节点
提示所在地区不支持	节点出口地区不受支持	换日本、新加坡、美国等节点
429 速率限制	配额用尽	等待重置或切换 API Key 计费
输出整段突然出现而非逐字	线路缓冲流式响应	换线路类型

与网络相关的错误占绝大多数，Claude 登录问题的分步排查见Claude 无法连接怎么办。Claude Code 对长连接的要求比网页版高得多，选 Claude 稳定机场时参考Claude 稳定机场选择指南，站内测试中 IEPL 线路的宇宙云与 AI 适配向的极连云在长任务场景下记录较好，更多对照见Claude 机场推荐。

小结

Claude Code 的安装只有一条命令，门槛在终端代理与节点稳定。按顺序完成安装、代理、登录和第一个只读任务，就能进入日常使用。Codex CLI 用户可对照Codex CLI 安装与基础使用教程，两者的代理设置思路完全一致。