Claude Code 怎么使用:安装、登录、基本命令与国内用户的网络配置
Claude Code 使用教程覆盖 Node.js 环境准备、npm 安装、登录方式(订阅账号或 API 密钥)、在项目目录中启动与常用交互方式,以及国内用户必须先完成的终端代理配置。
步骤概览
- 配置终端代理 设置 HTTPS_PROXY 环境变量或开启 TUN 模式。
- 安装 Node.js 安装 Node.js 18 或更高版本。
- 安装 Claude Code 执行 npm install -g @anthropic-ai/claude-code。
- 登录 在项目目录执行 claude,按提示在浏览器完成登录。
- 开始使用 用自然语言描述任务,Claude Code 会读取代码并执行修改。
Claude Code 是在终端中运行的 AI 编程工具,能读取代码仓库、修改文件、运行命令。安装本身只需一条命令,国内用户的关键是先把终端代理配好。
第零步:终端代理
安装、登录、运行都需要访问 Anthropic 与 npm 的海外服务器。终端不走系统代理,先做以下任一项:
- 设置环境变量:
export HTTPS_PROXY=http://127.0.0.1:7897(端口以客户端为准) - 或开启客户端 TUN 模式
详细说明见 Claude Code 网络环境。
第一步:安装 Node.js
Claude Code 基于 Node.js,需要 18 或更高版本。从 nodejs.org 下载安装,或用 nvm 管理版本。安装后验证:
node -v
npm -v
第二步:安装 Claude Code
npm install -g @anthropic-ai/claude-code
安装卡住不动,几乎都是代理没生效。确认环境变量后重试。
第三步:登录
进入任意项目目录,执行:
claude
首次运行会提示登录,两种方式:
- Claude 订阅账号: 按提示打开浏览器完成授权。浏览器与终端必须用同一个节点。
- API 密钥: 在 Anthropic Console 创建密钥,设置环境变量
ANTHROPIC_API_KEY。
登录失败多为浏览器与终端出口不一致,或节点地区不支持,见 Claude Code 连接失败。
基本使用
启动后直接用自然语言描述任务:
- 「解释这个项目的目录结构」
- 「修复 src/utils 里的类型错误」
- 「为这个函数写单元测试」
Claude Code 会读取相关文件、提出修改方案、执行后展示差异。常用操作:
/help:查看命令列表/clear:清空当前对话上下文Esc:中断当前任务Ctrl+C两次:退出
长任务的网络要求
一个复杂任务可能持续几十分钟,期间连接保持打开。需要:专线节点、固定不切换、避免负载均衡策略组。中途断开的排查见 Claude Code 连接失败,适合的服务见 Claude 机场推荐。
与其他开发工具的关系
Codex CLI、Cursor、Copilot 的网络配置逻辑相同,可以共用一套 TUN 加固定节点的方案,见 AI 开发工具网络环境。