Claude Code 怎么使用:安装、登录、基本命令与国内用户的网络配置

Claude Code 使用教程覆盖 Node.js 环境准备、npm 安装、登录方式(订阅账号或 API 密钥)、在项目目录中启动与常用交互方式,以及国内用户必须先完成的终端代理配置。

机场导航编辑部 发布 更新 约 3 分钟
Claude Code 怎么使用:安装、登录、基本命令与国内用户的网络配置 封面图
步骤概览
  1. 配置终端代理 设置 HTTPS_PROXY 环境变量或开启 TUN 模式。
  2. 安装 Node.js 安装 Node.js 18 或更高版本。
  3. 安装 Claude Code 执行 npm install -g @anthropic-ai/claude-code。
  4. 登录 在项目目录执行 claude,按提示在浏览器完成登录。
  5. 开始使用 用自然语言描述任务,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 开发工具网络环境