3.7 Claude Code 安装与启动

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆、张一帆

发布于

2026-05-14

Claude Code 是 Anthropic 发布的 AI 编码代理（Agentic Coding Tool），在终端中运行。它能直接读写文件、执行命令、搜索代码库，用自然语言即可控制。

本书从第二篇开始的所有章节，均以 Claude Code 作为主要教学工具。本节介绍它的安装和首次启动方法。

安装前提

Claude Code 依赖两项基础条件：

条件	说明
Node.js >= 18	前面安装 Opencode 时已经装好
Anthropic 认证	API 密钥或 Claude Pro/Max 订阅（二选一）

知识卡片

Claude Pro 是 Anthropic 的付费订阅服务（20 美元/月），Claude Max 是更高额度的订阅方案（100 或 200 美元/月）。订阅用户可以通过 OAuth 登录直接使用 Claude Code，无需单独购买 API 额度。

安装

打开终端（Mac）或 PowerShell（Windows），输入以下命令：

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

等待安装完成后，验证：

claude --version

看到版本号（如 1.0.x），说明安装成功。

故障排除

Mac 用户如果提示权限不足，在命令前加 sudo：sudo npm install -g @anthropic-ai/claude-code，然后输入电脑密码
Windows 用户如果安装失败，以管理员身份运行 PowerShell 再试
提示 node 版本过低，用 node --version 检查，低于 18 需要更新 Node.js

首次启动

先进入工作目录，再启动 Claude Code：

cd ~/opencode-lab
claude

首次启动时，Claude Code 会要求认证身份。有两种方式：

OAuth 登录（推荐）：选择登录 Anthropic 账户，浏览器会自动打开认证页面。登录后回到终端，认证自动完成。适合 Claude Pro/Max 订阅用户。
API 密钥：选择输入 API Key，粘贴你的 Anthropic API 密钥。适合按量付费用户。

获取 API 密钥

Anthropic API 密钥在 https://console.anthropic.com/settings/keys 页面创建。注册 Anthropic 账户后，点击 Create Key，复制并保存。密钥以 sk-ant- 开头。

认证通过后，终端显示 Claude Code 的交互界面。输入一句话测试：

▶ Claude Code

你好，请介绍一下你自己

Claude 正常回复，说明一切就绪。

按 /exit 或 Ctrl+C 两次可退出 Claude Code。

基本操作速查

操作	方法
启动	在工作目录中输入 `claude`
发送消息	在输入框中输入文字，按回车
换行不发送	`Shift+Enter`
接受 AI 的文件修改	按 `y` 确认
拒绝修改	按 `n` 拒绝
新建对话	输入 `/clear`
退出	输入 `/exit` 或按 `Ctrl+C` 两次
恢复上次对话	`claude --continue`

Claude Code 与 Opencode 的区别

两者都是在终端中运行的 AI 编码助手，核心交互方式相同：用自然语言描述任务，AI 执行操作。区别在于定位和功能范围。

维度	Opencode	Claude Code
开发者	开源社区	Anthropic（Claude 模型的开发公司）
支持的模型	多家提供商（智谱、Kimi、OpenAI 等）	仅限 Claude 模型
认证方式	API 密钥	API 密钥或 OAuth 订阅登录
Skills	社区扩展包	内置 Skills 机制（`.claude/skills/`）
子代理	不支持	支持（`.claude/agents/`）
Hooks	不支持	支持（事件驱动的自动化脚本）
项目规则文件	`AGENTS.md`	`CLAUDE.md`
适用场景	快速上手、多模型切换	深度项目协作、多智能体编排

Opencode 适合初步体验 AI 编码助手的工作方式，上手门槛低，模型选择灵活。Claude Code 提供了完整的项目协作机制——Skills、子代理、Hooks、Agent Teams，是构建复杂智能体系统的基础。

本书第二篇开始，所有概念和操作均基于 Claude Code 展开。Opencode 用户可以对照使用，核心的人机协作方法是相通的。

--- title: "3.7 Claude Code 安装与启动" --- Claude Code 是 Anthropic 发布的 AI 编码代理（Agentic Coding Tool），在终端中运行。它能直接读写文件、执行命令、搜索代码库，用自然语言即可控制。本书从第二篇开始的所有章节，均以 Claude Code 作为主要教学工具。本节介绍它的安装和首次启动方法。 ## 安装前提 Claude Code 依赖两项基础条件： | 条件 | 说明 | |------|------| | Node.js >= 18 | 前面安装 Opencode 时已经装好 | | Anthropic 认证 | API 密钥或 Claude Pro/Max 订阅（二选一） | ::: {.callout-note} ## 知识卡片 Claude Pro 是 Anthropic 的付费订阅服务（20 美元/月），Claude Max 是更高额度的订阅方案（100 或 200 美元/月）。订阅用户可以通过 OAuth 登录直接使用 Claude Code，无需单独购买 API 额度。 ::: ## 安装打开终端（Mac）或 PowerShell（Windows），输入以下命令： ```bash npm install -g @anthropic-ai/claude-code ``` 等待安装完成后，验证： ```bash claude --version ``` 看到版本号（如 `1.0.x`），说明安装成功。 ::: {.callout-caution} ## 故障排除 - Mac 用户如果提示权限不足，在命令前加 `sudo`：`sudo npm install -g @anthropic-ai/claude-code`，然后输入电脑密码 - Windows 用户如果安装失败，以管理员身份运行 PowerShell 再试 - 提示 `node` 版本过低，用 `node --version` 检查，低于 18 需要更新 Node.js ::: ## 首次启动先进入工作目录，再启动 Claude Code： ```bash cd ~/opencode-lab claude ``` 首次启动时，Claude Code 会要求认证身份。有两种方式： - **OAuth 登录**（推荐）：选择登录 Anthropic 账户，浏览器会自动打开认证页面。登录后回到终端，认证自动完成。适合 Claude Pro/Max 订阅用户。 - **API 密钥**：选择输入 API Key，粘贴你的 Anthropic API 密钥。适合按量付费用户。 ::: {.callout-tip} ## 获取 API 密钥 Anthropic API 密钥在 <https://console.anthropic.com/settings/keys> 页面创建。注册 Anthropic 账户后，点击 Create Key，复制并保存。密钥以 `sk-ant-` 开头。 ::: 认证通过后，终端显示 Claude Code 的交互界面。输入一句话测试： ```opencode 你好，请介绍一下你自己 ``` Claude 正常回复，说明一切就绪。按 `/exit` 或 `Ctrl+C` 两次可退出 Claude Code。 ## 基本操作速查 | 操作 | 方法 | |------|------| | 启动 | 在工作目录中输入 `claude` | | 发送消息 | 在输入框中输入文字，按回车 | | 换行不发送 | `Shift+Enter` | | 接受 AI 的文件修改 | 按 `y` 确认 | | 拒绝修改 | 按 `n` 拒绝 | | 新建对话 | 输入 `/clear` | | 退出 | 输入 `/exit` 或按 `Ctrl+C` 两次 | | 恢复上次对话 | `claude --continue` | ## Claude Code 与 Opencode 的区别两者都是在终端中运行的 AI 编码助手，核心交互方式相同：用自然语言描述任务，AI 执行操作。区别在于定位和功能范围。 | 维度 | Opencode | Claude Code | |------|----------|-------------| | 开发者 | 开源社区 | Anthropic（Claude 模型的开发公司） | | 支持的模型 | 多家提供商（智谱、Kimi、OpenAI 等） | 仅限 Claude 模型 | | 认证方式 | API 密钥 | API 密钥或 OAuth 订阅登录 | | Skills | 社区扩展包 | 内置 Skills 机制（`.claude/skills/`） | | 子代理 | 不支持 | 支持（`.claude/agents/`） | | Hooks | 不支持 | 支持（事件驱动的自动化脚本） | | 项目规则文件 | `AGENTS.md` | `CLAUDE.md` | | 适用场景 | 快速上手、多模型切换 | 深度项目协作、多智能体编排 | Opencode 适合初步体验 AI 编码助手的工作方式，上手门槛低，模型选择灵活。Claude Code 提供了完整的项目协作机制——Skills、子代理、Hooks、Agent Teams，是构建复杂智能体系统的基础。本书第二篇开始，所有概念和操作均基于 Claude Code 展开。Opencode 用户可以对照使用，核心的人机协作方法是相通的。