AI Spark 知识库

外观

安装与环境配置 ​

用时：15 分钟 | 难度：⭐ 入门

目标 ​

在你的系统上安装并运行 Claude Code，用第一条命令验证它能正常工作。

你将学到 ​

  • 在你的平台上安装 Claude Code（macOS / Linux / Windows）
  • 理解基本的提示词 → 响应循环
  • 运行第一条命令
  • 访问帮助系统

安装 ​

macOS（推荐） ​

Bash
brew install anthropic/tap/claude-code

验证：

Bash
claude --version

Linux ​

Bash
curl -sSL https://dl.claudecode.com/install.sh | bash

验证：

Bash
claude --version

Windows ​

从 https://dl.claudecode.com/windows 下载安装包，或使用：

PowerShell
iex ((New-Object System.Net.WebClient).DownloadString('https://dl.claudecode.com/install.ps1'))

Docker（任意平台） ​

Bash
docker run -it anthropic/claude-code:latest

首次运行 ​

进入任意项目目录并启动 Claude：

Bash
cd ~/my-project
claude

你将看到：

Plain
Claude Code v2.x.x ready
Project: ~/my-project (git: main)
Context: 0% · Tokens available: 200,000

Type /help for commands or ask me anything
>

核心命令 ​

命令用途
/help显示所有可用命令
/status查看上下文用量和会话状态
/clear重新开始（清除对话历史）
Ctrl+C取消当前操作
/exit关闭 Claude Code

前 5 分钟 ​

练习 1：查看可用命令 ​

Bash
/help

浏览命令列表，留意：

  • 工作流：/plan、/rewind、/think
  • 导航：/goto、/read
  • 记忆：启动时加载的记忆
  • 高级：/model、/mode

练习 2：检查会话状态 ​

Bash
/status

你将看到：

  • 上下文用量百分比
  • 可用 Token（词元）数
  • 当前项目
  • Git 分支

练习 3：向 Claude 提问 ​

Plain
What files are in my project?

Claude 会读取项目结构并作出回应。这就是核心循环：

Plain
你的提示词 → Claude 读取文件 → Claude 建议变更 → 你审阅 → 应用

练习 4：审阅一个建议变更 ​

如果 Claude 建议代码变更，你将看到：

  1. 变更描述
  2. 差异对比（diff）视图（显示新增/删除内容）
  3. 接受或拒绝的提示

原则：接受前务必审阅差异对比（diff）。这能保护你免受意外变更的影响。

核心概念：循环 ​

每次交互都遵循以下模式：

Plain
┌─────────────┐
│ 你提问      │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ Claude      │
│ 读取文件    │
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ Claude      │
│ 建议变更    │
└──────┬──────┘
       │
       ▼
┌──────────────────┐
│ 你审阅差异对比   │
│ 并确认           │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│ 变更应用到       │
│ 你的文件         │
└──────────────────┘

关键概念 ​

会话 ​

每次运行 claude，你都会开启一个新会话。会话是你与 Claude 的对话，在使用 Claude Code 期间持续存在。

  • 会话默认不保存（退出时结束）
  • 会话限定在单个项目范围内
  • 随着提问越来越多，上下文会增长（最大约 200K Token（词元））

上下文 ​

上下文是 Claude 能记住的对话量，以百分比（0-100%）显示。

  • 0-50%：空间充足，自由工作
  • 50-70%：有选择地使用，可选运行 /compact
  • 70%+：运行 /compact 释放空间
  • 90%+：将被强制清理

Git 感知 ​

Claude Code 具备 Git 感知能力，它能：

  • 检测当前分支
  • 显示未提交的变更
  • 协助提交和代码审查
  • 防止意外破坏性变更

验证：以下都满足说明你已准备好 ​

✓ 运行 claude --version 能看到已安装的版本✓ 能在项目中用 claude 启动 Claude✓ 理解提示词 → 响应的循环✓ 能看懂 /status 的显示内容✓ 已审阅过至少一次 Claude 建议的差异对比（diff）

下一步 ​

熟悉本模块后，前往模块 02：核心循环，了解：

  • Claude 如何读取你的项目
  • 上下文的深层工作原理
  • 如何构建请求以获得更好的结果
  • 计划模式与思考模式

到下一模块的时间：立即可开始（除了运行一次 Claude 外无需其他前置条件）

故障排查 ​

"claude: command not found" ​

安装未完成。请尝试：

"Project not found" ​

确保你在包含 package.json、.git 或其他项目文件的目录中。Claude Code 在项目中效果最佳。

"Permission denied"（macOS） ​

尝试：

Bash
chmod +x /usr/local/bin/claude

资源 ​

完成模块 01？ → 进入 模块 02：核心循环

来源：飞书 · AI Spark 知识库 ｜ 原文（最新版）：https://lcnniolukk80.feishu.cn/wiki/YvVrw9ZJjicWfMk4tyYc2xXxnyc ｜ 归档：2026-06-04