Claude Code 的安装依赖 Node.js 环境，用户需根据操作系统选择对应的安装路径。首次对话可分为三个级别：直接提问（Prompting）、使用专用代理（Agents）和调用具体技能（Skills）。本文将详细拆解每个步骤，并通过 weather-agent 和 weather-fetcher 示例，阐明如何从基础对话过渡到可控、可重复的自动化工作流。
Claude Code 从零开始：Day 0 安装到 Day 1 首次对话
本文是 Claude Code 入门系列的第一篇，旨在引导你完成从环境准备到首次交互的全过程。我们将分为两个阶段：Day 0 专注于在你的机器上安装并验证 Claude Code；Day 1 则带你探索与之对话的三种基本模式，理解其如何从简单提问演进为结构化的代理工程。
Day 0：安装与认证
安装 Claude Code 的前提是拥有一个可用的 Node.js（v18 或更高版本）环境。请根据你的操作系统选择对应的安装指南。
Windows 平台安装
- 安装 Node.js：访问 Node.js 官网，下载 LTS 版本的
.msi安装程序并运行。按照向导提示完成安装。 - 验证 Node.js：打开一个新的 PowerShell 或 Windows Terminal，运行以下命令确认版本：
node --version npm --version - 安装 Claude Code：在终端中执行全局安装命令：
如果遇到权限错误，请尝试以管理员身份运行终端。npm install -g @anthropic-ai/claude-code - 验证安装：运行
claude --version，如果输出版本号，则表示安装成功。
Linux 平台安装
Linux 用户有多种方式安装 Node.js。以下是推荐方法：
方法一：使用 fnm（Fast Node Manager）
这是 Node.js 官方推荐的方式，它速度快、无需 sudo 权限即可安装全局包。
- 访问 Node.js 下载页面，在引导选择器中，将“Package Manager”设置为 fnm。
- 根据页面显示的命令，在终端中执行。典型的步骤包括安装 fnm、重启终端（或
source ~/.bashrc）、然后通过fnm install安装 Node.js。
方法二：使用系统包管理器
对于 Ubuntu/Debian，可以运行 sudo apt update && sudo apt install -y nodejs npm。安装后务必用 node --version 检查版本，确保不低于 v18。
完成 Node.js 安装后，同样通过 npm install -g @anthropic-ai/claude-code 来安装 Claude Code，并使用 claude --version 进行验证。如果在安装时遇到权限问题，可以配置 npm 的全局目录到用户空间，或使用 sudo（对于非 fnm/nvm 的安装方式）。
macOS 平台安装
macOS 用户通常使用 Homebrew 来简化安装流程。
- 检查或安装 Homebrew：在终端中运行
brew --version。如果未安装，请按照官方指南进行安装。 - 安装 Claude Code：执行命令：
brew install --cask claude-code - 验证安装：运行
claude --version。
登录认证
无论使用哪个平台，在完成安装后，首次在终端运行 claude 命令，它会引导你进行认证。主要有两种方式：
- 订阅账户登录：选择“Claude.ai account”，浏览器会打开 Anthropic 的授权页面，登录并授权后即可返回终端使用。
- API Key 登录：选择“Anthropic API Key”。你可以通过团队邀请获取自动生成的 Key，也可以直接粘贴一个已有的
sk-ant-开头的 Key。Key 会被永久保存，后续无需重复输入。
完成认证后，你的 Day 0 设置就全部结束了。更详细的配置（如权限、模型、输出样式）可以在后续通过 Claude Code Settings 完整配置指南 进行深入调整。
Day 1：首次对话与三种使用模式
安装完成后，运行 claude 即进入对话环境。Claude Code 的使用深度可以分为三个级别，从简单的自由提问到高度结构化的代理工作流。
Level 1: Prompting（直接提问）
这是最基础的使用方式，就像给一个知识渊博的朋友发信息。你只需在 claude> 提示符后输入问题，例如：
what is the weather in Karachi?Claude 会给出回答，但其获取信息的方式可能是不可预测的（基于训练数据、搜索网络或进行推测）。这种方式适用于快速的一次性问答，比如询问代码功能、解释错误或进行头脑风暴。然而，其结果不具有一致性，同样的问题可能得到不同来源或格式的答案。
Level 2: Agents（专用代理）
当你需要重复执行某类任务并希望获得一致的结果时，就需要创建代理（Agent）。代理为 Claude 定义了一个明确的角色和任务边界。
以本项目中的 weather-agent 为例。它的职责非常单一：获取迪拜的实时天气。与随意提问相比，代理确保了方法的可预测性。
| 对比维度 | 直接提问 (Prompting) | 使用代理 (Agent) |
|---|---|---|
| 数据来源 | 不确定 | 固定使用 Open-Meteo API |
| 查询地点 | 可能不一致 | 固定为迪拜 (lat: 25.2, lon: 55.3) |
| 结果格式 | 随意 | 固定为“温度 + 单位” |
| 一致性 | 每次可能不同 | 方法与结果高度一致 |
创建代理意味着你对“谁来回答”这个问题进行了控制。代理本身的具体实现（如何获取天气）则由下一级——技能来定义。
Level 3: Skills（具体技能）
技能（Skill） 是代理或其他 Claude 实例可调用的具体能力模块。如果说代理定义了“角色”，那么技能就定义了执行特定任务的“操作手册”。
weather-agent 背后依赖于一个名为 weather-fetcher 的技能。这个技能包含了精确的指令：调用哪个 API 地址、如何解析返回的 JSON 数据、以什么格式输出结果。
将代理和技能分离，实现了关注点的解耦和能力的复用。一个代理可以集成多个技能。例如，一个 daily-report-agent（日报代理）可以同时使用 weather-fetcher（获取天气）、calendar-reader（读取日历）和 email-summarizer（总结邮件）这三个技能来生成综合报告。
三种模式总结
| 级别 | 你控制什么 | 适用场景 |
|---|---|---|
| Prompting | 问题本身 | 快速、一次性的问题 |
| Agents | 问题 + 由谁来回答 | 需要一致方法的重复性任务 |
| Skills | 问题 + 由谁回答 + 具体如何执行 | 关键、复杂、要求精确控制的自动化工作流 |
理解这三个级别是掌握 Claude Code 编排工作流 的基础。从今天起，你可以先从 Level 1 开始练习，熟悉基本交互，再根据需要逐步构建自己的代理和技能。
FAQ
Q: 安装时提示 “permission denied” 怎么办？
A: 在 Linux/macOS 上，如果使用系统自带的 Node.js 安装，全局 npm 包需要 sudo 权限。更优的方案是使用 fnm 或 nvm 来管理 Node.js，这样可以避免权限问题。在 Windows 上，请尝试以管理员身份运行终端。
Q: Level 1 直接提问和 Level 2 使用代理，本质区别是什么？ A: 本质区别在于可预测性。直接提问时，Claude 的回答方式（信息来源、处理逻辑）每次可能不同。使用代理时，你预先定义了它处理特定任务的方法和流程，从而确保每次执行都遵循相同的路径，获得结构一致的结果。
Q: 我必须从 Level 1 开始，不能直接创建代理吗？ A: 可以。级别是描述使用深度的概念，而非强制的线性流程。如果你的任务明确且需要重复执行，完全可以跳过自由提问，直接着手创建代理和技能。但对于初学者，从 Level 1 开始熟悉 Claude Code 的响应和交互方式是一个更平缓的学习曲线。