Claude Code 入门教程——从零安装到独立完成项目(2026最新版)

你一定有过这种经历：想重构代码但工程量太大，改 bug 改了半天找不到根因，写自动化测试更是懒得动。

Claude Code 就是来干这些脏活累活的。

它是 Anthropic 推出的终端级 AI 编程助手。直接在命令行里干活，给你的项目目录装上 AI 大脑。说白了就是——你开口，它动手。

这篇文章面向零基础开发者，从安装配置到独立完成项目，预计阅读 30 分钟，建议配合实操。

一、Claude Code 是什么？

简单讲，Claude Code 是一个跑在终端的 AI 编程工具。

五个核心特点：

▎终端原生 —— 直接在命令行里用，不用切窗口。不像 Cursor 或 VS Code 插件那样需要 IDE 环境。

▎项目感知 —— 它会自动读你的项目结构、配置文件、依赖关系。一进项目就知道你用的什么框架。

▎代码操作 —— 能创建、修改、删除文件，甚至帮你跑测试和 Git 命令。

▎自然语言 —— 跟它说人话就行。中文、英文都行，你说需求，它写代码。

▎安全可控 —— 改任何文件都需要你确认。不会偷偷摸摸改你代码。

适用场景：代码重构、修 Bug、新功能开发、代码审查、自动化测试、文档生成。几乎覆盖所有日常开发环节。

二、环境准备与安装

装之前，先确认这几样

要求	说明
Claude 订阅	至少 Claude Pro
操作系统	macOS、Linux 或 Windows 11（WSL2）
Node.js	版本 18+ （npm 安装方式需要）
终端	Terminal.app、Windows Terminal 或 Linux 终端

两种安装方式

方式一：npm 全局安装（推荐）

bash

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

方式二：官方脚本安装

bash

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

验证安装

bash

claude --version

看到版本号输出（比如 2.1.169）就说明装好了。如果报 command not found，检查 Node.js 的 bin 目录是否在 PATH 里。

首次登录

bash

claude

首次运行会让你登录 Anthropic 账号，按提示授权就行。

三、三种使用模式

Claude Code 给你三种玩法，对应不同场景：

模式	启动方式	特点	像什么
交互模式	`claude`	连续对话，能记住上下文	打电话聊天
单次执行	`claude "prompt"`	执行一次就退	发短信问问题
打印模式	`claude -p "prompt"`	只输出纯文本	只要答案不要废话

怎么选？

要连续对话？→ 交互模式。要在脚本里用？→ 单次执行。要把输出传给别的命令？→ 打印模式。拿不准？交互模式就对了。

实战演示

进到项目目录，启动：

bash

cd ~/projects/my-app claude

第一次对话：

You: 你好，介绍一下你自己 Claude: 你好！我是 Claude Code，Anthropic 开发的 AI 编程助手。我可以帮你：编写和修改代码、解释代码逻辑、修复 Bug、重构项目……

创建第一个文件：

You: 创建一个 hello.py，内容打印 "Hello Claude Code"

按回车确认，文件就生成了。验证一下：

bash

cat hello.py # 输出: print("Hello Claude Code")

退出交互模式：

•输入 /exit

•macOS/Linux：Ctrl + D

•Windows：Ctrl + Z 然后回车

四、核心命令大全（30+ 个 Slash 命令）

所有命令都以 / 开头，在交互模式下输入。

基础控制

命令	作用
`/help`	显示所有可用命令
`/exit`	退出
`/clear`	清空对话（保留 CLAUDE.md）
`/compact`	压缩对话，省 Token

上下文管理

命令	作用
`/model`	切换模型
`/effort`	调整推理深度
`/voice`	语音模式（按住空格说话）
`/context`	看当前 Token 用量

模型选择： Claude 有三个模型，各有各的定位。

模型	速度	能力	成本	上下文	适合
Haiku	最快	基础	最低	200K	简单查询
Sonnet	中等	强大	中等	200K	日常开发（推荐）
Opus	较慢	最强	最高	1M	复杂任务、关键决策

日常开发用 Sonnet，关键决策用 Opus，简单查东西用 Haiku 省钱。

会话管理

命令	作用
`/resume`	恢复之前的会话
`/export`	导出对话为文本文件
`/rename`	重命名当前会话

项目配置

命令	作用
`/init`	初始化项目配置（创建 CLAUDE.md）
`/memory`	编辑项目记忆文件
`/config`	打开统一设置界面

开发辅助

命令	作用
`/security-review`	安全审查代码改动
`/agents`	管理子代理
`/plan`	规划模式（复杂任务分解）

诊断

命令	作用
`/doctor`	系统健康检查
`/status`	查看完整状态
`/usage`	查看用量统计

五、高效输入技巧

快捷符号

符号	作用	示例
`@`	引用文件	`分析 @src/app.js`
`!`	直接跑命令	`! git status`
`#`	快速加项目规范	`# 本项目用 pnpm 不是 npm`

多行输入

方法	操作
反斜杠换行	`\` + Enter
macOS 默认	Option + Enter
配置后	Shift + Enter（需运行 `/terminal-setup`）
控制序列	Ctrl + J

快捷键速查

快捷键	作用
Ctrl + C	取消当前操作
Ctrl + D	退出
Ctrl + L	清屏
Ctrl + O	切换详细输出
Ctrl + R	反向搜索历史
Esc + Esc	打开回退菜单
Tab	切换 Extended Thinking
Option + P / Alt + P	切换模型

六、项目实战：从零搭建 Todo List CLI

空讲没意思，咱直接上手做个项目。

第 1 步：创建项目

bash

mkdir ~/projects/todo-cli cd ~/projects/todo-cli claude

第 2 步：初始化配置

You: /init

Claude 会自动分析项目结构，创建 CLAUDE.md。这个文件就是项目的"说明书"，告诉 AI 你的项目规则。

第 3 步：自然语言描述需求

You: 帮我创建一个 Todo List CLI 工具，要求： 1. 用 Python 写 2. 支持添加、删除、列出、标记完成待办事项 3. 数据存在本地 JSON 文件 4. 有命令行参数解析 5. 包含基本错误处理

Claude 会给你列出变更计划，然后创建文件（比如 todo.py），最后问你确认。按回车确认，代码就出来了。

第 4 步：运行测试

You: ! python todo.py --help You: ! python todo.py add "学习 Claude Code" You: ! python todo.py list

第 5 步：修 Bug

报错了？直接让它修：

You: 运行测试，有失败的用例请分析原因并修复

Claude 会自动调测试脚本、读错误栈、定位 Bug、修好。

第 6 步：安全审查

You: /security-review

Claude 会检查认证、注入、越权、敏感信息暴露这些问题。

第 7 步：导出记录

You: /export ./docs/development-log.md

整轮对话记录就存下来了。

七、日常开发工作流

推荐的每日流程：

bash

# 早上好，恢复昨天的会话 $ claude -c # 检查当前状态 You: /status # 开始干活 You: 我今天要完成用户认证模块 # 干到一半，查查 Token 还剩多少 You: /context # Token 用了超过 60%？压缩一下 You: /compact # 重要功能搞完了，导出对话记录 You: /export ~/docs/auth-implementation.md # 下班前重命名会话，方便明天恢复 You: /rename auth-module-day2

八、省钱技巧

Claude Code 按 Token 收费，这些技巧能省不少：

技巧	省多少
简单问题不开 Extended Thinking	~70%
定期用 `/compact`	40-60%
搞完了立马 `/clear`	100% （上下文重置）
用 Sonnet 别用 Opus	~80%
描述需求简洁点	~30%

模型搭配策略：

bash

# 简单任务：Haiku（最便宜） You: /model claude-haiku-4-5-20251001 # 日常开发：Sonnet（性价比最高） You: /model claude-sonnet-4-6 # 关键决策：Opus（最强）—— 200K 不够用？Opus 有 1M 上下文 You: /model claude-opus-4-6

九、配置别名

老敲完整命令太累，配几个别名省事。

macOS/Linux（加到 ~/.bashrc 或 ~/.zshrc）：

bash

alias cc="claude --dangerously-skip-permissions" alias cr="claude -c" alias ccv="claude --verbose" alias cco="claude --model claude-opus-4-6"

Windows PowerShell（加到 $PROFILE）：

powershell

function cc { claude --dangerously-skip-permissions } function cr { claude -c } function ccv { claude --verbose }

十、常见问题

Q：会话突然断了怎么办？

A：别慌，会话自动保存。直接 claude -c 恢复。

Q：怎么看 Claude 在干嘛？

A：启动时加 --verbose，或者运行中按 Ctrl + O 切换详细输出。

Q：怎么取消正在执行的操作？

A：按 Ctrl + C 中断。

Q：怎么更新 Claude Code？

A：运行 claude update，或者 npm update -g @anthropic-ai/claude-code。

Q：配置文件在哪？

文件	位置	作用
`CLAUDE.md`	项目根目录	项目配置
`.mcp.json`	项目根目录	MCP 服务器配置
`~/.claude/`	用户目录	全局配置
`~/.claude/commands/`	用户目录	个人 Slash 命令

十一、从零到独立项目学习路线图

阶段	内容	时间
1. 环境搭建	装 Node.js、Claude Code、配 API Key	30 分钟
2. 基础交互	交互模式、第一次对话、三种模式实践	1 小时
3. 核心命令	掌握 10+ Slash 命令、文件引用、模型切换	2 小时
4. 项目实战	创建 CLAUDE.md、自然语言实现功能、代码审查	3 小时
5. 效率提升	配置别名、Rewind 回退、Hooks 自动化、MCP 集成	2 小时
6. 独立项目	从零搭完整项目、多文件协作、自动化测试	2 小时

练手项目推荐：

•Todo List CLI 工具

•简易博客系统

•API 接口文档生成器

•代码统计工具

•自动化部署脚本

十二、总结

到这里你学会了：

•安装配置 —— npm 或官方脚本，5 分钟搞定

•三种模式 —— 交互式、单次执行、打印模式，按场景选

•30 多个 Slash 命令 —— 从 /help 到 /plan，覆盖一切

•快捷键操作 —— 输入、导航、调试，效率拉满

•完整项目实战 —— 从零搭了一个 Todo List CLI

•工作流与省钱 —— 日常流程 + 省 70-80% 的 Token

记住：最好的学习方式就是上手。打开终端，敲 claude，从一个最小项目开始。

参考资源：

•Claude Code 官方文档：docs.anthropic.com/claude-code

•GitHub 仓库：github.com/anthropics/claude-code

•老金的 Claude Code 基础使用完整指南

*版本信息：本文基于 Claude Code v2.1.169（2026 年 6 月）编写*