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 消耗快

主力模型档做大型重构时，一次任务可能消耗 50 万+ token。用 Max 订阅比 API 按量付费划算。

🔄 2026-10-14 更新：本文首发时写作「Sonnet 4 做大型重构时……」，该型号已非当前主力档位。按 2026-10 的官方产品线，Claude Code 的主力档位已推进到 Sonnet 5.5 一代（$2/$10，缓存读 $0.10，Anthropic API 默认 Sonnet），另有 Haiku 5.5（按 ≤100K / >100K 分档计价）与 Opus 5.5（$4/$20）。本条只保留「大重构很吃 token、订阅比按量划算」这一结构性结论，不绑定具体型号。

Max 订阅的具体月费与档位本站列为待核实：官方曾公布 Max 5x / 20x 两档及池化额度方案，但各档金额与额度以官方页面为准，本文不转录数字。选订阅还是按量，取决于你的月度 token 量与是否在意速率上限，别只比单价。

验收清单：七步走完你应该会什么

别用「我装上了」当完成标准。下面七条全打勾，才算真的把 Claude Code 接进工作流：

• 能在任意项目里用一条命令启动，并让它先读懂项目再动手（第三步）
• 能让它改多个文件且改完能自己跑通测试（第四步）
• 能用它走完一次完整的 Git 工作流：分支 → 提交 → PR 描述（第五步）
• 至少接成一个 MCP server，让它真的能碰外部系统（第六步）
• 知道什么时候该打断它——看到它在改你没要求的文件时能立刻停（坑 2）
• 能估算自己一天大概烧多少 token，并知道超了去哪看（坑 4）
• 有一个自己写好的项目指令文件（CLAUDE.md / AGENTS.md），而不是每次口头重复约束

最后一条比前六条都重要。 前六条是「会用工具」，第七条是「把工具变成你的工具」。没有项目指令文件的 Claude Code，每次开工都在重新猜你的约定。

接下来 30 天怎么练

一个反直觉的建议：别在第一周就给它写权限。 大多数人放弃 Claude Code 不是因为它不会写代码，而是第一周就让它改崩了一个文件，然后不再信任它。先用只读任务建立信任基线，比一开始就追求自动化效率更高。

更新说明

本文所述命令与配置以 Claude Code 工具卡 的最新版本口径为准；CLI 迭代快，升级后请复核本文中的命令是否仍适用。