快速上手 - 个人运维平台

安装

前置要求

Node.js 18 或更高版本
npm 或 yarn 包管理器
一个 Anthropic 控制台 账号（用于 API 密钥）

推荐使用 nvm 管理 Node.js 版本：

Bash

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 安装 Node.js LTS
nvm install 22
nvm use 22

安装 Claude Code

Bash

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

验证安装：

Bash

claude --version

配置 API 密钥

Claude Code 需要 API 密钥才能运行。有两种方式：

方式一：环境变量

Bash

export ANTHROPIC_API_KEY=sk-ant-xxxxx

方式二：配置文件

在 ~/.claude.json 中配置：

JSON

{
  "apiKey": "sk-ant-xxxxx"
}

API 密钥可以在 console.anthropic.com 获取。

第一次启动

在项目目录中运行：

Bash

cd your-project
claude

首次启动会：

身份验证：检查 API 密钥是否有效
项目索引：扫描项目文件结构
检测 CLAUDE.md：如果有则自动加载
进入交互模式：等待你的第一条指令

启动成功后，你会看到：

┌─ Claude Code ──────────────────────────┐
│                                        │
│  你好！我是 Claude，已准备好帮助你。    │
│                                        │
│  项目：my-project                      │
│  文件数：127                           │
│                                        │
│  请输入你的需求...                      │
└────────────────────────────────────────┘

基础工作流

场景一：日常开发

你：帮我添加一个用户注册的 API 接口
Claude：我来看看现有的代码结构...
       （读取相关文件）
       我建议这样实现：
       1. 在 routes/ 下创建 register.ts
       2. 添加验证逻辑
       3. 连接数据库保存用户
       开始编码...
       （创建文件、编辑代码）
       实现完成，运行测试检查...
       测试通过 ✅

场景二：快速理解代码

你：src/auth.ts 里的 login 函数是怎么工作的？
Claude：读取文件...
       这个函数的工作流程是：
       1. 接收 email 和 password
       2. 从数据库查找用户
       3. 用 bcrypt 比对密码
       4. 生成 JWT token
       5. 返回 token 和用户信息

场景三：修复 Bug

你：测试报错了，帮我看看
Claude：运行测试...
       报错信息：Cannot read properties of undefined
       定位到 src/user.ts:45
       原因是 user.profile 可能为 null
       修复方案：添加可选链操作符 user.profile?.name
       修复完成，重新运行测试...
       全部通过 ✅

场景四：代码审查

你：审查一下我刚提交的改动
Claude：读取 diff...
       发现 3 个问题：
       1. ❌ 密码没有哈希处理
       2. ⚠️ 缺少输入验证
       3. ℹ️ 建议添加错误处理
       是否需要我修复这些问题？

常用命令速查

启动相关

命令	说明
`claude`	启动交互式会话
`claude "写一个单元测试"`	直接执行任务后退出
`claude -p "分析代码"`	同上，短参数形式
`claude --help`	查看所有启动参数

会话内命令

命令	说明
`/help`	查看所有可用命令和说明
`/clear`	清空当前对话历史
`/cost`	查看当前会话的 Token 消耗
`/doctor`	诊断环境是否正确配置
`/memory`	查看和管理记忆
`/config`	修改 Claude Code 设置

中断与退出

操作	说明
`Ctrl+C`	中断当前正在执行的操作
`Ctrl+D`	退出 Claude Code 会话
`Ctrl+L`	清屏
`↑/↓`	浏览历史命令

使用技巧

1. 引用文件和行号

直接输入文件路径和行号，Claude 会精确定位：

src/app.ts:42
src/models/user.ts:15-30

2. 分步提需求

复杂需求先讨论方案再执行，效果更好：

你：我想添加用户模块，先分析一下现有的代码结构
Claude：...分析...
你：好，先创建数据模型
Claude：...创建...
你：再添加注册 API
Claude：...实现...

3. 中英文混合

Claude Code 完全支持中文，怎么舒服怎么来：

分析一下 database schema，然后帮我 optimize 一下查询性能

4. 明确约束条件

避免 Claude 做出不符合预期的修改：

帮我重构这个函数，但不要修改它的接口签名
保持现有的错误处理风格
测试覆盖率不能低于 80%

常见问题

问题	解决方法
API 密钥无效	检查环境变量和 ~/.claude.json 配置
启动报错	运行 `/doctor` 诊断
Claude 理解错误	补充上下文，重新描述需求
操作被拒绝	确认权限设置，或手动允许
输出被截断	使用 `/clear` 清空对话历史

💡 实际使用场景

场景一：第一次使用 Claude Code

前端新手小陈在项目目录输入 claude，面对空白的命令行有点茫然。他输入：

我第一次用 Claude Code，帮我介绍一下这个项目的情况

Claude 扫描了项目后回答："这是一个 React + TypeScript 项目，有 3 个主要页面、12 个组件、使用 Vite 构建。" 小陈接着尝试：

我想在首页加一个公告栏组件，帮我实现

Claude 读取了首页代码，创建了新组件，集成到了页面中，小陈第一次感受到了 AI 编程的效率。

场景二：快速修复紧急 Bug

周五下班前，线上反馈用户登录后页面白屏。全栈老李运行：

claude "紧急！用户登录后白屏，帮我排查 login 相关的代码"

Claude 读取了 login 流程相关文件，发现是最近重构时一个状态变量名没同步更新，Claude 自动修复并验证了测试通过。

场景三：学习新框架

后端小周要学习 NestJS，他把官方示例项目拉到本地，运行 claude：

我是一个 Express 开发者，请用 NestJS 的概念对比 Express 的方式，帮我理解这个示例项目

Claude 逐模块对比解释，小周对照着自己的 Express 经验，一小时就掌握了 NestJS 的核心概念。