第 1 章：初识 Claude Code — 安装与首次对话

⏱ Est. reading time: 13 min Updated on 5/15/2026

1.1 什么是 Claude Code

Claude Code 是 Anthropic 官方提供的命令行界面（CLI）工具，它让你能够在终端中直接与 Claude AI 协作进行编程工作。与网页版 Claude 不同，Claude Code 深度集成在开发环境中，可以直接读取和编辑项目文件、执行终端命令、审查代码库，甚至并行处理多个任务。

核心能力包括：

  • 代码生成与修改：基于自然语言描述生成完整功能代码
  • 文件操作：读取、创建、编辑项目文件
  • 终端集成：直接执行 shell 命令并处理输出
  • 代码审查：分析代码质量、查找 bug、提出改进建议
  • 并行任务：同时执行多个独立的开发任务
  • 版本控制：与 Git 工作流无缝集成

本教程将以一个番茄工作法（Pomodoro）计时器应用为例，带你一步步掌握 Claude Code 的核心命令和工作流程。

1.2 安装 Claude Code

前置要求

  • Node.js 18 或更高版本
  • npm 或 yarn 包管理器

安装步骤

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

# 或使用 yarn
yarn global add @anthropic-ai/claude-code

启动 Claude Code

# 在终端中启动
claude

首次运行时，Claude Code 会引导你完成初始配置和登录流程。

更新 Claude Code

# 更新到最新版本
npm update -g @anthropic-ai/claude-code

# 或使用 yarn
yarn global upgrade @anthropic-ai/claude-code

1.3 /login — 登录账户

语法

/login

功能说明

登录 Anthropic 账户以使用 Claude Code。首次启动时会自动引导登录，之后也可手动使用此命令重新登录。登录后才能使用 AI 功能。

实际使用示例

$ /login
Opening browser for authentication...
Authenticated as [email protected]
Welcome to Claude Code!

支持的方式

  • Anthropic 账户（邮箱 + 密码）
  • Google 账户
  • GitHub 账户

相关命令

/logout  # 登出当前账户

注意事项

  • 登录信息会保存在本地配置中，下次启动时自动登录
  • 如果遇到认证问题，可以尝试 /logout 后重新 /login
  • 登录状态是会话级别的，不会共享到其他设备

1.4 /help — 查看命令列表

语法

/help

功能说明

显示 Claude Code 中所有可用的斜杠命令及其简要说明。命令列表会根据你已安装的技能（skills）动态更新。

实际使用示例

$ /help

Available Commands:
  /help          - Show this help message
  /login         - Log in to your Anthropic account
  /logout        - Log out of your Anthropic account
  /status        - Show current status and configuration
  /model         - Select AI model (Sonnet/Opus)
  /exit          - Exit Claude Code
  /plan          - Create a plan for a task
  /execute       - Execute a plan
  ...

筛选命令

输入 / 后直接输入命令的前几个字母可以筛选命令列表：

$ /pl        # 会筛选并显示 /plan、/plan-review 等以 pl 开头的命令

注意事项

  • 斜杠命令只有在消息开头时才会被识别
  • 命令名后的文本会被作为参数传递给命令
  • 命令不区分大小写，但建议使用小写

1.5 /status — 查看环境状态

语法

/status

功能说明

显示 Claude Code 的当前运行状态，包括版本号、使用的 AI 模型、账户信息、连接状态等。这是诊断问题和确认配置的首选命令。

实际使用示例

$ /status

Claude Code Status
=================
Version: 1.2.3
Model: claude-sonnet-4.6 (Sonnet)
Account: [email protected]
Connected: Yes
API Endpoint: https://api.anthropic.com
Workspace: /Users/eric/work/my-pomodoro
Git Repository: No
Session ID: abc123-def456

注意事项

  • 可以在 Claude 正在响应时使用 /status，无需等待当前响应完成
  • 如果显示 "Connected: No"，请检查网络连接或重新登录
  • 模型名称显示了当前使用的具体模型版本（如 Sonnet 4.6）
  • Workspace 显示当前工作目录，这对确认项目上下文很重要

1.6 /model — 选择 AI 模型

语法

/model

功能说明

打开交互式模型选择器，让你在不同的 Claude 模型之间切换。不同的模型在速度、成本和推理能力上各有特点。

实际使用示例

$ /model

Select AI Model
===============
← Sonnet (claude-sonnet-4.6)   Fast, efficient for daily tasks
  Opus (claude-opus-4.7)    Deep reasoning, complex problems

Press ↑↓ to select, Enter to confirm

模型选择

  • Sonnet：推荐用于日常开发任务

    • 响应速度快
    • 成本较低
    • 适合代码生成、bug 修复、简单重构
    • 默认选择

  • Opus：适用于复杂任务

    • 深度推理能力更强
    • 处理复杂问题更准确
    • 成本较高
    • 适合架构设计、复杂算法、深度分析

Effort 级别调整

选中模型后，可以使用左右箭头调整 effort 级别：

Effort Level: Low  ← Normal →  High
  • Low：快速响应，减少推理时间
  • Normal：平衡模式（推荐）
  • High：深入思考，适合复杂问题

注意事项

  • 切换模型时会提示是否重新读取完整对话历史
  • 选择 "Yes" 会让新模型了解上下文，但会消耗额外 token
  • 模型切换立即生效，影响后续所有对话
  • 不同模型的定价策略不同，可通过 /usage 查看

1.7 /exit — 退出 CLI

语法

/exit

功能说明

退出 Claude Code 命令行界面，返回到系统终端。

实际使用示例

$ /exit

Goodbye! See you next time.

相关命令

/quit  # /exit 的别名，功能完全相同

快捷方式

  • Ctrl+C：中断当前操作并退出
  • Ctrl+D：发送 EOF 信号并退出

注意事项

  • 退出不会删除已创建的文件或修改
  • 对话历史会保存在本地，下次启动时可以继续
  • 未完成的任务状态不会保存（如正在进行的 /execute）

1.8 其他常用命令速览

/upgrade — 升级计划

语法

/upgrade

功能说明

检查并升级当前的 Claude Code 订阅计划。

实际使用示例

$ /upgrade

Current Plan: Free
Usage: 45,000 / 50,000 tokens this month

Available Upgrades:
  [1] Pro  - $20/month, 500K tokens/month
  [2] Team - $50/user/month, 1M tokens/month

Select upgrade plan or press Enter to cancel:

/usage — 查看使用量

语法

/usage

功能说明

查看当前时间段内的 API 使用量统计，包括 token 使用数和费用估算。

实际使用示例

$ /usage

Usage Statistics
================
Period: May 1 - May 13, 2026

Tokens Used: 125,430
Est. Cost: $0.25

Breakdown by Model:
  Sonnet 4.6:  98,500 tokens ($0.18)
  Opus 4.7:    26,930 tokens ($0.07)

Requests: 47
Success Rate: 100%

Billing Period: May 1 - June 1, 2026
Remaining Quota: 374,570 tokens

别名命令

/cost    # 同 /usage
/stats   # 同 /usage

注意事项

  • 使用量数据可能有短暂延迟（通常几分钟）
  • 不同模型的 token 计费方式不同
  • 定期查看使用量可以帮助控制成本

1.9 动手做：第一次使用 Claude Code

让我们通过一个完整的练习来熟悉 Claude Code 的基本操作。我们将使用一个简单的"Hello World"例子作为开始。

步骤 1：安装 Claude Code

如果你还没有安装，请先按照 1.2 节的说明安装：

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

步骤 2：启动 Claude Code

claude

首次启动时，你会看到欢迎信息和登录引导。

步骤 3：登录账户

/login

浏览器会自动打开，选择你的登录方式（Anthropic、Google 或 GitHub）。登录成功后，终端会显示确认信息。

步骤 4：确认环境状态

/status

检查输出，确认版本号、连接状态等信息正常。

步骤 5：选择合适的模型

/status

如果当前不是 Sonnet 模型，使用 /model 切换到 Sonnet（适合日常开发）。

步骤 6：让 Claude 写"Hello World"

现在我们可以第一次与 Claude 对话了。输入：

帮我创建一个简单的 Hello World 程序

Claude 会询问你想要什么语言的程序，你可以回答：

用 JavaScript

然后 Claude 会生成代码并建议创建文件。你可以：

好的，创建这个文件

Claude 会创建 hello.js 文件，内容如下：

// Hello World in JavaScript
console.log("Hello, World!");

步骤 7：运行程序

现在让 Claude 帮你运行这个程序：

运行这个程序

Claude 会执行：

node hello.js

输出：

Hello, World!

步骤 8：退出 Claude Code

当你完成后：

/exit

恭喜！你已经完成了第一次 Claude Code 体验。

本章小结

本章介绍了 Claude Code 的基础知识和核心命令：

  • Claude Code 是什么：Anthropic 官方的命令行 AI 编程助手，深度集成在开发环境中
  • 安装与启动：通过 npm 全局安装，使用 claude 命令启动
  • 核心命令：
    • /login：登录账户
    • /help：查看命令列表，支持前缀筛选
    • /status：查看环境状态，可用于诊断问题
    • /model：切换 AI 模型（Sonnet vs Opus）和调整 effort 级别
    • /exit：退出 CLI
    • /usage：查看使用量和费用
  • 实践体验：通过 Hello World 示例完成了从安装到第一次对话的完整流程

这些命令是你日常使用 Claude Code 的基础工具。下一章我们将深入介绍更强大的 /plan 命令，学习如何规划和管理复杂的开发任务——就像我们将要构建的番茄工作法计时器应用一样。