Claude Code
15分钟入门指南

1.1 安装 Claude Code

方案一（官方推荐）

无需提前安装 Node.js，一键安装更简单！

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

方案二（Node.js）

1. 安装 Node.js：nodejs.org

2. 安装 Claude Code：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

1.2 你需要一个 Claude 账号

Claude Code 和大模型的关系，就像手机和运营商的关系。

1.3 安装 VS Code 插件

第一步：安装 VS Code

访问 code.visualstudio.com 下载安装

第二步：安装 Claude Code 插件

点击链接或搜索 "Claude Code" 安装

1.4 安装 cc-switch

使用 cc-switch 配置 API 更方便：

• GitHub 下载
• 在 cc Switch 中勾选"应用到 Claude Code 插件"
• 重新启动 VS Code

开启全自动模式

在 cc 插件里开启"Allow Dangerously Skip Permissions"，CC 能自动运行命令，无需二次确认。

1.5 自定义 API 接入（进阶）

通过 3 行环境变量，让 Claude Code 支持 OpenAI、Gemini、Grok 等百款顶级模型。

🔧 安装步骤

1. 系统要求

• 💻 系统：Mac / Linux / Windows (WSL)
• 🔧 软件：Node.js 18+
• 🔑 API密钥：获取API密钥

2. 配置环境变量

在你的 shell 配置文件中添加以下内容：

export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://api.example.com/v1"
export ANTHROPIC_MODEL="gpt-5.4"

$env:ANTHROPIC_API_KEY="your-api-key"
$env:ANTHROPIC_BASE_URL="https://api.example.com/v1"
$env:ANTHROPIC_MODEL="gpt-5.4"

3. 支持的模型

2.1 我们要做什么？

我建议第一个项目做「待办清单」。

• 够简单，15 分钟能完成
• 够实用，做完了真的能用
• 够完整，该有的功能都有（增删改查）

最终效果：

• 添加任务
• 标记任务完成
• 删除任务
• 界面干净好看

2.2 创建项目文件夹

mkdir my-todo-app
cd my-todo-app
claude

2.3 最重要的一步：先规划再动手

复制这段话，发给 Claude：

我想做一个待办清单网页，要求：
1. 可以添加新任务（输入框+添加按钮）
2. 可以点击任务标记为完成（会有划线效果）
3. 可以删除任务（每个任务旁边有删除按钮）
4. 界面要简洁美观，用现代化的设计

请先给我一个实现计划，包括用什么技术、分几个文件、大概的实现步骤，等我确认后再开始写代码。

2.4 看着代码自己写出来

这是最神奇的部分。你会看到 Claude 开始自己工作：

• 创建 index.html 文件
• 写入 HTML 代码
• 创建 style.css 文件
• 写入样式代码
• 创建 script.js 文件
• 写入交互逻辑

整个过程你什么都不用做。就像看着一个程序员在你的电脑上工作。

大概 2-3 分钟，所有代码就写完了。

2.5 打开浏览器看效果

Mac 用户：直接在 Finder 里找到 my-todo-app 文件夹，双击 index.html

Windows 用户：在文件资源管理器里找到这个文件夹，双击 index.html

3.1 提一个新需求

假设你想给每个任务加上时间戳，显示是什么时候添加的。

直接在 Claude Code 里说：

我想给每个任务加上创建时间，格式是「2025-11-10 15:30」，显示在任务文字的下面，用小字灰色显示

3.2 Claude 会自动修改

Claude 会：

• 告诉你需要改哪些地方
• 自动修改 script.js 添加时间记录逻辑
• 自动修改 style.css 添加时间显示的样式

你只需要刷新浏览器，新功能就生效了。

3.3 试试其他功能

你还可以尝试：

• 「加一个优先级标签，重要的任务显示红色」
• 「加一个全部删除按钮」
• 「换一个配色方案，我想要蓝色系」

每次 Claude 都会理解你的意思，自动改代码。

Q1：改错了怎么办？

别慌，Claude Code 有「时光机」功能。

方法一：按 ESC 两次快速回退

方法二：输入命令 /rewind

方法三：直接说"刚才那个改动我不喜欢，还原回去"

Q2：我完全不懂代码，怎么知道 Claude 做的对不对？

答案：你不需要懂代码，你只需要测试功能。

就像你不需要懂汽车发动机，也能知道车能不能开。

• 添加任务试试，能加上吗？
• 标记完成试试，有划线吗？
• 删除试试，真的删掉了吗？
• 刷新页面，数据还在吗？

功能对了，代码就是对的。

Q3：为什么有些教程说要装 Node.js？

简单回答：如果你用的是我推荐的安装方式（curl 或 PowerShell 一键安装），就不需要 Node.js。

完整解释：Claude Code 有多种安装方式。如果用 NPM 方式，需要先装 Node.js。但一键安装方式已经把所有依赖打包好了，直接用就行。

Q4：我应该从这个开始学编程吗？

如果你想快速做出东西：

• 从 Claude Code 开始是对的
• 边做边学，有问题就问 Claude
• 遇到不懂的概念，让 Claude 解释

如果你想成为专业开发者：

• Claude Code 是很好的辅助，但不能替代系统学习
• 建议路径：用 AI 做出第一个项目（建立信心）→ 系统学习基础（CS50、FreeCodeCamp）→ 再用 AI 加速开发