Day 1 / 7

初识 Claude Code

什么是 Claude Code,安装配置,开启AI编程之旅

📖 预计阅读时间:20分钟🎯 难度:入门

欢迎来到 Claude Code 的世界!如果你厌倦了在 IDE 和浏览器之间来回切换,厌倦了复制粘贴代码,那么 Claude Code 会让你眼前一亮。它不是简单的代码补全工具,而是一个能真正理解你项目、帮你写代码、改代码、调试代码的AI助手。

一、什么是 Claude Code

Claude Code 是 Anthropic 推出的命令行AI编程助手。简单说,就是把 Claude(那个很会聊天的AI)装进了命令行,让它能直接操作你的代码。

核心特点

  • 直接操作文件:不用复制粘贴,AI 直接读写你的代码文件
  • 理解项目上下文:能看懂你的项目结构,知道各个文件之间的关系
  • 执行命令:可以运行 bash 命令,编译、测试、部署一条龙
  • 多轮对话:记住上下文,不用每次都重复说明

与其他工具的区别

工具定位优势局限
GitHub Copilot代码补全快速、实时只能补全,不能理解项目
CursorAI IDE集成度高需要切换编辑器
ChatGPT对话助手通用性强不能直接操作代码
Claude Code命令行助手理解项目+直接操作需要命令行基础

二、安装 Claude Code

前置要求

1

Node.js 18+

检查版本:node --version

2

Anthropic API Key

console.anthropic.com 获取

安装步骤

步骤 1:安装 Claude Code

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

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

步骤 2:配置 API Key

# 设置环境变量
export ANTHROPIC_API_KEY="your-api-key-here"

# 或者写入配置文件
claude-code config set apiKey your-api-key-here

💡 建议把 API Key 写入 ~/.bashrc 或 ~/.zshrc,这样每次打开终端都会自动加载

步骤 3:验证安装

# 检查版本
claude-code --version

# 运行第一个命令
claude-code "hello"

如果看到 Claude 的回复,说明安装成功!

✅ 安装成功

如果看到版本号输出,说明 Claude Code 已经成功安装!接下来我们就可以开始使用了。

三、第一个命令:让 Claude 帮你写代码

安装完成后,让我们尝试第一个命令。在终端中输入:

claude "创建一个 Hello World 的 Python 脚本"

Claude Code 会:

  1. 1.

    理解你的需求

    分析你想要创建一个 Python 脚本

  2. 2.

    生成代码

    创建 hello.py 文件并写入代码

  3. 3.

    执行操作

    在你的当前目录创建文件

💡 提示

Claude Code 会在执行操作前询问你的确认。这是一个安全机制,确保 AI 不会在未经允许的情况下修改你的文件。

完整的交互流程

让我们看看完整的交互过程是什么样的:

你:

claude "创建一个 Python 脚本,计算斐波那契数列的前10项"

AI:

我来帮你创建这个脚本。我会:

  1. 1. 创建 fibonacci.py 文件
  2. 2. 实现斐波那契数列计算函数
  3. 3. 输出前10项结果

📝 将要创建的文件:fibonacci.py

def fibonacci(n):
    fib = [0, 1]
    for i in range(2, n):
        fib.append(fib[i-1] + fib[i-2])
    return fib[:n]

if __name__ == "__main__":
    result = fibonacci(10)
    print("斐波那契数列前10项:")
    print(result)

⚠️ 是否允许创建此文件?[y/n]

你:

y

AI:

✅ 文件已创建:fibonacci.py

你可以运行 python fibonacci.py 来测试

常见问题解答

Q: Claude Code 会联网吗?

会。Claude Code 需要调用 Anthropic API 来处理你的请求。但它只会发送你明确要求处理的文件内容,不会上传整个项目。

Q: API 调用会很贵吗?

不会。Claude Code 使用的是按 token 计费的模式:

  • • 输入:$3 / 百万 tokens
  • • 输出:$15 / 百万 tokens
  • • 一般的代码任务:$0.01 - $0.05

Q: 可以在公司项目中使用吗?

可以,但建议先咨询公司的安全政策。如果公司对代码保密性要求很高,可以考虑使用 Anthropic 的企业版 API,支持私有部署。

Q: 支持哪些编程语言?

几乎所有主流语言:Python、JavaScript/TypeScript、Java、C++、Go、Rust、PHP、Ruby 等。Claude 对每种语言的理解程度不同,但主流语言都支持得很好。

Q: 如果 AI 生成的代码有 bug 怎么办?

直接告诉它!Claude Code 支持多轮对话,你可以说"这段代码有问题,报错信息是...",它会帮你修复。这也是为什么要审查代码的原因。

四、核心概念:Claude Code 的工作原理

🧠

理解上下文

Claude Code 会读取你的项目文件、代码结构,理解你的开发环境和需求。

🛠️

工具调用

通过内置工具(读文件、写文件、执行命令等)来完成实际的编程任务。

🔄

迭代优化

根据执行结果和你的反馈,不断调整和优化代码,直到满足需求。

🔒

安全机制

所有文件修改和命令执行都需要你的确认,确保 AI 不会做出意外操作。

五、实战练习:创建一个待办事项应用

让我们通过一个完整的例子,体验 Claude Code 的工作流程。这个练习会让你真正理解 AI 编程助手的强大之处。

任务目标

创建一个命令行待办事项应用,支持添加、查看、完成、删除任务。

claude "创建一个 Python 待办事项应用,支持:
1. 添加任务
2. 查看所有任务
3. 标记任务完成
4. 删除任务
使用 JSON 文件存储数据"

预期结果

Claude Code 会生成类似这样的代码:

import json
import os
from datetime import datetime

class TodoApp:
    def __init__(self, filename='todos.json'):
        self.filename = filename
        self.todos = self.load_todos()

    def load_todos(self):
        if os.path.exists(self.filename):
            with open(self.filename, 'r', encoding='utf-8') as f:
                return json.load(f)
        return []

    def save_todos(self):
        with open(self.filename, 'w', encoding='utf-8') as f:
            json.dump(self.todos, f, ensure_ascii=False, indent=2)

    def add_task(self, task):
        todo = {
            'id': len(self.todos) + 1,
            'task': task,
            'completed': False,
            'created_at': datetime.now().isoformat()
        }
        self.todos.append(todo)
        self.save_todos()
        print(f"✅ 任务已添加:{task}")

    def list_tasks(self):
        if not self.todos:
            print("📝 暂无任务")
            return

        print("\n📋 待办事项列表:")
        for todo in self.todos:
            status = "✓" if todo['completed'] else "○"
            print(f"{status} [{todo['id']}] {todo['task']}")

    def complete_task(self, task_id):
        for todo in self.todos:
            if todo['id'] == task_id:
                todo['completed'] = True
                self.save_todos()
                print(f"✅ 任务已完成:{todo['task']}")
                return
        print(f"❌ 未找到任务 ID: {task_id}")

    def delete_task(self, task_id):
        self.todos = [t for t in self.todos if t['id'] != task_id]
        self.save_todos()
        print(f"🗑️  任务已删除")

def main():
    app = TodoApp()

    while True:
        print("\n" + "="*40)
        print("1. 添加任务")
        print("2. 查看任务")
        print("3. 完成任务")
        print("4. 删除任务")
        print("5. 退出")
        print("="*40)

        choice = input("请选择操作 (1-5): ")

        if choice == '1':
            task = input("输入任务内容: ")
            app.add_task(task)
        elif choice == '2':
            app.list_tasks()
        elif choice == '3':
            task_id = int(input("输入任务 ID: "))
            app.complete_task(task_id)
        elif choice == '4':
            task_id = int(input("输入任务 ID: "))
            app.delete_task(task_id)
        elif choice == '5':
            print("👋 再见!")
            break
        else:
            print("❌ 无效选择")

if __name__ == "__main__":
    main()

测试应用

文件创建后,你可以立即测试:

# 运行应用
python todo.py

# 预期输出:
========================================
1. 添加任务
2. 查看任务
3. 完成任务
4. 删除任务
5. 退出
========================================
请选择操作 (1-5):

进一步改进

如果你想添加更多功能,可以继续对话:

改进建议 1:

"添加任务优先级功能(高、中、低)"

改进建议 2:

"添加任务截止日期,并高亮显示即将到期的任务"

改进建议 3:

"添加任务分类功能(工作、生活、学习)"

✨ Claude Code 的优势

  • • 一次性生成完整的、可运行的代码
  • • 自动处理边界情况和错误
  • • 代码结构清晰,易于维护
  • • 支持中文注释和输出
  • • 可以持续迭代改进

💡 学习要点

  • • 审查生成的代码,理解每个函数的作用
  • • 测试各种边界情况(空列表、无效输入等)
  • • 尝试提出改进建议,看 AI 如何响应
  • • 观察 AI 如何处理你的反馈

⚠️ 重要提示

第一次使用时,Claude Code 会询问你是否允许执行操作。你可以选择:

  • 允许一次:仅本次操作生效(推荐新手)
  • 总是允许:以后不再询问(熟悉后使用)
  • 拒绝:取消本次操作

今日小结

你已经学会了:

  • Claude Code 是什么,以及它与其他 AI 编程工具的区别
  • 如何安装和配置 Claude Code
  • 执行第一个命令,让 AI 帮你写代码
  • 理解 Claude Code 的核心工作原理
  • 通过实战练习体验完整的开发流程

明天预告

在 Day 2,我们将深入学习:

  • • 如何与 Claude Code 进行高效对话
  • • 提示词(Prompt)的编写技巧
  • • 多轮对话中的上下文管理
  • • 实战:重构一个现有项目

🎓 加入云途AGI社群,获取更多学习资源

社群提供基础资源、答疑支持和陪伴式学习,帮助你更好地掌握 AI 工具

📚

基础资源

入门教程、工具指南、实战案例

💬

答疑支持

遇到问题随时提问,及时获得解答

🤝

陪伴式学习

与同行者一起成长,不再孤单学习