Claude CLI 使用指南（Step by Step）

这是一篇从 0 到 1 的 Claude CLI 使用实战文章，适合：

想把 Claude 当成「终端里的 AI 工程师」
希望用 AI 辅助写代码、改代码、分析项目
不想再频繁复制粘贴到网页聊天框的开发者

一、Claude CLI 是什么？

Claude CLI 是 Anthropic 官方提供的命令行工具，让你可以在终端里直接使用 Claude（AI 大模型），用于：

阅读 / 分析整个代码仓库
自动生成或修改代码
写技术文档、README、注释
做架构分析、Bug 排查

一句话总结：

把 Claude 变成你项目目录里的"智能合伙人"

二、使用前准备（Prerequisites）

1️⃣ 环境要求

Node.js ≥ 18（推荐 20+）
macOS / Linux / Windows（WSL 推荐）

检查 Node 版本：

复制代码

node -v

三、安装 Claude CLI

在终端执行：

bash 复制代码

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

安装完成后验证：

css 复制代码

claude --version

如果能看到版本号，说明安装成功 ✅

四、登录 / 配置 API Key

方式一：交互式登录（推荐）

复制代码

claude login

CLI 会引导你：

打开浏览器
登录 Anthropic 账号
授权 CLI

方式二：手动设置 API Key

ini 复制代码

export ANTHROPIC_API_KEY="sk-xxxx"

（Windows PowerShell）

ini 复制代码

$env:ANTHROPIC_API_KEY="sk-xxxx"

1️⃣ 直接对话

五、最基础的用法（Hello World）

arduino 复制代码

claude "用一句话解释什么是微服务"

Claude 会直接返回答案。

2️⃣ 多行输入（适合复杂问题）

bash 复制代码

claude <<EOF
请你扮演一名资深 Java 架构师
分析 Spring Boot 项目中常见的性能瓶颈
EOF

六、在项目中使用 Claude（核心玩法）

1️⃣ 进入你的项目目录

bash 复制代码

cd your-project

Claude CLI 会自动感知当前目录结构和代码文件。

2️⃣ 让 Claude 读代码

arduino 复制代码

claude "请分析当前项目的整体架构"


claude "这个项目中有哪些潜在的技术债？"

3️⃣ 针对某个文件提问

css 复制代码

claude "分析 src/main/java/UserService.java 的设计问题"

七、让 Claude 帮你改代码（高阶）

1️⃣ 生成修改建议（不直接改）

arduino 复制代码

claude "帮我重构这个项目中的异常处理逻辑，并说明原因"

2️⃣ 自动生成 Patch（Diff）

arduino 复制代码

claude --apply "为这个 Spring Boot 项目增加全局异常处理"

CLI 会：

生成 diff
询问你是否确认应用

非常适合结对编程（AI Pair Programming）。

八、常用实战场景示例

✅ 1. 生成 README

arduino 复制代码

claude "为当前项目生成一份专业的 README.md"

✅ 2. 写单元测试

arduino 复制代码

claude "为 UserService 编写完整的 JUnit5 单元测试"

✅ 3. 代码评审（Code Review）

arduino 复制代码

claude "请以资深 Reviewer 视角 Review 当前代码"

✅ 4. 快速理解老项目

arduino 复制代码

claude "请用 10 分钟新同事能看懂的方式解释这个项目"

九、Claude CLI 常用参数速查

命令

说明

claude "prompt"

单次提问

claude login

登录授权

claude --apply

应用代码修改

claude --help

查看帮助

十、使用技巧 & 最佳实践

💡 1. 提示词要"工程化"

❌ 不推荐：

帮我看看代码

✅ 推荐：

以高并发场景为目标，分析该代码的线程安全问题

💡 2. 一次只做一件事

一次分析架构
一次只改一个模块

Claude 的输出会明显更稳定。

💡 3. 把 Claude 当同事，不是搜索引擎

告诉它：

你的角色期望
项目背景
约束条件

十一、适合谁用？

✅ 后端 / 前端工程师
✅ 架构师
✅ 独立开发者
✅ 想提高 AI 代码产出率的团队

如果你已经在用 AI + CLI + 工程化 Prompt ，

Claude CLI 会是非常强的一环。

十二、总结一句话

Claude CLI = 把顶级大模型，直接放进你的项目目录里。

不是聊天工具，是生产力工具。