第01章：环境安装与第一次成功

背景知识：你真的需要装哪些？

Claude Code CLI 在终端中运行的界面

新手最容易被"装一堆东西"吓到。先记住这一句：Claude Code 官方只要求 Node.js（18+），Python 不属于必装项。

• Node.js（必装）：Claude Code CLI 本身是 Node.js 程序，没装 Node 就跑不起来。
• Claude Code CLI（必装）：你要用的命令行工具本体。
• API Key（必装）：连接模型服务的“钥匙”。没有它，Claude Code 不能回答你。
• Python（可选）：只有当你要跑 Python 脚本/做 Excel 清洗时才需要；不装也能先把 Claude Code 学会、跑通。

第0步（可选）：安装 Python（做 Excel/脚本时）

为什么需要 Python？

• 当你要做 Excel 清洗、跑数据脚本时，Claude Code 经常会让你运行 Python
• 如果你现在只想先把 Claude Code 跑通，这一步可以先跳过

python --version

# 1. 打开"终端"应用（在"应用程序 > 实用工具"中）

# 2. 检查是否已安装 Python
python3 --version

# 3. 如果没有或版本过低，使用 Homebrew 安装
# 先安装 Homebrew（如果没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 然后安装 Python
brew install python

# 4. 验证
python3 --version

第1步：安装 Node.js（10分钟）

在终端中安装和验证 Node.js

为什么需要 Node.js？

• Claude Code CLI 是用 Node.js 编写的
• 必须先安装 Node.js 才能运行 Claude Code
• 官方要求 Node.js 18+（推荐安装 LTS 版本）

node --version
npm --version

Mac 用户安装步骤

Mac 安装：两种方式任选其一

🍺

方式一：Homebrew（推荐） 最简单

如果你已经安装了 Homebrew，一条命令即可安装：

bash 复制代码

brew install node

安装完成后运行 node --version 验证

📦

方式二：官网下载安装包 可视化

如果你不熟悉命令行，可以从官网下载安装包：

1

访问官网

打开 nodejs.org

2

选择 LTS 版本

找到 LTS 推荐版本的 Mac Installer 按钮

3

安装

下载完成后双击 .pkg 文件，按提示安装

验证安装

无论用哪种方式安装，都可以用以下命令验证：

bash 复制代码

node --version
npm --version

成功标志：能看到 node、npm、claude 的版本号（示意图）

成功标志：能看到 node、npm、claude 的版本号（示意图）

如果分别显示版本号，说明安装成功。

第2步：安装 Claude Code CLI（5分钟）

安装命令

打开命令行（Windows 用 CMD/PowerShell，Mac 用终端），输入：

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

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

验证安装

claude --version

claude --version

如果显示版本号（如 claude-code version 2.1.15），说明安装成功。

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

# 查看当前源
npm config get registry

# 切换到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g @anthropic-ai/claude-code

# 查看当前源
npm config get registry

# 切换到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g @anthropic-ai/claude-code

# 查看全局安装路径
npm config get prefix

# 查看全局安装路径
npm config get prefix

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

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

第3步：配置 API（10分钟）

Claude Code 需要连接 AI 服务才能工作。我们推荐使用国内的服务：

方式一：智谱 AI（推荐新手）

步骤1：注册账号

1. 访问 智谱AI开放平台
2. 点击右上角"注册"按钮
3. 使用手机号注册（需要验证码）
4. 实名认证（根据要求，可能需要）

步骤2：获取 API Key

1. 登录后，点击右上角头像
2. 选择 "API Key 管理"
3. 点击 "创建新的 API Key"
4. 设置一个名称（如 "Claude Code"）
5. 重要：复制并保存 这个 Key，只显示一次！

步骤3：用智谱官方“一键安装助手”（推荐）

智谱官方提供了一个向导工具，可以一步一步帮你把 Claude Code 的配置写好（适合新手，不容易漏步骤）。

npx @z_ai/coding-helper

npx @z_ai/coding-helper

1. 按提示选择 Claude Code / Anthropic 兼容配置
2. 选择服务商：智谱（GLM）
3. 粘贴你的智谱 API Key
4. 向导会自动写入配置，并提示你如何验证

步骤4：了解一下它到底改了什么（可选）

向导通常会把配置写到 ~/.claude/settings.json（Windows 也在你的用户目录下）。核心就是这几项：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的智谱API-Key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

临时手动配置（只在当前终端生效，了解即可）

如果你想“快速试一下”，也可以先用环境变量临时跑通：

# Windows PowerShell（替换为你的智谱 Key）
$env:ANTHROPIC_AUTH_TOKEN="你的智谱API-Key"
$env:ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
$env:API_TIMEOUT_MS="3000000"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

REM Windows CMD（替换为你的智谱 Key；只在本窗口生效）
set ANTHROPIC_AUTH_TOKEN=你的智谱API-Key
set ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
set API_TIMEOUT_MS=3000000
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Mac/Linux（替换为你的智谱 Key）
export ANTHROPIC_AUTH_TOKEN="你的智谱API-Key"
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export API_TIMEOUT_MS="3000000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

永久配置（推荐：一次配置，之后不用每次都粘贴 Key）

方式二：DeepSeek（可选）

建议你先按“智谱主线”跑通一次，再来配置 DeepSeek，会更容易排错。

步骤1：获取 DeepSeek API Key

1. 访问 https://platform.deepseek.com/
2. 登录后进入 API Keys，创建并复制 Key（只显示一次）

步骤2：配置（先按 OpenAI 兼容方式尝试）

# Windows PowerShell（替换为你的 DeepSeek Key；只在本窗口生效）
$env:ANTHROPIC_API_KEY="你的DeepSeek-API-Key"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"

REM Windows CMD（替换为你的 DeepSeek Key；只在本窗口生效）
set ANTHROPIC_API_KEY=你的DeepSeek-API-Key
set ANTHROPIC_BASE_URL=https://api.deepseek.com/v1

# Mac/Linux（替换为你的 DeepSeek Key；只在当前终端会话生效）
export ANTHROPIC_API_KEY="你的DeepSeek-API-Key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"

方式三：豆包（可选）

如果你更喜欢用字节跳动的豆包服务，配置方式类似：

# 设置豆包的 API Key
$env:ANTHROPIC_API_KEY="豆包的API-Key"

# 设置 API 端点（豆包专用）
$env:ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"

# 设置豆包的 API Key
export ANTHROPIC_API_KEY="豆包的API-Key"

# 设置 API 端点（豆包专用）
export ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"

第4步：第一次对话（5分钟）

Claude Code 会先展示计划，等待你确认后再执行

mkdir "$env:USERPROFILE\\claude-practice" -ErrorAction SilentlyContinue
cd "$env:USERPROFILE\\claude-practice"

mkdir "%USERPROFILE%\\claude-practice" 2>nul
cd /d "%USERPROFILE%\\claude-practice"

mkdir -p ~/claude-practice
cd ~/claude-practice

打开 Claude Code

claude

claude

你会看到类似这样的欢迎界面：

成功标志：出现 Connected to GLM（智谱）并能收到 OK（示意图）

试一试

输入第一条消息：

如果看到 Claude 回复 "配置成功"，说明配置成功。

实战小任务

试试让 Claude 帮你做点事情：

验证结果

你应该能看到文件被创建，内容是 "Hello World"！

常见问题

# 检查 npm 全局路径
npm config get prefix

# 如果路径有问题，重新设置（示例）
npm config set prefix "C:\Users\你的用户名\AppData\Roaming\npm"

# 检查 npm 全局路径
npm config get prefix

# 使用 sudo 安装
sudo npm install -g @anthropic-ai/claude-code

完成标准

完成本章学习后，你应该能够：