Claude Code 零基础上手教程(2026 版)

Claude Code 是什么

Claude Code 是 2024 年底 Anthropic 推出的官方 CLI。安装后在任意项目目录下跑 claude, 进入一个交互式 Agent 会话。与 ChatGPT 的网页版或 Cursor 的 IDE 集成不同,Claude Code 的核心定位是:

• 终端优先:零 IDE 依赖,ssh 到服务器也能用
• Agent 模式:一句话任务 → Claude 自主规划 + 执行
• 工具权限可控:每个危险操作(写文件、跑命令)都要确认
• MCP 扩展:通过 Model Context Protocol 挂接自定义工具

安装

环境要求:Node.js 18+、macOS / Linux / WSL2。

# 全局安装
npm install -g @anthropic-ai/claude-code

# 进入项目目录
cd ~/my-project
claude

# 首次启动会引导登录(Claude Pro/Max 订阅或 API key)

登录方式:推荐用 Claude Pro/Max 订阅登录(按用量计费走订阅配额),而不是 API key(按 token 单独计费,贵)。

第一个任务

进入一个 React 项目后试:

> 帮我看看这个项目是做什么的,写一个简短的 README

Claude 会:读 package.json → 读核心源文件 → 读路由 → 生成 README.md。过程中每次读文件会提示你确认(可记住)。

权限模型

Claude Code 的权限是按工具 + 按路径的,第一次用某个工具会问:

• Read:读文件,默认全允许(可 scope 到目录)
• Write / Edit:写文件,逐次或整项目级允许
• Bash:执行命令,每次都会 diff 命令内容让你确认
• WebFetch:访问网站

推荐配置:~/.claude/settings.json 里设置 {"permissions": {"allow": ["Read(/Users/me/projects/**)"], "ask": ["Bash(*)"]}}, 读全允许,写/跑命令始终问。

典型工作流

1. 修 Bug

> 用户反馈点击登录按钮偶尔报 500,帮我查一下

Claude 会:
- grep 登录接口代码
- 读 error handler
- 检查 log 目录
- 定位问题 + 提出修复方案
- 你确认后自动 edit + 跑测试

2. 加新功能

> 给用户设置页加一个"导出所有数据为 JSON"按钮,
> 前端 + 后端接口都要

3. 重构

> 把 src/utils/ 下所有函数迁移到 TypeScript

4. 代码审查

> git diff main..feature-branch 里有没有明显问题

CLAUDE.md:项目级记忆

在项目根目录放一个 CLAUDE.md,里面写:

• 技术栈、编码规范
• 项目结构、关键目录
• 常用命令(npm test、npm run lint)
• 禁忌(不要改 migrations/、不要升级 React 等)

Claude 每次启动会自动读这个文件当系统提示。这是提升效果最简单的操作。

MCP:扩展工具能力

Model Context Protocol 是 Anthropic 开源的"工具接入标准"。社区已经有:

• mcp-github:直接读写 GitHub repo/issue/PR
• mcp-postgres:直接查询数据库
• mcp-playwright:浏览器自动化
• mcp-figma:Figma 设计文件读写

安装后在 ~/.claude/mcp_servers.json 配置,Claude Code 启动就多了新工具。参考 modelcontextprotocol.io。

Claude Code vs Cursor vs Copilot

三者可以组合:Copilot 行内补全 + Cursor 局部改 + Claude Code 做大任务。

用量与订阅

Claude Code 消耗走订阅配额,不单独计费:

• Pro $20/月:每周约 5-10 小时高强度编程
• Max 5x $100/月:每周约 40-80 小时
• Max 20x $200/月:基本不限

中国用户可通过 ClaudeMax 代购订阅,¥210 起。

常见坑

• 大型项目上下文爆炸:在 CLAUDE.md 明确指定"只读 src/,忽略 dist/"
• 误删文件:永远开 Bash 确认,或用 git worktree 隔离
• 幻觉依赖:让 Claude 装库前先让它跑 npm view 确认存在
• 长对话遗忘:超过 150K tokens 后记得 /compact 或开新会话

相关

• Claude Sonnet 4.5 深度评测
• Claude Pro vs Max 5x 对比
• 中国用户如何订阅 Claude Pro