【AI开发工具】Claude Code：安装配置与使用指南（Windows/macOS）

文章目录

• 🚀 Claude Code 安装与使用完整教程（Windows / macOS 新手指南）
  • 📖 一、什么是 Claude Code？
  • 🧰 二、安装前准备
    • 1️⃣ Node.js（必须）
    • 2️⃣ 拥有 Claude 账号
    • 3️⃣ 获取 API Key
  • ⚙️ 三、安装 Claude Code
  • 🔑 四、配置 API Key
    • Windows（PowerShell）
    • macOS / Linux
  • 🚀 五、第一次运行 Claude Code
  • 💻 六、基本使用方式
    • 1️⃣ 让 Claude 分析项目
    • 2️⃣ 修改代码
    • 3️⃣ 生成测试代码
    • 4️⃣ 修复 Bug
  • 🧠 七、推荐开发工作流（强烈建议）

🚀 Claude Code 安装与使用完整教程（Windows / macOS 新手指南）

本文将从 零开始，一步步教你安装 Claude Code。

📖 一、什么是 Claude Code？

Claude Code 是 Anthropic 官方提供的命令行 AI 编程工具，可以让你：

• 在终端直接使用 Claude 写代码
• 分析项目结构
• 自动修改文件
• 生成测试代码
• 调试程序

简单理解：

Claude Code = Claude + 本地项目 + AI 编程助手

类似：

• Cursor（AI IDE）
• Copilot CLI
• ChatGPT CLI

但它更偏 终端开发流。

🧰 二、安装前准备

安装前需要准备以下环境：

1️⃣ Node.js（必须）

Claude Code 通过 npm 安装。

下载地址

👉 https://nodejs.org

推荐版本：

Node.js 18+ 

安装完成后验证：

node -v npm -v 

如果显示版本号说明成功。

2️⃣ 拥有 Claude 账号

需要先注册 Claude 账号。

登录：

https://console.anthropic.com 

3️⃣ 获取 API Key

进入：

Dashboard → API Keys 

创建 Key：

Create Key 

你会得到：

sk-ant-xxxxxxxxxxxxx 

⚙️ 三、安装 Claude Code

打开：

• Windows → PowerShell
• macOS → Terminal

执行：

npminstall -g @anthropic-ai/claude-code 

等待安装完成。

验证安装

claude --version 

如果显示版本号：

claude x.x.x 

说明安装成功 ✅

🔑 四、配置 API Key

需要把 API Key 写入环境变量。

Windows（PowerShell）

setx ANTHROPIC_API_KEY "你的APIKEY"

关闭终端重新打开。

macOS / Linux

exportANTHROPIC_API_KEY="你的APIKEY"

建议写入：

~/.bashrc 

或

~/.zshrc 

🚀 五、第一次运行 Claude Code

进入你的项目目录：

cd your-project 

启动：

claude 

你会看到类似界面：

Claude Code Assistant > 

说明成功 🎉

💻 六、基本使用方式

1️⃣ 让 Claude 分析项目

claude explain 

示例：

Explain this project structure 

2️⃣ 修改代码

claude edit 

例如：

Add login validation 

Claude 会：

• 分析代码
• 修改文件
• 给出变更说明

3️⃣ 生成测试代码

claude generate tests 

可以自动生成：

• 单元测试
• 接口测试
• Mock 数据

4️⃣ 修复 Bug

claude fix 

例如：

Fix null pointer exception 

🧠 七、推荐开发工作流（强烈建议）

一个高效流程：

IDE 写代码 ↓ Claude 分析 ↓ Claude 修改 ↓ Claude 生成测试 ↓ 提交 Git 

建议搭配：

• VS Code
• Git
• Terminal