Claude Code从安装到使用的保姆级教程

还在手动一行一行敲代码？Anthropic推出的Claude Code，让你用自然语言指挥AI直接改代码仓库，效率直接翻10倍。今天这篇，从零开始手把手带你装好、用熟。

◆一、Claude Code 是什么？

一句话：Claude Code 是一个能在终端里直接读你整个代码仓库、理解结构、并执行修改的AI编程助手。

它不是聊天框，不是代码补全插件，而是一个真正的"工程师型AI"——你下指令，它写代码。

它能做什么？

重构一个老项目，跨文件批量修改
给整个仓库加新功能，自动处理依赖关系
修一个跨模块的Bug，找到根因并修复
跑测试、改失败的地方
把产品需求直接变成多文件改动

它和Cursor的区别？

维度	Claude Code	Cursor
形态	终端CLI / Agent	IDE
使用方式	命令行驱动	编辑器内
主控逻辑	AI主导，你下指令	人主导，AI辅助
自动化程度	极高	中等

简单说：Cursor是你写代码，AI帮你；Claude Code是你下指令，AI写代码。

◆二、安装前的准备

在安装Claude Code之前，确保你的电脑已经具备以下条件：

1. Node.js 18+

Claude Code 通过 npm 安装，需要 Node.js 环境。

检查是否已安装：

node --version

如果版本号 ≥ 18，跳过这步。如果没有：

macOS: brew install node
Windows: 去 nodejs.org 下载安装包
Linux: sudo apt install nodejs npm

2. Anthropic 账号 + API Key

Claude Code 需要调用 Anthropic 的 API，你必须有：

一个 Anthropic 账号（注册地址：https://console.anthropic.com/）
一个有效的 API Key

注册后在控制台的 API Keys 页面创建即可。

3. 稳定的网络环境

由于 API 服务器在海外，需要确保网络能正常访问 api.anthropic.com。

◆三、5分钟安装 Claude Code

打开终端，一行命令搞定：

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

安装完成后，验证：

claude --version

看到版本号输出，说明安装成功。

国内用户加速安装

如果 npm 下载慢，可以用镜像源：

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

◆四、首次启动与登录

1. 启动 Claude Code

在你的项目目录下运行：

cd your-project
claude

首次启动会看到欢迎界面。

2. 登录 Anthropic 账号

有两种方式：

方式A：浏览器登录（推荐）

claude /login

会自动打开浏览器，授权后回到终端即可。

方式B：API Key 登录

设置环境变量：

export ANTHROPIC_API_KEY=sk-ant-xxxxx

建议把这行加到 ~/.zshrc 或 ~/.bashrc 中，避免每次手动输入。

3. 诊断环境

登录后，先跑一遍诊断：

claude /doctor

它会检查 Node 版本、API 连通性、权限配置等，全部绿色通过就可以开始用了。

◆五、核心使用方法

5.1 基本对话：用自然语言编程

进入 Claude Code 后，直接输入你的需求：

> 帮我给这个项目加一个用户注册功能，包含邮箱验证

Claude Code 会：

读取项目结构，理解框架和依赖
规划需要修改的文件
逐个文件执行修改
展示改动摘要，等待你确认

5.2 最常用的7个命令

这些命令日常必用，建议收藏：

命令	功能	什么时候用
`/clear`	清除对话历史	开始新任务前、上下文快满时
`/model`	切换模型	简单任务用Haiku省钱，复杂任务切Opus
`/cost`	查看Token用量	控制成本，判断是否需要/clear
`/diff`	查看代码改动	提交前逐文件审查
`/rewind`	回退到历史节点	代码改错了、思路走偏时
`/memory`	编辑项目记忆	沉淀项目规范和团队约定
`/compact`	压缩当前对话	对话过长但不想丢弃上下文

5.3 项目记忆：CLAUDE.md

Claude Code 有一个独特的"记忆"机制。在你的项目根目录创建 CLAUDE.md，写入项目规范：

# 项目规范

- 使用 TypeScript strict 模式
- API 路由统一放在 src/routes/ 下
- 数据库操作必须走 MyBatis XML
- 所有接口必须有错误处理

每次 Claude Code 启动时，会自动读取这个文件，按照你的规范来写代码。你可以用 /memory 命令随时编辑。

5.4 计划模式：先规划再动手

面对复杂需求，别急着让AI动手，先用计划模式：

> /plan
> 重构订单模块，把单体拆成微服务

Claude Code 会先出方案，你确认后再执行。避免AI一顿猛改、改完发现方向错了。

◆六、实战案例：5个真实场景

场景1：给老项目加新功能

> 帮我加一个导出PDF的功能，支持表格和图片

Claude Code 会自动找出现有的导出逻辑、依赖库，然后在合适的位置加入PDF导出功能。

场景2：跨模块Bug修复

> 用户反馈下单后偶尔收不到通知，帮我排查修复

它会从订单模块→消息队列→通知服务，逐层追踪，找到根因并修复。

场景3：代码重构

> 把 UserService 里的所有静态方法改成实例方法，改成依赖注入

Claude Code 理解整个调用链，批量修改所有引用点。

场景4：写测试

> 给 src/utils/ 下所有工具函数写单元测试，覆盖率至少80%

自动分析函数签名和边界情况，生成测试用例。

场景5：代码审查

> /diff

查看所有改动，逐文件审查是否有遗漏或风险。

◆七、省钱技巧

Claude Code 按 Token 计费，几个技巧帮你控制成本：

用 /model 切换模型：写注释、简单改动用 Haiku（便宜），架构设计用 Opus（贵但强）
及时 /clear：完成一个模块后清空上下文，避免Token浪费
用 /compact 压缩：对话很长但还需要上下文时，压缩比清空更省
写好 CLAUDE.md：减少重复沟通项目规范的成本
先 /plan 再动手：避免方向错误导致反复修改

◆八、常见问题

Q：国内能用吗？

A：能用，但需要解决API访问问题。两种方案：一是使用代理/VPN确保能访问 api.anthropic.com；二是通过环境变量设置代理：

export HTTPS_PROXY=http://127.0.0.1:7890

Q：免费额度有多少？

A：新注册账号有免费API额度（具体以Anthropic官网为准），日常轻度使用够用。重度使用建议购买API套餐。

Q：支持哪些编程语言？

A：几乎所有主流语言都支持——Python、JavaScript/TypeScript、Java、Go、Rust、C++等。它不是针对某种语言的插件，而是能理解任意代码仓库的AI。

Q：会自动提交代码吗？

A：不会。Claude Code 默认只修改文件，不会自动 git commit。你可以在审查改动后自己决定是否提交。

Q：和GitHub Copilot比怎么样？

A：Copilot是代码补全，Claude Code是代码Agent。Copilot帮你写一行，Claude Code帮你完成一整个任务。两者定位不同，可以搭配使用。

◆写在最后

Claude Code 代表了AI编程的新范式——从"AI辅助你写代码"到"AI替你写代码，你来审查"。它不是要取代程序员，而是把程序员从重复劳动中解放出来，专注于架构设计和业务逻辑。

如果你还在手动搬砖，今天就开始试试 Claude Code 吧。

关注「搞机小咖秀」，获取更多AI实战教程和效率工具测评。