Claude Code入门,安装配置软件和你的第一个对话

本文是Claude Code系列教程的第2篇，主要讲解如何安装配置Claude Code的运行环境，以及如何开始使用Claude Code。

1.1 安装Claude Code的系统要求

依赖	最低版本	说明
Node.js	18.0+	核心运行环境，建议使用 LTS 稳定版本
npm	8.0+	默认包管理器，用于安装和管理依赖
操作系统	macOS / Linux / Windows WSL	支持主流系统。Windows 用户强烈推荐使用 WSL2（详见下方补充）
Anthropic API Key	—	用于直接调用模型，或者拥有 Claude.ai Pro / Team 订阅账号

为什么 Windows 环境推荐使用 WSL2？

Claude Code 是一个深度依赖类 Unix 环境的命令行工具，它在运行时需要高频调用本地的 Shell 命令、进行文件读写以及权限管理。

原生 Windows (CMD/PowerShell) 的痛点：原生 Windows 终端的文件路径格式（反斜杠 \）、路径大小写不敏感机制以及 POSIX 权限缺失，会导致 Claude Code 在自动扫描项目、执行构建或修改文件时发生兼容性报错。

WSL2 的优势：WSL2（Windows Subsystem for Linux 2）内部拥有一个完整的原生 Linux 内核。在 WSL2 中运行 Claude Code，可以让它完美执行所有 Linux 链路的自动化操作，性能更强且绝无环境兼容问题。

如何安装与使用 WSL2

如果你是 Windows 操作系统且尚未安装 WSL2，在安装 Claude Code 前执行以下步骤：

1. 一键安装 WSL2

以管理员身份打开 Windows PowerShell 或命令提示符（CMD），输入以下命令并回车：

wsl --install

注：该命令会自动启用所需的系统组件，并默认下载安装最新版的 Ubuntu Linux 发行版。

2. 重启电脑

安装完成后，系统会提示你重启计算机以应用更改。

3. 初始化设置

重启后会自动弹出一个 Linux 终端窗口，等待其初始化完成后，根据提示输入你想设置的Linux 用户名（Username）和密码（Password）。

4. 进入 WSL2 环境开发

以后每次开发时，只需在 PowerShell 中输入 wsl 即可一键切入 Linux 环境。

接下来的所有操作（包括安装 Node.js、配置 API Key、运行 Claude Code），都请在WSL2 的 Linux 终端内部进行。

1.2 安装 Claude Code

请在你的终端（Mac/Linux 用户直接打开终端，Windows 用户请进入上述WSL2 终端）中执行以下命令，使用 npm 全局安装 Claude Code 官方客户端：

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

验证安装是否成功（若成功会输出当前版本号）

claude --version

1.3 配置 API Key

你可以根据使用习惯，选择以下任意一种方式配置你的 Anthropic API 密钥。

方式一：临时设置（仅在当前终端窗口/会话中有效，关闭终端后失效）

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"

方式二：永久写入 Shell 配置（推荐，长期有效）

如果你使用的是 Zsh（macOS 默认，或部分自定义 WSL 环境）：

echo'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"' >> ~/.zshrcsource ~/.zshrc

如果你使用的是 Bash（WSL2 Ubuntu 默认环境）：

echo'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"' >> ~/.bashrcsource ~/.bashrc

如果你拥有 Claude.ai Pro 订阅，无需单独购买 API Key。直接使用 claude 命令启动客户端，在提示中选择 "Login with Claude.ai" 进行网页授权登录即可。

1.4 使用国产模型

由于Anthropic对国内环境的限制，你可能无法直接使用Claude的Sonnet、OPUS等模型。

但没有关系，Claude code支持自定义模型配置。你可以使用智谱的GLM-5.1、MiniMax、Deepseek V4等国产模型，他们也提供了非常不错的代码编写能力。

你可以通过第三方中转（后续专门再讲）或国产大模型平台（兼容 OpenAI/Anthropic 协议接口）无缝替代。

这里以GLM-5.1为例，讲解如何配置。首先到GLM官网注册登录账号，然后进入“API平台（https://bigmodel.cn/apikey/platform）”菜单，创建一个API Key：

将API Key配置到Claude Code：

# 1. 设置智谱的 API Keyexport ANTHROPIC_API_KEY="your-zhipu-api-key-xxxxxx"# 2. 修改请求底座地址export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/paas/v4/v1"# 3. 指定替代的目标模型为 GLM-5.1export ANTHROPIC_MODEL="glm-5.1"#（可选）如果你希望长久生效，请将上述三行 echo 追加到你的 ~/.zshrc 或 ~/.bashrc 中：# echo 'export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/paas/v4/v1"' >> ~/.zshrc# echo 'export ANTHROPIC_MODEL="glm-5.1"' >> ~/.zshrc

切换为 GLM-5.1 后，直接运行 claude 即可正常启动，所有对话和代理操作都会自动转发至国产模型进行解析，从而完美避开封杀与网络限制。若想确认当前生效的模型，可在交互模式下输入 /status 查看。

1.5 第一次启动

启动 Claude Code 前，必须先切换到你的目标项目目录，以便 AI 获取正确的上下文。

1. 进入你的项目目录（非常重要，切勿在全局或根目录下直接启动）

cd /path/to/your/project

2. 启动交互模式

claude

启动成功后，终端会显示欢迎信息并进入等待输入状态：

Plaintext✻ Welcome to Claude Code!...>

1.6 第一个对话

进入交互模式后，你可以直接输入自然语言指令来操控 Claude Code：

示例 1：分析项目> 你好！请帮我分析一下当前目录的项目结构

Claude Code 会自动扫描当前目录下的文件与文件夹，并在终端中输出结构树与核心文件分析。

示例 2：创建并写入文件

> 帮我在项目根目录创建一个 hello.py，内容是打印 Hello, Claude Code!

Claude Code 会在后台生成文件，但在实际写入磁盘前，它会向你展示代码差异（Diff）并明确询问是否确认写入。此时输入 y 并回车即可完成创建。

1.7 常用启动参数速查

在终端执行 claude 命令时，可以通过附加参数来控制其行为或进行非交互式单次执行。

携带初始提示词（Prompt）启动并自动提问：

claude "解释一下 main.py 的作用"

非交互模式：执行完该单次指令后直接退出

claude -p "生成一个 hello world"

恢复并继续上一次的对话历史会话

claude --continue

强制指定运行的具体 Claude 模型版本

claude --model claude-opus-4-5

只读模式：允许分析代码，但禁止向本地写入或修改任何文件

claude --no-write

禁用命令执行：禁止 Claude 在本地终端运行任何 Shell 命令

claude --no-shell

1.8 交互模式内置命令

在 claude 交互对话框中，你可以输入以 / 开头的内置指令来管理当前会话：

命令	快捷键 / 触发条件	功能说明
`/help`	—	查看所有可用的内置命令与帮助向导
`/clear`	—	清空当前会话的对话历史记录
`/compact`	—	压缩当前的对话上下文，以便在长对话中节省 Token 消耗
`/status`	—	查看当前的连接状态、模型信息以及累计的费用统计
`/exit`	`Ctrl + C` 或 `Ctrl + D`	退出当前 Claude Code 交互会话并返回原生终端

- END -

请关注本账号，以便第一时间获得后续更新。有什么疑问，也可以在评论区交流。