普通人如何从零开始用上Claude Code:小白入门全教程(2025最新版)

普通人如何从零开始用上Claude Code:小白入门全教程(2025最新版)

想用AI帮你写代码、改bug、做项目,但不知从何下手?Claude Code是目前最强的AI编程助手之一,但它运行在命令行中,让不少普通用户望而却步。别怕!本文从完全零基础出发,手把手带你完成每一步。

一、Claude Code 是什么?为什么值得用?

Claude Code 是 Anthropic 公司推出的 AI 编程助手,运行在你的终端(命令行)里。它不是图形界面软件,而是你和 AI 通过对话来共同编程的工具。

简单说:你在终端里告诉 Claude Code 你想做什么(比如”帮我创建一个个人博客网站”),它就能直接帮你写代码、创建文件、调试错误。

它最厉害的地方:

  • ✅ 能直接读写你的文件,修改你的项目代码
  • ✅ 能执行终端命令(安装依赖、运行测试等)
  • ✅ 上下文理解能力极强,能处理大型项目
  • ✅ 支持多种编程语言和框架
  • ✅ 支持第三方模型(比如接入 DeepSeek 节约成本)

收费吗? Claude Code 本身免费使用,但需要 Anthropic API Key(按使用量付费)或接入其他模型。新用户注册 Anthropic 通常会送 $5 免费额度。


二、准备工作:你需要的三样东西

1. 一台电脑

  • Windows 10/11macOSLinux 都可以
  • 至少 8GB 内存(推荐 16GB)
  • 有网络连接

2. 安装 Node.js(必需)

Claude Code 基于 Node.js 运行,所以第一步是在你的电脑上装 Node.js。

Windows 用户:

  • 打开浏览器,访问 https://nodejs.org
  • 下载 LTS 版本(长期支持版,更稳定),比如 Node.js 20.x 或 22.x
  • 双击下载的 .msi 安装包,一路点”Next”完成安装
  • ⚠️ 安装时确保勾选 “Add to PATH” 选项
  • Mac 用户:

  • 同样访问 https://nodejs.org 下载 LTS 版本的 .pkg 安装包
  • 双击安装,一路点”继续”即可
  • 或者如果你装了 Homebrew,在终端运行:brew install node
  • 验证安装是否成功:

    打开终端(Windows 按 Win+R 输入 cmd 回车;Mac 打开”终端”应用),输入:

    node --version
    

    如果看到类似 v20.11.0 的版本号,说明安装成功!再验证 npm:

    npm --version
    

    看到版本号(如 10.8.0)就OK了。

    3. 一个 Anthropic 账号和 API Key

  • 打开 https://console.anthropic.com
  • 点”Sign Up”注册账号(用 Google 账号或邮箱都可以)
  • 登录后,在左侧菜单找到 “API Keys”
  • 点击 “Create Key”,给 Key 起个名字(比如 my-claude-code
  • ⚠️ 立刻复制保存! 这个 Key 只显示一次,关闭页面后就看不到了
  • 新用户通常有 $5 免费额度,够用一阵子了

  • 三、安装 Claude Code(核心步骤)

    打开终端,输入下面这行命令并回车:

    npm install -g @anthropic-ai/claude-code
    

    这个命令的含义:

    • npm install:用 npm 安装软件包
    • -g:全局安装,装完在任何目录都能用
    • @anthropic-ai/claude-code:Claude Code 的包名

    安装过程可能需要 1-3 分钟,期间会下载依赖包。如果网络慢可以挂代理或者多试几次。

    验证安装:

    claude --version
    

    看到版本号就说明安装成功!

    常见安装问题排查

    问题 解决方案
    npm: command not found Node.js 没装好,重新安装并确保勾选”Add to PATH”
    安装报权限错误 (EACCES) Mac/Linux 用户加 sudosudo npm install -g @anthropic-ai/claude-code
    下载很慢/超时 设置 npm 镜像:npm config set registry https://registry.npmmirror.com
    Windows 提示执行策略限制 以管理员身份运行 PowerShell,执行 Set-ExecutionPolicy RemoteSigned

    四、配置 API Key 并启动

    安装好之后,还需要让 Claude Code 知道你的 API Key。有两种方式:

    方式一:环境变量(推荐)

    Windows (PowerShell):

    $env:ANTHROPIC_API_KEY="sk-ant-你的API密钥"
    

    Mac/Linux (终端):

    export ANTHROPIC_API_KEY="sk-ant-你的API密钥"
    

    ⚠️ 这种方式只在当前终端窗口有效,关闭窗口就失效了。适合临时使用。

    方式二:永久配置(推荐长期使用)

    Windows:

  • Win+R,输入 sysdm.cpl 回车
  • 点”高级”→”环境变量”
  • 在”用户变量”中新建:
  • – 变量名:ANTHROPIC_API_KEY
    – 变量值:sk-ant-你的API密钥

  • 确定保存,重启终端生效
  • Mac/Linux:
    在终端中编辑配置文件:

    echo 'export ANTHROPIC_API_KEY="sk-ant-你的API密钥"' >> ~/.zshrc
    source ~/.zshrc
    

    Mac 新系统默认用 zsh,如果你用 bash 就改 ~/.bash_profile

    启动 Claude Code!

    配置好后,在终端输入:

    claude
    

    首次启动会进行一些初始化设置,然后你就会看到 Claude Code 的交互界面!此时你可以直接打字和 Claude 对话了。

    试试输入:

    帮我写一个 Hello World 的 Python 脚本

    Claude Code 会直接在当前目录创建文件并写入代码。


    五、你的第一个 AI 编程任务

    让我们用一个完整的例子来体验 Claude Code 的能力。

    任务:用 Claude Code 创建一个个人名片网页

  • 创建项目文件夹:
  • mkdir my-card
    cd my-card
    
  • 启动 Claude Code:
  • claude
    
  • 告诉 Claude 你的需求:
  • 帮我创建一个个人名片网页,包含:
    
    • 我的名字:张三
    • 职位:全栈工程师
    • 联系方式:zhangsan@email.com
    • 技能标签:Python、React、Node.js
    • 设计要简洁大方,用纯 HTML+CSS 实现
    • 文件名为 index.html
  • Claude 会自动帮你:
  • – 创建 index.html 文件
    – 编写好 HTML 结构和 CSS 样式
    – 你只需用浏览器打开这个文件就能看到效果

  • 不满意?继续提需求:
  • 帮我把背景改成渐变色,加一个头像占位圆圈
    

    Claude 会直接修改文件,你刷新浏览器就能看到变化。


    六、Claude Code 的基本用法

    常用命令

    命令 作用
    claude 启动交互模式
    claude "你的问题" 单次提问(不进入交互模式)
    claude --model opus 指定使用 Opus 模型(更强但更贵)
    claude --model sonnet 指定使用 Sonnet 模型(性价比之选)
    claude /help 查看帮助
    /clear 清空当前对话
    /compact 压缩上下文(对话太长时用)

    进阶功能

    1. 读取图片/文件:
    直接把图片拖进终端,Claude 能看懂图片内容(比如设计稿转代码)。

    2. 管理多个会话:

    claude --resume   # 恢复上次的对话
    claude --list     # 列出所有会话
    

    3. 接入第三方模型:
    Claude Code 支持接入 DeepSeek 等第三方模型来降低成本(后面有专门教程)。


    七、费用控制:别让API账单吓到你

    API 费用是怎么算的?

    Anthropic 按 token(词元)计费,简单理解:

    • 输入 token:你发给 AI 的内容(包括对话历史和项目文件)
    • 输出 token:AI 生成的回复

    不同模型的价格不同(以官方最新定价为准):

    模型 输入 (每百万token) 输出 (每百万token) 特点
    Claude Opus 4 $15 $75 最强大,适合复杂任务
    Claude Sonnet 4 $3 $15 性价比高,日常够用
    Claude Haiku 4 $0.80 $4 最快最便宜,简单任务

    普通用户日均开销参考:

    • 轻度使用(偶尔问问题):$0.5-2/天
    • 中度使用(日常编程辅助):$2-5/天
    • 重度使用(全时代码生成):$5-20/天

    省钱技巧

  • 日常用 Sonnet 模型,复杂任务才切 Opus
  • 善用 /compact 命令压缩长对话,减少输入 token
  • 小任务用单次模式claude "简要问题" 而不是开交互会话
  • 在 Anthropic Console 设置月度消费上限,防止超支
  • 接入 DeepSeek 等低成本模型(后续教程会讲)

  • 八、常见问题 FAQ

    Q1: Claude Code 和 ChatGPT 有什么区别?

    Claude Code 专注于编程场景,能直接操作你的本地文件系统和终端;ChatGPT 是通用对话 AI,不能直接操作你的文件。Claude Code 更适合写代码、管理项目。

    Q2: 不会编程能用 Claude Code 吗?

    能用,但效果有限。如果你完全零基础,Claude Code 可以帮你写简单脚本、生成网页等。但要充分发挥它的能力,建议至少掌握基础的命令行操作。

    Q3: Claude Code 能写中文吗?

    完全可以。Claude 的中文能力非常强,你可以全程用中文和它交流。

    Q4: 我的代码会被 Anthropic 看到吗?

    根据 Anthropic 的隐私政策,API 调用内容默认不会被用于训练。如果你处理敏感代码,建议查阅最新的数据使用条款。

    Q5: 能离线使用吗?

    不能。Claude Code 必须联网,因为 AI 推理在云端完成。

    Q6: 支持哪些编程语言?

    几乎所有主流语言:Python、JavaScript/TypeScript、Java、Go、Rust、C/C++、HTML/CSS、SQL 等都支持得很好。


    总结:开启你的 AI 编程之旅

    恭喜你!现在你已经知道如何:

  • ✅ 安装 Node.js 环境
  • ✅ 获取 Anthropic API Key
  • ✅ 安装并配置 Claude Code
  • ✅ 完成第一个 AI 编程任务
  • ✅ 控制费用和切换模型
  • Claude Code 是一个强大的 AI 编程伙伴,但它只是一款工具。真正重要的是你用它来创造什么。从小项目开始,边用边学,你很快就会发现:有 AI 帮忙的编程,和以前完全不同。

    下一步可以做什么?

    • 🚀 用 Claude Code 搭建你的个人博客
    • 🔧 让它帮你分析和修改现有项目代码
    • 📚 接上 DeepSeek 模型降低使用成本(见后续教程)
    • 💡 学习 Claude Code 的进阶技巧(见后续教程)

    有问题?在评论区留言,我们一起交流!


    免责声明:本文基于 2025 年 6 月的信息撰写,产品功能、定价可能有变化,请以官方文档为准。本文由作者实操验证后撰写,AI 辅助编辑。

    获取每周AI编程技巧

    每周2篇实战教程,不废话、不刷屏、可随时退订

    已准备好为你服务

    发表评论

    您的邮箱地址不会被公开。 必填项已用 * 标注

    滚动至顶部