Claude Code 完全上手指南：AI 编程搭档的正确打开方式
Claude Code AI编程 Anthropic MCP 教程

Claude Code 完全上手指南：AI 编程搭档的正确打开方式

可能是全网最接地气的 Claude Code 教程，从安装到精通，让你的终端不再寂寞。

DJ

2026年5月27日 · 3 分钟阅读

前言：什么年代了，你还在人肉写代码？

兄弟们，如果你还在手动写那些重复的 CRUD、一页一页翻文档找 API 用法、或者盯着报错信息发呆，那你真的该认识一下 Claude Code 了。

Claude Code 是 Anthropic（对，就是做 Claude 那个公司）推出的终端 AI 编程助手。简单说——它直接住在你的终端里，你动动嘴（或者动动键盘），它帮你把代码干了。

和那些只能在网页对话框里聊天的 AI 不同，Claude Code 能直接读写你的文件、执行命令、创建 PR、部署上线。它不是来帮你写代码的，它是来当你队友的。

免责声明：本文写于 2026 年中旬，功能细节可能随版本更新而变化。如果你看到的内容和实际不符——那不是我的问题，是 Anthropic 又偷偷升级了。

第一章：安装——先让它住进你的电脑

1.1 前置条件

在开始之前，你需要备好以下装备：

  • Node.js 18+（建议 20+，毕竟 2026 年了，别活在古代）
  • Git（不会 Git 的程序员就像不会拿筷子的中国人——也不是不行，但怪怪的）
  • 一个 Anthropic 账号（去 console.anthropic.com 注册，一顿饭钱的事）
  • API Key（注册完在控制台生成一个，存好别乱发，这玩意儿比你的网银密码还值钱）

1.2 全局安装（推荐方式）

打开你的终端，一行命令搞定：

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

等进度条跑完，试试这个：

claude --version

如果看到版本号——恭喜，你已经完成了最难的部分。

1.3 项目级安装（进阶玩法）

如果你有洁癖，不想全局安装：

npm install --save-dev @anthropic-ai/claude-code

然后在 package.json 里加个脚本：

{
  "scripts": {
    "claude": "claude"
  }
}

之后就可以用 npm run claude 调用了——仪式感拉满。

1.4 登录认证

安装完先登录：

claude login

终端会弹出一个链接，点进去授权。如果弹出浏览器失败，别慌，它会给你一个 code，手动去网页输入也一样。

第二章：常用命令——学会和你的 AI 搭档交流

2.1 启动对话模式

在你的项目目录下直接敲：

claude

终端就成了你的 AI 聊天框。你可以问问题、要它写代码、改代码、查 bug——啥都行。

比如：

你：帮我看看这个项目怎么跑起来？
Claude：浏览了一下你的 package.json，用 npm run dev 就能启动。

第一次启动它会扫描你的项目结构，之后每次都会记住上下文——所以不用每次都从头交代。

2.2 非交互模式（一句话完事）

如果你不想进聊天界面，想直接吩咐：

claude -p "解释一下这个项目的架构"

-p 就是 --print，执行完直接输出结果然后退出，适合写脚本或者快速查询。

2.3 文件操作模式

这个是最骚的：

claude -f src/main.js -p "这个函数有什么问题？"

-f 指定文件，Claude Code 会读取文件内容再回答。比你自己复制粘贴省了三个操作步骤。

也可以传多个文件：

claude -f src/*.js -p "帮我给这些文件加上错误处理"

2.4 运行命令模式

想让 AI 帮你执行终端命令？加个 --allow-execute：

claude --allow-execute -p "帮我跑一下测试，看看哪些挂了"

它会先告诉你准备跑什么命令，等你确认了才执行——不是那种不打招呼就乱搞的队友。

2.5 常用快捷键

在交互模式里：

  • Ctrl+C — 取消当前生成（手抖说错话时救命的）
  • Ctrl+D — 退出 Claude Code
  • 方向键上下 — 历史命令，和你的 bash 一样
  • 输入 /help — 查看所有内置命令
  • 输入 /clear — 清屏，假装什么都没发生过

第三章：常用插件（MCP 协议）——让你的 Claude 会更多技能

3.1 什么是 MCP？

MCP 全称 Model Context Protocol，是 Anthropic 搞的一个开放协议。通俗说——它让 Claude Code 能用上各种工具，就像给你的 VS Code 装扩展一样。

装好 MCP 服务器后，Claude Code 就能：

  • 查数据库（再也不用手写 SQL 了）
  • 操作 GitHub（创建 PR、处理 Issue，一条龙）
  • 查文档（实时搜索，不是翻旧缓存）
  • 发消息（Slack、邮件，一步到位）

3.2 MCP 插件装在哪？

MCP 服务器配在 ~/.claude/settings.json 里（全局生效）或者项目根目录的 .claude/settings.json（仅当前项目）。

格式长这样：

{
  "mcpServers": {
    "插件名字": {
      "command": "启动命令",
      "args": ["参数1", "参数2"],
      "env": {
        "环境变量": "值"
      }
    }
  }
}

3.3 必装插件推荐

① GitHub MCP——管理仓库的神器

让你的 Claude 能直接操作 GitHub：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

装好后，你可以直接说：

  • "帮我给这个 PR 加上 reviewer"
  • "看看 #42 这个 issue 是什么情况"
  • "帮我创建一个 release"

友情提示：需要设置 GITHUB_TOKEN 环境变量。没有 token 的去 GitHub Settings > Developer settings > Personal access tokens 生成一个。

② SQLite MCP——和数据库对话

直接让你的 Claude 读数据库：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-sqlite", "--db-path", "./data.db"]
    }
  }
}

然后：

你：这个月注册了多少用户？
Claude：（查数据库）上个月注册了 1,234 个新用户，环比增长 15%。

再也不用打开数据库客户端一顿操作了。

③ Playwright MCP——浏览器自动化

让 Claude Code 能打开浏览器、截图、点按钮：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-playwright"]
    }
  }
}

典型用法：

  • "帮我截个首页的图"
  • "看看登录页面能不能正常登录"
  • "检查这个按钮点击后有没有弹窗"

④ Memory MCP——让你 AI 搭档记性变好

默认情况下 Claude Code 每次对话结束后就失忆了——像金鱼一样。Memory 插件让它能记住你的偏好：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-memory"]
    }
  }
}

你可以：

  • "记住我测试喜欢用 Jest 不是 Mocha"
  • "下次记得我端口喜欢用 4000"
  • "记住这个项目的代码风格是 4 空格缩进"

下次打开 Claude Code——它全记得。这感觉就像你的搭档过了一晚上还记得你爱喝什么奶茶。

3.4 如何发现更多插件？

官方插件市场在 github.com/modelcontextprotocol/servers，已经有上百个插件了。从数据库到设计工具，从日志分析到云服务部署——你能想到的基本都有。

找不到合适的？还可以自己写 MCP 服务器，用 TypeScript 或 Python 都行，官方文档写得明明白白。

第四章：工作流实战——少废话，干就完了

4.1 日常开发流

# 1. 进入项目，启动 Claude
cd my-project
claude
2. 在对话中直接吩咐


你：帮我创建一个用户列表组件，从 API 获取数据，支持搜索和分页
Claude：好，我打算这样做...（列出方案）可以吗？
你：可以，开干
Claude：（一顿操作，创建了文件、写了代码）


3. 不满意还能继续改


你：表格改成卡片视图吧
Claude：行，改好了你看看

4.2 Bug 修复流

claude -p "npm test 挂了，帮我看看什么情况" --allow-execute

Claude Code 会自动分析测试输出、定位问题、然后尝试修复。一条龙服务，比某些外包团队效率还高。

4.3 Code Review 流

claude -p "帮我 review 一下当前分支的改动" --allow-execute

它会对比当前分支和主分支的差异，给你逐行审查建议。白嫖一个 Senior 级别的 code review，香不香？

第五章：一些你可能想知道的事

5.1 Claude Code 读了我的代码，我的隐私呢？

这是一个严肃的问题。Claude Code 调用的是 Anthropic API，数据传输加密。而且 Anthropic 明确承诺不会用你传入的数据训练模型（除非你自己开了那个选项）。

如果你在公司用敏感项目，建议和你们的安全团队确认一下。如果是个人项目——放宽心，比你上网浏览留下的痕迹少得多。

5.2 费用怎么算？

Claude Code 本身不收钱，但调用 API 是按量计费的。你用的 token 越多，花的越多。

省钱小技巧：

  • 尽量把问题说清楚，减少来回沟通
  • 用 -f 指定相关文件，别让它自己瞎翻
  • 复杂任务拆成几步，每步确认
  • 开通 API 的 Prompt Caching 功能，能省一半钱

正常一个月几十美元够个人用了——比你请同事喝咖啡便宜。

5.3 翻车了怎么办？

Claude Code 不是万能的。它可能写错代码、理解错需求、或者写出你看不懂的实现。

记住三条黄金法则：

  1. 先审查再执行——它改了什么文件，自己看一眼再确认
  2. 用好 Git——不满意 git checkout . 一键还原
  3. 它是个助手，不是老板——最终决策权在你手上

结语：AI 不会取代程序员，但会用 AI 的程序员会取代不用 AI 的

这话虽然被说烂了，但确实是真理。Claude Code 不是来抢你饭碗的，是来帮你把那些烦人的、重复的、无聊的工作干掉的。

装上它，花一个下午熟悉一下，以后写代码就相当于从骑自行车变成了开特斯拉——你还是那个司机，但体验完全不一样了。

祝各位编码愉快，bug 少少，头发多多 🫡

本文首发于 188博客，作者：这人不一般。转载随便，注明出处就行，写教程不容易，请尊重劳动成果。