Claude Code 入门使用

Claude Code Simple Using

Claude code 入门使用和介绍
Abstract
本文主要是介绍Claude Code安装之后的入门使用,要了解Claude Code设计理念和结构基础

1. 背景

按照前文介绍 安装好Claude Code,开始基础的入门

首先了解,Claude Code能做什么?

  • 从描述构建功能:用纯英文告诉 Claude 您想构建什么。它将制定计划、编写代码并确保其正常工作。
  • 调试和修复问题:描述一个错误或粘贴一条错误消息。Claude Code 将分析您的代码库、识别问题并实施修复。
  • 导航任何代码库:询问关于您团队代码库的任何内容,并获得深思熟虑的答案。Claude Code 维护对整个项目结构的认识,可以从网络上查找最新信息,并且通过 MCP 可以从 Google Drive、Figma 和 Slack 等外部数据源提取数据。
  • 自动化繁琐的任务:修复棘手的 lint 问题、解决合并冲突并编写发布说明。从您的开发机器上用一个命令完成所有这些,或在 CI 中自动完成。 ​ ## 2. 快速入门

创建一个文件夹,然后按照需求命名,这里命名为Claude Code/test,里面有一个很小的测试项目,进入终端,切换到创建文件夹的目录下,输入以下命令: Claude --dangerously-skip-permissions,进入对话模式

ccuse 中文

ccuse 英文(width=“50%”)

Note

中文/英文都是可以自如对话

2.1 交互功能

进入交互界面之后,输入第一个问题

what dose this project do?

chat model

Claude Code会自我执行各种命令,然后查看project中文件进行分析,最后给出结果

⏺ This is a Todo List Management System (待办事项管理系统) - a Python educational project for beginners. Here's what it does:

  Purpose: A complete task management application that demonstrates core programming concepts including OOP, database CRUD operations, UI design, and proper code architecture.

  Key Features:
  - View todo items (all/completed/incomplete)
  - Add new todos with title and description
  - Update todos and toggle completion status
  - Delete todos with confirmation
  - Search by title/description
  - View statistics (total, completed, completion rate)

你可以问各种想问的问题

where is the main entry point? what technologies does this project use?

2.2 进行代码修改

让 Claude Code 进行一些实际的编码。尝试一个简单的任务:

> add a hello world function to the main file

Claude Code将 - 找到文件 - 显示修改 - 确认修改

> > add a hello world function to the main file

⏺ Update(main.py)
  ⎿  Added 5 lines
      257          self.running = False
      258
      259
      260 +def hello_world():
      261 +    """打印 Hello World"""
      262 +    print("Hello, World!")
      263 +
      264 +
      265  def main():
      266      """主函数"""
      267      app = TodoApp()

⏺ Done! Added hello_world() function at main.py:260-262. You can call it with:

  hello_world()
Note

Claude Code 在修改文件前总是请求许可。您可以批准单个更改或为会话启用”全部接受”模式。

还有很多常见的功能

重构代码
> refactor the authentication module to use async/await instead of callbacks

编写测试 > write unit tests for the calculator functions

更新文档 > update the README with installation instructions

代码审查 > review my changes and suggest improvements

2.3 基础命令

Claude Code有两种形式的交互,一种是直接在bash终端进行交互;一种是进入Claude Code内进行/交互

下面命令是常见的bash交互命令

命令示例 功能描述 适用场景
claude 启动交互模式 进入持续的对话环境,适合反复讨论、逐步完善任务
claude "task" 运行一次性任务 直接处理具体指令(如:claude "fix the build error"
claude -p "query" 运行一次性查询并退出 快速获取信息(如:claude -p "explain this function"
claude -c 继续最近的对话 回到上一次未完成的上下文中
claude -r 恢复之前的对话 从历史记录中选择并恢复旧的会话
claude commit 创建 Git 提交 自动分析代码变更并生成 / 执行 Git commit

claude code using

claude code using

进入Claude Code之后,输入/ 即可看到提示,有非常多的功能,看到了Claude Code的强大

claude code using /

而在Claude Code内部进行交互,同样可是使用?来查看所有可用的键盘快捷方式

claude code using ?

2.4 专业提示

Claude Code有对我们初学者给的专业建议

  1. 对于请求要非常具体,例如要用fix the login bug where users see a blank screen after entering wrong credentials,而不是 fix the login bug

  2. 尽量使用分步说明,而不是笼统的一步

  3. 进行更改之前,让Claude先探索,并且理解自己的代码。 > analyze the database schema,> build a dashboard showing products that are most frequently returned by our UK customers

  4. 多使用快捷方式,节省时间。使用Tab进行命令补全,使用 ↑ 查看命令历史

3. Claude Code如何工作

当您给Claude 一个任务时,它会经历三个阶段:收集上下文、采取行动和验证结果。Claude 始终使用工具,无论是搜索文件以了解您的代码、编辑以进行更改,还是运行测试以检查其工作。

agent loop

错误修复会循环通过所有三个阶段多次。重构可能涉及广泛的验证。Claude 根据从前一步学到的内容决定每一步需要什么,将数十个操作链接在一起并沿途进行纠正。

你的输入也是循环的一部份,在任何时候中断引导Claude朝着不同的方向发展,提供额外的上下文或者要求他尝试不同的方法

代理循环由两个组件驱动:模型进行推理和工具采取行动。Claude Code 充当 Claude 周围的代理工具:它提供工具、上下文管理和执行环境,将语言模型转变为能够进行编码的代理。

3.1 模型

Claude Code 使用 Claude 模型来理解您的代码并推理任务。Claude 可以读取任何语言的代码、理解组件如何连接,以及确定需要更改什么来实现您的目标。对于复杂的任务,它将工作分解为步骤、执行它们,并根据学到的内容进行调整。

国产大模型,OpenAI大模型,Claude模型都是可以用的

主要是根据不同的任务选择不同的模型,不同的模型选择不同的套餐,燃烧Tokens

3.2 工具

Claude Code 使用工具来执行任务。工具是执行代码更改、运行测试、构建和部署应用程序的命令行工具。Claude Code 提供了这些工具,并管理它们在您的计算机上的执行环境。

没有工具,Claude只能用文本回应,有了工具Claude 可以采取行动:读取您的代码、编辑文件、运行命令、搜索网络并与外部服务交互。

┌────────────┐
│   Claude   │  ← 语言模型(只会“想”和“说”)
└─────┬──────┘
      │  Tool Call(结构化请求)
      ▼
┌────────────┐
│ Tool Router│  ← 工具调度层(权限 + 白名单)
└─────┬──────┘
      │
      ▼
┌──────────────────────────┐
│ Claude Code Runtime (你机器上) │
│ - 文件系统                │
│ - Shell                   │
│ - Git                     │
│ - 网络代理(可选)        │
└──────────────────────────┘

Claude Code 可调用的工具

类别 Claude 可以做什么
文件操作 读取文件、编辑代码、创建新文件、重命名文件、重新组织项目结构
搜索 按模式查找文件、使用正则表达式搜索内容、探索和理解整个代码库
执行 运行 shell 命令、启动本地服务器、运行测试、使用 Git 进行版本控制操作
网络 搜索网络、获取官方文档、查找和解释错误消息
代码智能 编辑代码后查看类型错误和警告、跳转到定义、查找引用(需要代码智能插件支持)

Claude可以访问什么

  • 您的项目。 您的目录和子目录中的文件,以及您允许的其他地方的文件。
  • 您的终端。 您可以运行的任何命令:构建工具、git、包管理器、系统实用程序、脚本。如果您可以从命令行执行,Claude 也可以。
  • git 状态。 当前分支、未提交的更改和最近的提交历史。
  • CLAUDE.md。 一个 markdown 文件,您可以在其中存储项目特定的说明、约定和 Claude 应该在每个会话中了解的上下文。
  • 用于外部服务的 MCP servers、用于工作流的 skills、用于委派工作的 subagents 和用于浏览器交互的 Claude in Chrome。

3.3 会话工作

Claude Code 在您工作时将您的对话保存在本地。每条消息、工具使用和结果都被存储,这使得回退、恢复和分叉会话成为可能。在 Claude 进行代码更改之前,它还会对受影响的文件进行快照,以便您在需要时可以恢复。

会话是短暂的。 与 claude.ai 不同,Claude Code 在会话之间没有持久的内存。每个新会话都从头开始。Claude 不会”学习”您的偏好或记住您上周做了什么。如果您希望 Claude 在会话之间了解某些内容,请将其放在您的 CLAUDE.md 中。

每个 Claude Code 对话都是与您当前目录相关联的会话。当您恢复时,您只会看到来自该目录的会话。

Claude 看到您当前分支的文件。当您切换分支时,Claude 看到新分支的文件,但您的对话历史保持不变。Claude 记得您讨论过的内容,即使在切换后也是如此。

上下文窗口

┌──────────────────────────────┐
│ ① System Prompt / Agent 角色 │
├──────────────────────────────┤
│ ② 对话历史(你和 Claude)   │
├──────────────────────────────┤
│ ③ Claude 记住的任务/意图     │
├──────────────────────────────┤
│ ④ 当前会话中读过的文件内容   │
├──────────────────────────────┤
│ ⑤ 工具返回结果(stdout等)  │
└──────────────────────────────┘

委派,不要指示 想象委派给一个有能力的同事。提供上下文和方向,然后相信 Claude 会弄清楚细节: