跳到主要内容

首次使用

安装完成后,让我们来启动 Claude Code 并了解它的基本使用方法。

启动 Claude Code

基本启动命令

在终端中运行以下命令来启动 Claude Code:

# 在当前目录启动
claude

# 或者在指定目录启动
claude /path/to/your/project

# 使用特定模型启动
claude --model sonnet

# 启动时显示详细模式(可以看到思考过程)
claude --verbose

启动界面

启动后,你会看到一个简洁的欢迎界面:

╭────────────────────────────────────────────────────────╮
│ Welcome to Claude Code! 🎉 │
│ │
│ Type your message and press Enter to start │
│ Use /help to see available commands │
│ │
│ Current directory: /Users/yourname/project │
╰────────────────────────────────────────────────────────╯

Claude>

首次配置

首次启动时,Claude Code 会引导你完成基本配置:

  1. 身份验证

    # 系统会提示你登录 Anthropic 账户
    # 按照提示在浏览器中完成授权
  2. 设置偏好

    # 选择默认模型(Sonnet 推荐用于日常开发)
    # 配置编辑器偏好(VS Code、Vim 等)
    # 设置自动保存偏好

基本交互方式

1. 自然语言对话

直接输入你的需求,就像与人交谈一样:

Claude> 帮我查看这个项目的结构
Claude> 这个项目是做什么的?
Claude> 找到所有的配置文件
Claude> 解释 src/utils.js 中的工具函数

2. 使用斜杠命令

Claude Code 提供了一系列强大的斜杠命令:

Claude> /help          # 查看帮助信息
Claude> /clear # 清空对话历史
Claude> /exit # 退出程序
Claude> /status # 查看当前状态
Claude> /context # 查看上下文使用情况
Claude> /compact # 压缩对话历史
Claude> /memory # 管理记忆功能
Claude> /usage # 查看使用限制和配额

3. 快捷键操作

Ctrl+R    # 搜索命令历史
Ctrl+O # 切换详细模式(查看 AI 思考过程)
Tab # 命令自动补全
Ctrl+C # 中断当前操作

第一个实际操作

让我们通过一个简单的例子来体验 Claude Code 的能力:

场景:了解一个新项目

  1. 查看项目结构

    Claude> 这个项目的结构是怎样的?
  2. 理解代码功能

    Claude> src/main.py 是做什么的?
  3. 运行项目

    Claude> 如何运行这个项目?

实际例子演示

假设你有一个简单的 Python 项目:

Claude> 分析这个项目

正在分析你的项目...

📁 项目结构:
├── src/
│ ├── __init__.py
│ ├── main.py
│ └── utils.py
├── requirements.txt
├── README.md
└── tests/

📋 项目信息:
- 类型:Python 应用
- 主要功能:Web 应用(基于 Flask)
- 依赖:Flask, requests, pytest

💡 建议:
这是一个简单的 Flask Web 应用。你可以运行:
python src/main.py
来启动应用。

上下文感知功能

Claude Code 的强大之处在于其上下文感知能力:

自动上下文加载

# 使用 @-mention 自动包含目录
Claude> 检查 @src/components 中的所有组件

# Claude 会自动添加相关文件到对话上下文
# 无需手动指定每个文件

上下文管理

# 查看当前上下文使用情况
Claude> /context

# 添加目录到上下文
Claude> /add-dir src/utils

# 压缩对话历史以节省上下文
Claude> /compact

常用操作示例

代码相关操作

Claude> 读取 package.json 文件
Claude> 找到所有包含 "TODO" 的代码
Claude> 这个函数是做什么用的?
Claude> 帮我优化这段代码
Claude> 重构这个组件,使用 TypeScript

文件系统操作

Claude> 创建一个新的组件文件
Claude> 删除测试文件
Claude> 重命名这个目录
Claude> 查找所有 .json 文件
Claude> 在 @src 目录中搜索配置文件

Git 操作

Claude> 查看当前的 git 状态
Claude> 提交当前的更改
Claude> 创建一个新的分支
Claude> 查看最近的提交历史
Claude> 生成有意义的提交信息

实用技巧

1. 上下文感知

Claude Code 会记住:

  • 当前工作目录
  • 项目的文件结构
  • 之前的对话内容
  • 项目的语言和技术栈
  • CLAUDE.md 文件中的项目配置

2. 多步骤任务

对于复杂的任务,Claude Code 会自动分解:

Claude> 为这个项目添加用户认证功能

我来帮你添加用户认证功能。让我先了解项目结构,
然后制定实施计划。

步骤 1: 分析现有项目结构...
步骤 2: 设计认证方案...
步骤 3: 实现认证代码...

3. 错误处理

如果遇到错误,Claude Code 会:

Claude> 修复这个 bug

看起来有个类型错误。让我检查代码并修复它...

发现的问题:
- 变量类型不匹配

修复方案:
✓ 已更新类型定义
✓ 添加了错误处理
✓ 验证修复结果

4. 扩展思考模式

使用思考模式让 AI 展示推理过程:

# 在请求中添加"think"触发扩展思考
Claude> 分析这个性能问题,think hard

# 使用 Ctrl+O 切换详细模式查看思考过程
# 思考内容会以灰色斜体显示

5. 集成外部工具

Claude Code 支持 MCP (Model Context Protocol) 扩展:

# 与 GitHub 交互
Claude> @github 创建一个新 issue

# 使用数据库
Claude> @database 查询用户表

# 浏览器自动化
Claude> @playwright 访问网站并截图

下一步

现在你已经了解了 Claude Code 的基本使用方法。接下来:

  1. 学习更多基础命令
  2. 了解基本工作流程
  3. 探索核心概念

开始你的 Claude Code 之旅吧!