Claude Code 从零上手：CLI AI 编程实战指南

适用场景

• 想用 CLI 方式做 AI 编程（不依赖 IDE）
• 已有 Cursor / Copilot，想试试 Claude 原生体验
• 需要在服务器 / SSH 环境用 AI 编程
• 想用 Claude Sonnet 4 / Opus 4 的完整能力

Claude Code vs Cursor vs Copilot

Claude Code 的独特优势：CLI 原生 + 终端操作 + SSH 可用。

第一步：安装

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

认证

# 方式 1：用 Anthropic 账号（推荐，含 Max 订阅）
claude login

# 方式 2：用 API Key（按量付费）
export ANTHROPIC_API_KEY="sk-ant-xxx"
claude

国内用户如果直连慢，可以配代理：

export HTTPS_PROXY="http://127.0.0.1:7890"
claude

第二步：第一次使用

进入项目目录，启动 Claude Code：

cd my-project
claude

进入交互式 REPL。几个基本操作：

> 帮我理解这个项目的结构          # 项目理解
> 找到处理用户登录的代码          # 代码定位
> 把这个函数改成支持异步          # 代码修改
> 跑一下测试看看有没有 break      # 执行命令

Claude Code 会自动：

1. 扫描项目文件结构
2. 读 package.json / README 理解技术栈
3. 找到相关文件
4. 提出修改方案（需你确认后执行）

第三步：项目理解工作流

新接手一个项目时的标准操作：

> 先读 README 和 package.json，告诉我这个项目是做什么的、用了什么技术栈

> 画出项目的目录结构，标注每个目录的职责

> 找到项目的入口文件，解释启动流程

> 这个项目的数据流是怎样的？从 API 请求到数据库的完整路径

> 找到所有 TODO 和 FIXME，按优先级排序

Claude Code 会实际读取文件并分析，不是瞎猜。

第四步：多文件修改

这是 Claude Code 最强的能力。举个例子：

> 我需要加一个"用户头像上传"功能。需要：
> 1. 后端 API（上传到 S3）
> 2. 前端组件（拖拽上传 + 预览）
> 3. 数据库加 avatar_url 字段
> 4. 用户 profile 页面显示头像
> 先看一下现有代码结构，告诉我你的计划，我确认后再动手

Claude Code 会：

1. 扫描相关文件（后端路由、前端组件、数据库 schema）
2. 给出修改计划（改哪些文件、每个文件改什么）
3. 等你确认
4. 一次性修改多个文件
5. 跑测试验证

关键：先说"告诉我计划"，确认后再让它动手。避免改出一堆你不想要的东西。

第五步：Git 工作流

Claude Code 原生支持 git 操作：

> 看一下当前的 git diff，帮我写 commit message

> 帮我把这个改动拆成 3 个独立的 commit（按逻辑分组）

> 创建一个分支 feature/avatar-upload，把改动提交上去

推荐工作流：

1. claude  # 启动
2. "在 feature 分支上实现 XXX 功能"  # 让它创建分支 + 改代码
3. "跑测试"  # 验证
4. "看一下 diff，写 commit message"  # 提交
5. 退出后自己 git push + 开 PR

第六步：MCP 集成

Claude Code 支持连接 MCP Server，扩展能力：

# 配置文件位置：~/.claude/mcp_servers.json

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://..."
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxx"
      }
    }
  }
}

配置后，Claude Code 可以直接查数据库、操作 GitHub。

常用技巧

1. 用 CLAUDE.md 固化项目约定

在项目根目录创建 CLAUDE.md：

# 项目约定

- 用 pnpm 不用 npm
- 测试用 vitest，跑 `pnpm test`
- 提交前跑 `pnpm lint`
- Vue 组件用 <script setup>
- 不要用 any，所有变量都要有类型

Claude Code 每次启动会自动读取，不用每次重复说。

2. 用 /compact 压缩上下文

聊了很久后上下文会满，用 /compact 压缩历史对话，保留关键信息。

3. 子 Agent 并发

复杂任务可以让 Claude Code 开子 Agent 并行处理：

> 用 3 个并行子任务：
> 1. 修复 auth 模块的 bug
> 2. 给 API 模块加测试
> 3. 重构 utils 模块
> 分别完成后汇总给我

踩坑记录

坑 1：大项目首次索引慢

10 万行以上的项目，首次启动会花 1-2 分钟扫描。后续有缓存会快。

坑 2：会主动改你不想改的文件

Claude Code 有时会"顺手"改一些你没要求的文件（比如格式化）。用 --allowedTools 限制它只能用特定工具。

坑 3：国内网络

Anthropic API 在国内不稳定。必须配代理，否则会频繁超时。

坑 4：Token 消耗快

Sonnet 4 做大型重构时，一次任务可能消耗 50 万+ token。用 Max 订阅（$200/月）比 API 按量付费划算。