Claude Code 使用教程 2026：安装、登录与终端代理设置（macOS / Windows）

Claude Code 是什么

Claude Code 是 Anthropic 的命令行工具：在终端里和 Claude 对话，让它直接读写你的代码仓库、运行命令、提交 Git。需要 Claude Pro / Max 订阅或 API Key。

安装

需要 Node.js 18 以上。

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

macOS 也可以用 Homebrew 或官方安装脚本。Windows 建议在 WSL 或 PowerShell 里安装。

安装后在项目目录运行 claude，首次会引导登录。

关键：终端不走系统代理

这是最常见的卡点。Clash Verge 的「系统代理」只对浏览器和部分 GUI 应用生效，终端里的命令行工具默认直连，所以 Claude Code 会连不上 api.anthropic.com。

两种解决方式：

方式一：环境变量代理

在终端里设置（端口以 Clash Verge「设置 → 混合代理端口」为准，默认 7897）：

export https_proxy=http://127.0.0.1:7897
export http_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897

然后再运行 claude。想永久生效，把这三行写进 ~/.zshrc 或 ~/.bashrc。

Windows PowerShell：

$env:https_proxy="http://127.0.0.1:7897"
$env:http_proxy="http://127.0.0.1:7897"

方式二：TUN 模式

Clash Verge「设置 → TUN 模式」打开，所有流量包括终端都被接管，不需要设环境变量。macOS 需要安装系统扩展，Windows 需要管理员运行。

TUN 更省事，环境变量更可控。两种都行。

节点选择

Claude Code 走的是 api.anthropic.com，和网页版一样挑 IP。固定美国或日本节点：

DOMAIN-SUFFIX,anthropic.com,美国节点

登录

运行 claude 后选择登录方式：Claude 账号（需要 Pro / Max）或 API Key（Console 创建）。浏览器会打开授权页，授权后回到终端。

常见报错

Connection refused / ETIMEDOUT：终端没走代理。按上面设置环境变量或开 TUN。

403 / region not supported：节点在不支持的地区。切美国 / 日本。

证书错误：代理软件开了 MitM 或 HTTPS 解密。关掉。

登录后立刻掉线：IP 被标记。换节点。

验证代理是否生效

curl -I https://api.anthropic.com

返回 HTTP 状态码说明通了；超时说明代理没生效。

相关

Codex / Cursor 终端代理设置 · Claude 使用教程 · Clash Verge 教程 · Claude Code 连接失败排查

本文为信息整理与个人经验，不构成购买建议。机场政策与软件界面可能变化，以官方为准。发现过期内容请 联系纠错。