Claude Code 使用教程:安装、登录与终端代理设置(2026)
Claude Code 从零上手教程:官方安装命令、账号登录方式、在项目中开始使用,以及终端代理、TUN 模式与环境变量设置,解决连接失败与长任务中断问题。
Claude Code 是在终端里运行的 AI 编程工具。用官方命令安装后,在项目目录输入 claude 启动并按提示登录。国内使用的关键是让终端走代理:开启代理客户端的 TUN 模式,或设置 HTTPS_PROXY 环境变量,节点选美国并固定。
核心结论
- 用官方安装命令安装,在项目目录输入 claude 启动
- 登录可使用 Claude 订阅账号或 Anthropic Console 账号
- 终端默认不走系统代理,必须开 TUN 模式或设置环境变量
- 长任务需要稳定线路,建议 IEPL / IPLC 专线节点
Claude Code 是什么
Claude Code 是 Anthropic 推出的命令行 AI 编程工具。它在终端里运行,可以直接读取你的项目代码、修改文件、运行命令和测试,适合让 AI 完成完整的编程任务,而不只是回答问题。
开始前请先确认:
- 已经能正常使用 Claude 网页版,见 Claude 使用教程;
- 代理客户端支持 TUN 模式,推荐 Clash Verge Rev;
- 有 Claude 付费订阅账号(Pro、Max、Team 或 Enterprise),或 Anthropic Console 账号。免费版不包含 Claude Code。
下载与安装
命令行 · macOS / Linux / WSL — 官方推荐
curl -fsSL https://claude.ai/install.sh | bash 命令行 · Windows PowerShell — 官方推荐
irm https://claude.ai/install.ps1 | iex 命令行 · Homebrew(macOS)
brew install --cask claude-code 命令行 · npm — 需要 Node.js 22 或更高版本,不要加 sudo
npm install -g @anthropic-ai/claude-code 以上均为 Anthropic 官方渠道。不要从网盘、论坛或搜索广告下载“破解版”“加速版”安装包。 官方支持地区列表。
官方推荐使用上面的原生安装命令,按你的系统选一条即可;npm 方式需要 Node.js 22 或更高版本。安装前先开启代理,否则下载可能失败。安装完成后确认版本:
claude --version
登录与开始使用
- 进入你的项目目录:
cd 你的项目路径; - 输入
claude启动; - 首次启动会提示登录,选择用 Claude 订阅账号或 Console 账号,按提示在浏览器里完成授权;
- 登录后直接用中文描述任务,例如“帮我看看这个项目的结构,然后给登录页加上表单校验”。
终端代理设置(国内使用关键)
方式一:开启 TUN 模式(推荐)
在 Clash Verge Rev 的设置里开启 TUN 模式,它会接管系统全部流量,终端、编辑器都会自动走代理,一次设置长期有效。
方式二:设置环境变量
端口以代理客户端实际显示为准,Clash Verge Rev 默认常见为 7897:
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
写入 ~/.zshrc 或 ~/.bashrc 后重新打开终端即可长期生效。
验证终端是否走代理
curl -I https://api.anthropic.com
能返回 HTTP 状态码,说明终端已经走代理。
节点与线路建议
- 节点:美国原生 IP 首选,全程固定,不要让客户端自动切换;
- 线路:一次任务可能持续几十分钟,中转线路在晚高峰的抖动容易让任务中断,建议使用 IEPL / IPLC 专线节点,原因见 IEPL 和 IPLC 有什么区别。
常见问题
登录时浏览器授权后,终端一直等待
授权回调需要终端能访问 Anthropic 服务。确认 TUN 模式或环境变量已生效,再重新执行 claude 登录。
任务执行到一半断开
多数是晚高峰线路抖动。换到专线节点,或避开晚高峰执行长任务。
常见问题
Claude Code 需要付费吗?
需要。Claude 免费版不包含 Claude Code,可以用 Pro、Max、Team、Enterprise 订阅账号登录,也可以用 Anthropic Console 账号按 API 用量计费。
Claude Code 提示网络错误或连接超时怎么办?
先在终端执行 curl -I https://api.anthropic.com,看终端是否走了代理。不通就开启代理客户端的 TUN 模式,或设置 HTTPS_PROXY 环境变量。
浏览器里 Claude 能用,为什么 Claude Code 连不上?
浏览器走的是系统代理,而终端程序默认不读取系统代理设置,所以需要 TUN 模式或环境变量让终端也走代理。