Claude Code 安装与网络配置教程：Windows、macOS、Linux 全流程

Claude Code 是 Anthropic 推出的终端 AI 编程工具：你在项目目录里用自然语言描述任务，它会阅读代码、执行命令、修改文件并解释结果。对国内开发者来说，安装和使用中 90% 的问题都与终端网络有关，所以本教程先解决网络，再讲安装。

准备工作

• 一个 Claude Pro / Max 订阅，或 Anthropic API（Console）账号；
• 支持地区的稳定节点（美国、日本、新加坡、台湾等，不能是香港），见 Claude 稳定机场选择指南；
• macOS 10.15+、主流 Linux 发行版、Windows 10/11 或 WSL2。

第一步：让终端能访问海外网络

即使浏览器能打开 claude.ai，终端也不一定能。二选一：

方式 A：开启 TUN 模式（推荐）。在 Clash Verge Rev 中开启“虚拟网卡模式”，所有程序自动走代理。

方式 B：设置环境变量。在当前终端执行（端口以你的客户端为准，Clash Verge Rev 默认 7897）：

export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897

Windows PowerShell：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY  = "http://127.0.0.1:7897"

验证：curl -I https://api.anthropic.com 能返回 HTTP 状态码即可。

第二步：安装 Claude Code

macOS / Linux / WSL

官方原生安装器：

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

或使用 npm（需要 Node.js 18+）：

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

Windows

1. 先安装 Git for Windows（Claude Code 在 Windows 上需要 Git Bash）；
2. 在 PowerShell 中运行官方安装脚本：

irm https://claude.ai/install.ps1 | iex

也可以使用 npm install -g @anthropic-ai/claude-code。如果你习惯 Linux 环境，也可以在 WSL2 中按 Linux 方式安装。

安装完成后运行 claude --version 确认安装成功，运行 claude doctor 可以检查安装状态。

第三步：登录

进入你的项目目录，运行：

cd your-project
claude

首次运行会提示选择登录方式：

• Claude 账号：使用 Pro / Max 订阅额度；
• Anthropic Console：使用 API 按量计费。

选择后会打开浏览器完成授权。浏览器端同样需要支持地区的节点，建议与终端使用同一个节点。

让 Claude Code 走代理

每次手动 export 很麻烦。Claude Code 支持在设置文件中配置环境变量，编辑 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）：

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:7897",
    "HTTP_PROXY": "http://127.0.0.1:7897",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

这样 Claude Code 启动时会自动使用代理，不影响终端里的其他程序。如果你已经开启 TUN 模式，可以不配置这一项。

第四步：初始化项目

在 Claude Code 中输入 /init，它会分析项目并生成 CLAUDE.md。这个文件相当于项目的“说明书”，可以写入：

• 项目结构与技术栈；
• 构建、测试、代码风格命令；
• 需要遵守的约定（例如“不要修改 generated 目录”）。

Claude Code 每次启动都会读取它，回答会更贴合你的项目。

常用命令速查

命令	作用
/help	查看所有命令
/init	生成 CLAUDE.md
/clear	清空当前对话上下文
/compact	压缩长对话，节省上下文
/model	切换模型
/login、/logout	切换账号
/permissions	管理工具权限

常见网络错误

现象	原因	处理
安装脚本卡住或超时	终端未走代理	先完成第一步
登录后报地区不支持	节点在香港等地区	换支持地区节点
运行中 Connection error、超时	节点丢包或切换	固定节点、换线路
浏览器授权后终端无响应	本地回调被代理	设置 NO_PROXY=localhost,127.0.0.1
证书错误	企业网络 HTTPS 拦截	按官方企业网络文档配置证书

更完整的排查见 Claude 连接失败排查清单。

下一步

• 想比较 Claude Code 和 Codex？见 Codex 与 Claude Code 对比；
• 开发环境的 Git、npm、Docker 代理配置，见 AI 开发者网络。