Claude Code详细安装及使用教程（Claude Pro官方订阅版）

背景：Claude Code 是 Anthropic 推出的 AI 编程助手，直接运行在你的终端里。它能读取整个代码库、编辑多个文件、运行命令、做 Git 操作——所有功能都通过自然语言交互完成。相比浏览器里的 Claude 聊天，Claude Code 直接在你的真实开发环境中工作。

一、使用前提条件

1、需开通官方Claude Pro订阅（最低20$/月）

2、需具备网络代理条件（国内无法直接访问Claude官网）

二、安装VSCode插件

1、打开 VSCode，进入扩展市场（快捷键 Ctrl+Shift+X）

2、搜索 ‌“Claude Code”‌，确保选择 ‌Anthropic 官方发布‌ 的插件

3、点击 ‌Install‌，安装完成后重启 VSCode

三、安装 Claude Code CLI（命令行工具）

1、 Claude Code 基于 Node.js，需先确保环境就绪：

（1）安装 Node.js（≥18）‌：Node.js 官网（推荐 LTS 版本）‌23

（2）安装 Git‌（用于部分依赖）：Git 官网 ‌

（3）打开终端（如 PowerShell 或 CMD）执行：

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

（4）验证安装：

claude --version

2、国内虽有代理，但官方包仍需通过代理访问，确保代理已正确配置（如设置 HTTP_PROXY/HTTPS_PROXY 环境变量）‌，在 PowerShell 中输入以下命令，查看是否已经有代理设置：

echo $env:HTTP_PROXY
echo $env:HTTPS_PROXY

   如果有输出（例如 http://127.0.0.1:7890），说明已配置。如果无输出，说明未配置，需要手动设置。

3、环境变量配置，按 Win + X，选择“系统”，点击“高级系统设置”，点击“环境变量”，在“用户变量”区域点击“新建”，添加：变量名：HTTP_PROXY，变量值：http://127.0.0.1:7890；变量名：HTTPS_PROXY，变量值：http://127.0.0.1:7890；重要： 配置完后，必须重启所有 PowerShell 窗口才能生效

四、配置认证（绕过登录验证）

1、已订阅 Claude Pro，需通过配置文件跳过首次登录流程：

找到或创建配置文件：Windows 路径：C:\Users\<你的用户名>\.claude.json，编辑该文件，添加以下内容：

{
  "hasCompletedOnboarding": true
}

保存后，再次运行 claude，应直接进入对话界面，不再提示登录

2、如果直接使用 Pro 账号权限（非中转），可设置环境变量（需配合代理），并保存为 ~/.claude/settings.json

{
  "ANTHROPIC_AUTH_TOKEN": "your_pro_api_key",
  "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
}

五、启用 VSCode 与 CLI 的双向联动‌

1、打开VSCode ，点击claude图标，需要输入：/login，通过官网登录授权，授权后就可以正常使用Claude

2、通过powershell启动Claude，可直接使用，无需重新登录授权

注意：使用Claude过程中需要开启代理

Claude Code 官方文档：<https://code.claude.com/docs/en/overview>

VSCode 扩展使用指南：<https://code.claude.com/docs/en/vs-code>

快速开始：<https://code.claude.com/docs/en/quickstart>

常见工作流：<https://code.claude.com/docs/en/common-workflows>

最佳实践：<https://code.claude.com/docs/en/best-practices>