普通人如何从零开始用上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/11、macOS、Linux 都可以
- 至少 8GB 内存(推荐 16GB)
- 有网络连接
2. 安装 Node.js(必需)
Claude Code 基于 Node.js 运行,所以第一步是在你的电脑上装 Node.js。
Windows 用户:
.msi 安装包,一路点”Next”完成安装Mac 用户:
.pkg 安装包brew install node验证安装是否成功:
打开终端(Windows 按 Win+R 输入 cmd 回车;Mac 打开”终端”应用),输入:
node --version
如果看到类似 v20.11.0 的版本号,说明安装成功!再验证 npm:
npm --version
看到版本号(如 10.8.0)就OK了。
3. 一个 Anthropic 账号和 API Key
my-claude-code)三、安装 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 用户加 sudo:sudo 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
帮我创建一个个人名片网页,包含:
- 我的名字:张三
- 职位:全栈工程师
- 联系方式:zhangsan@email.com
- 技能标签:Python、React、Node.js
- 设计要简洁大方,用纯 HTML+CSS 实现
- 文件名为 index.html
– 创建 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/天
省钱技巧
/compact 命令压缩长对话,减少输入 tokenclaude "简要问题" 而不是开交互会话八、常见问题 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 编程之旅
恭喜你!现在你已经知道如何:
Claude Code 是一个强大的 AI 编程伙伴,但它只是一款工具。真正重要的是你用它来创造什么。从小项目开始,边用边学,你很快就会发现:有 AI 帮忙的编程,和以前完全不同。
下一步可以做什么?
- 🚀 用 Claude Code 搭建你的个人博客
- 🔧 让它帮你分析和修改现有项目代码
- 📚 接上 DeepSeek 模型降低使用成本(见后续教程)
- 💡 学习 Claude Code 的进阶技巧(见后续教程)
有问题?在评论区留言,我们一起交流!
免责声明:本文基于 2025 年 6 月的信息撰写,产品功能、定价可能有变化,请以官方文档为准。本文由作者实操验证后撰写,AI 辅助编辑。