第 05 章 | 安装 Claude Code

更新于 2026/5/9
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

第 5 章：安装 Claude Code

学习目标

跑起 claude 命令，完成第一次对话。

安装

# 推荐：通过 npm 全局安装
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

第一次启动

mkdir ~/work/learn-claude && cd ~/work/learn-claude
claude

第一次会要求登录：

sequenceDiagram
    participant You as 你
    participant CC as Claude Code
    participant Browser as 浏览器
    participant Anth as Anthropic

    You->>CC: claude
    CC->>Browser: 打开登录链接
    Browser->>Anth: OAuth 授权
    Anth->>Browser: token
    Browser->>CC: 写入 ~/.claude/credentials
    CC->>You: ready

登录完毕后你会看到一个交互式终端 UI——这就是 Claude Code 的"驾驶舱"。

三个保命命令

无论何时迷路，这三个命令救你：

命令 干嘛
/help 列所有命令
/model 切换模型（也能查当前用的什么）
/context 看当前会话用了多少 token

试一下 /context 你会看到：

Tokens: 8.3k / 1m (0.8%)
System prompt: 8.3k tokens
Free space: 991k (99.2%)

→ Opus 4.7 的 1M 上下文，目前几乎全空。

工作目录的概念

Claude Code 启动时所在的目录就是它的"项目根"。Edit/Write 的相对路径都基于这里。改目录后（重启 claude）一切重置。

~/work/learn-claude/        ← 你启动 claude 的地方
                            ← 这就是 $CLAUDE_PROJECT_DIR
                            ← .claude/、CLAUDE.md 都在这层

第一次对话试水

跟它说：

你：在当前目录建一个 hello.txt，里面写 "hello world"

如果你的 permission 模式是默认（每次问），它会弹出确认。允许后，文件就建好了。

$ ls
hello.txt
$ cat hello.txt
hello world

常用快捷键

键 作用
Esc 中断 Claude 当前回应
Ctrl+R 历史命令搜索
Ctrl+C 两次 退出 Claude Code
!command 让你直接跑 shell 命令（不经过 Claude）

你现在能做什么

  • 跑起 Claude Code、登录、查上下文
  • 让 Claude 在你的目录里创建文件
  • 知道工作目录的边界

下一章装 OpenSpec，给 Claude 加上"记需求"的能力。