零基础教程：5步在你的电脑上安装Claude Code编程助手

前言

2026年的AI编程工具已经相当成熟。Claude Code（Anthropic官方出品，13.5万Star）让你在终端里直接用自然语言写代码、改bug、重构项目。本教程面向零基础用户，手把手带你完成安装和第一个任务。

所需条件：一台联网的电脑（Windows/Mac/Linux均可）、一个Anthropic账号、15分钟时间。

第一步：安装 Node.js 环境

Claude Code基于Node.js运行，先确认你的环境：

Step 1: 打开终端

– Windows: 按 `Win+R`，输入 `cmd`，回车

– Mac: 打开 “终端” 应用（在”启动台→其他”里）

– Linux: 直接打开终端

Step 2: 检查Node.js是否已安装

node --version

如果显示版本号（如 `v20.x`），跳到第二步。如果显示”command not found”，继续下面的安装：

Step 3: 安装Node.js

# Mac/Linux 用户（推荐用 nvm）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 关闭并重新打开终端，然后：
nvm install 22
nvm use 22

# Windows 用户
# 访问 https://nodejs.org → 下载 LTS 版本 → 双击安装

验证安装成功：`node –version` 应该输出版本号。

第二步：安装 Claude Code

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

这一步会把Claude Code安装为全局命令。安装完成后验证：

claude --version

第三步：配置 API 密钥

Claude Code 需要 Anthropic API 密钥才能工作。

Step 1: 登录 [console.anthropic.com](https://console.anthropic.com)，进入 “API Keys” 页面，点击 “Create Key”，复制生成的密钥（以 `sk-ant-` 开头）。

Step 2: 在终端中配置：

# 设置环境变量（Mac/Linux）
export ANTHROPIC_API_KEY="sk-ant-your-key-here"

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY="sk-ant-your-key-here"

建议将这一行加到你的 `~/.bashrc` 或 `~/.zshrc` 文件中，避免每次打开终端都要重新设置。

第四步：第一次使用 Claude Code

进入一个测试目录，启动Claude Code：

mkdir ~/claude-test
cd ~/claude-test
claude

你会看到一个交互式界面，直接输入你的第一个任务：

创建一个名为 hello.py 的文件，写一个简单的Flask web应用，
访问 / 时返回 "Hello, Claude Code!"

Claude Code会自动创建文件、写代码、甚至告诉你如何运行。

第五步：进阶技巧

技巧1：直接用自然语言修改代码

帮我看看 hello.py 有什么可以优化的地方

技巧2：让AI理解整个项目

claude "分析这个项目的文件结构，给我一个概览"

技巧3：设置预算限额

# 每次对话最多花费$5
claude --max-turns 25

# 或者设置总预算
export CLAUDE_CODE_MAX_COST=20

常见问题

Q: 收费吗？ A: Claude Code本身免费，但需要API费用。Sonnet 5目前$2/$10每百万token输入/输出，日常使用一个月通常只要几美元。

Q: 安全吗？ A: 代码通过API发送给Anthropic处理。如果处理敏感代码，建议等待后续教程——教你用本地模型替代。

Q: 和GitHub Copilot有什么区别？ A: Copilot在IDE里的代码补全更强，Claude Code在终端里的多文件重构和项目级理解更强。两者可以配合使用。

实际演示：完成第一个完整任务

让我们做一个小实战来验证环境是否正确。打开Claude Code后，输入：

我要创建一个简单的Python天气查询命令行工具。
要求：
1. 能从命令行接收城市名称参数
2. 用 requests 库调用 OpenWeatherMap API
3. 格式化输出温度、湿度、天气描述
4. 处理网络错误和城市不存在的情况
5. 包含 README.md 说明文档

Claude Code会依次执行以下操作：

1. 创建项目文件结构（`weather.py`、`README.md`、`requirements.txt`）

2. 编写完整的天气查询代码（包括错误处理）

3. 写README文档

4. 提示你需要配置API密钥

整个过程约2-3分钟，你不需要写一行代码。这就是AI编程助手的核心价值——用自然语言驱动开发。

常见问题补充

Q: 可以在公司项目里用吗？ A: 技术上完全可以，但建议先确认公司安全政策。如果要处理敏感代码，可以使用Claude Code的”Session Privacy”模式（`claude –private`），该模式下代码不会用于模型训练。

Q: Windows上能用吗？ A: 完全支持。通过WSL（Windows Subsystem for Linux）体验最佳，直接在PowerShell或CMD中也能运行。推荐安装Windows Terminal以获得更好的显示效果。

Q: 断网时能用吗？ A: Claude Code需要联网调用API。如果需要离线使用，建议安装Ollama（本教程后续会出单独教程）配合本地开源模型，如DeepSeek V4 Pro或GLM-5.2。

下一步进阶路线

学完本教程后，建议按以下路线继续：

1. 学习编写 `.claude/settings.json` — 自定义行为规则和项目约定

2. 探索 `/memory` 功能 — 让AI记住你的代码偏好和项目上下文

3. 尝试多文件重构 — 给它一个需要跨5个文件修改的任务

4. 集成Git工作流 — 让AI帮你写commit message、创建PR描述