Vibe Coding 知识库

Claude Code 安装部署说明 ​

这页是 AI 培训课程里的环境准备入口。目标不是讲完 Claude Code 的所有高级能力，而是让学员先把可用环境装好，知道在本机、IDE、桌面端、Web、Slack 和 CI/CD 中应该选择哪一种形态。

官方文档核对时间：2026-05-11。更完整的中英文说明可见 Claude 中文安装部署说明 和 Claude Installation and Deployment。

课堂推荐安装路径 ​

培训现场优先选择本地 CLI，因为它最容易演示文件修改、命令执行、Git 状态、测试和 CLAUDE.md 项目规则。

推荐准备顺序：

  1. 安装 Node.js 或确认系统已有 Node.js。
  2. 安装 Git，Windows 用户建议同时安装 Git for Windows。
  3. 安装 Claude Code CLI。
  4. 登录 Claude 账号。
  5. 进入示例项目目录运行 claude。
  6. 用 claude doctor 和 /status 检查环境。

本地 CLI 安装 ​

macOS、Linux、WSL：

bash
curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

powershell
irm https://claude.ai/install.ps1 | iex

Windows CMD：

cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装后：

bash
cd /path/to/your-project
claude
/login

npm 安装方式 ​

如果你的电脑已经装好 Node.js 18 或更高版本，也可以用 npm：

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

注意：

  • 不要使用 sudo npm install -g。
  • npm 方式升级建议使用 npm install -g @anthropic-ai/claude-code@latest。
  • 安装后运行 claude doctor 检查版本和安装状态。

Windows 环境选择 ​

方式适合情况课堂建议
Windows PowerShell 原生安装学员主要做 Windows 本地开发可以直接使用，建议提前安装 Git for Windows
WSL学员需要 Linux 命令、Docker、后端服务或类生产环境推荐给开发者，Node/npm/Claude 都安装在 WSL 内
Git Bash学员已经习惯 Git for Windows可作为 Bash 工具补充，不建议课堂上混用太多终端

WSL 中检查 Node 路径：

bash
which node
which npm

如果路径来自 /mnt/c/...，说明可能混用了 Windows 的 Node/npm。课堂上建议统一改为 WSL 内安装。

IDE 和图形化形态 ​

形态适合谁说明
VS Code / Cursor / Windsurf / Kiro 扩展希望少切终端的开发者可以在编辑器里看 diff、选择文件、打开 Claude 面板
JetBrains 插件IntelliJ、PyCharm、WebStorm 用户适合 Java、Python、前端等 JetBrains 工作流
Claude Code Desktop不熟悉命令行或需要并行会话的学员提供图形化界面、预览、可视化审查和集成终端
Claude Code on the web项目经理、产品、远程协作者通过浏览器提交任务，适合 Issue 到 PR 的长任务

培训时建议先用 CLI 跑通，再展示 IDE 或 Desktop。这样学员能先理解 Claude Code 的核心工作方式，再理解不同界面只是入口不同。

Slack 和 CI/CD 形态 ​

Slack 和 CI/CD 不建议作为第一堂课的安装重点，因为它们涉及账号、仓库权限、密钥和团队审批流程。

适合后续团队落地时使用：

  • Slack：在频道中 @Claude，把讨论中的 bug 或需求转成 Claude Code 任务。
  • GitHub Actions：在 Issue 或 PR 中用 @claude 触发自动实现、修复或代码审查。
  • GitLab CI/CD：在 GitLab pipeline 中运行 Claude Code，把变更流入 MR。

生产环境中要保留人工审查，不要让 AI 直接修改主分支。

安装后检查 ​

bash
claude --version
claude doctor
cd /path/to/your-project
claude
/status

确认：

  • 能正常登录。
  • 能读取项目文件。
  • Git 命令可用。
  • 项目构建和测试命令可运行。
  • 项目根目录已经准备好 CLAUDE.md。

课堂演示建议 ​

第一轮演示只做这几件事：

  1. 打开一个空仓库或演示仓库。
  2. 新增 CLAUDE.md，写入项目目标、技术栈、命令和验收标准。
  3. 运行 claude。
  4. 让 Claude 先阅读 CLAUDE.md 和项目结构。
  5. 让 Claude 给出实现计划。
  6. 执行一个小功能，并运行构建或测试验证。

这样学员能看到：Claude Code 的核心不是“聊天”，而是让 AI 在明确上下文、可验证命令和 Git 工作流里协作。

官方来源 ​