Claude Code 是 Anthropic 推出的 AI 编程助手，可以读取你的代码库、修改文件、运行命令，真正理解整个项目上下文。本文从安装开始，带你完成第一个真实任务。
Claude Code 是什么？
Claude Code 不是一个聊天机器人，而是一个自主编程代理：
- 读取你的代码库，理解整体架构
- 跨多个文件规划并实现功能
- 运行测试、修复失败
- 直接与 Git 交互（提交、创建 PR）
- 支持 Terminal、VS Code、JetBrains、桌面 App、浏览器多端
安装
macOS / Linux / WSL
bash
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell
powershell
irm https://claude.ai/install.ps1 | iexHomebrew（macOS）
bash
brew install --cask claude-codeWinGet
powershell
winget install Anthropic.ClaudeCodeWindows 用户需要先安装 Git for Windows。
安装完成后首次运行会提示登录，需要 Claude 订阅或 Anthropic Console 账号。
第一次启动
bash
cd your-project
claude就这么简单。Claude Code 会自动扫描当前目录，读取项目结构。
第一个真实任务：修复 Bug
我运行 npm test 时出现这个错误：[粘贴错误信息]
找到根本原因并修复，然后确认测试通过
Claude Code 会：
- 读取错误堆栈，定位相关文件
- 分析根因（不是掩盖错误）
- 修改代码
- 重新运行测试验证
核心工作流：探索 → 规划 → 实现
Plan Mode（推荐）
对于复杂任务，先用 Plan Mode 探索和规划，再执行：
bash
# 启动时进入 Plan Mode
claude --permission-mode plan或在会话中按 Shift+Tab 切换。
四步流程：
Step 1 探索（Plan Mode 中）
读取 /src/auth，理解 Session 和登录是如何处理的
Step 2 规划
我要添加 Google OAuth。哪些文件需要修改？Session 流程是什么？制定一个计划
Step 3 实现（切回 Normal Mode）
按计划实现 OAuth 流程。为回调 Handler 写测试，运行测试套件并修复失败
Step 4 提交
用描述性 commit message 提交，并创建 PR
五大高频使用场景
1. 理解新代码库
加入新项目时：
给我一个这个代码库的概览
解释这里使用的主要架构模式
数据模型是什么？
认证是如何处理的？
2. 自动化写测试
为 auth 模块写测试，运行并修复所有失败
为 foo.py 写测试，覆盖用户已登出的边缘情况。不要用 mock
3. 代码重构
找出代码库中已废弃的 API 用法
建议将 utils.js 重构为使用现代 JavaScript 特性的方案
将 utils.js 重构为 ES2024 特性，同时保持相同行为
4. 创建 PR
用描述性 commit message 提交我的改动
Claude Code 直接操作 Git，暂存文件、写 commit message、创建分支和 PR。
5. Unix 管道集成
bash
# 监控日志，检测异常就通知
tail -f app.log | claude -p "如果发现异常就通知我"
# CI 中自动翻译
claude -p "将新字符串翻译为法语并创建 PR"
# 批量操作
git diff main --name-only | claude -p "对这些改动的文件做安全审查"CLAUDE.md：给 Claude 持久记忆
在项目根目录创建 CLAUDE.md，Claude 每次会话都会读取：
bash
claude /init # 自动生成基础 CLAUDE.md示例内容：
markdown
# 代码规范
- 使用 ES modules (import/export)，不用 CommonJS (require)
- 尽量解构导入
# 工作流
- 修改完成后记得 typecheck
- 优先跑单个测试，不跑整个测试套件（速度）只写通用的、每次都适用的规则。特定领域知识用 Skills 按需加载。
给 Claude 验证自己工作的方法
这是最高杠杆的操作。有测试用例，Claude 表现大幅提升：
写一个 validateEmail 函数。
测试用例：foo@bar.com 为 true，invalid 为 false，foo@bar 为 false。
实现完成后运行测试。
对比模糊提示："写一个验证 email 的函数" — 缺乏验证标准，Claude 可能产出看起来正确但实际有问题的代码。
管理上下文窗口
最重要的资源：Claude 的上下文窗口会随对话积累而填满，性能随之下降。
- 用
/status查看上下文使用量 - 工作区分块：
/clear开始新 Session，专注当前任务 - 子代理并行：对大型任务用多个 Claude 实例分工处理不同文件
支持的平台
| 平台 | 适用场景 |
|---|---|
| Terminal CLI | 全功能，开发主力 |
| VS Code 扩展 | 内联 Diff，@提及，历史记录 |
| JetBrains 插件 | IntelliJ/PyCharm/WebStorm |
| 桌面 App | 可视化 Diff，多 Session 并行 |
| 浏览器（claude.ai/code） | 无需本地安装，随时随地 |
| Remote Control | 手机/平板远程继续会话 |
来源：Claude Code Docs + Best Practices | Anthropic 官方文档