Vibe Coding 知识库

Claude 不同环境下的安装部署说明 ​

这页用于说明 Claude Code 在不同使用环境中的安装、部署和团队落地方式。它适合作为 Claude 中文课程菜单的第一入口：先确定运行环境，再进入 Slash Commands、Memory、Skills、Subagents、MCP、Hooks 等能力学习。

官方文档核对时间：2026-05-11。

先选择使用环境 ​

环境适合场景推荐方式
本地 CLI终端开发、脚本化、远程服务器、完整能力本机安装 Claude Code，在项目根目录运行 claude
VS Code / Cursor / Windsurf / Kiro希望在编辑器里看 diff、选中文件、少切终端安装 Claude Code 编辑器扩展
JetBrains IDEIntelliJ IDEA、PyCharm、WebStorm 等 JetBrains 工作流从 JetBrains Marketplace 安装 Claude Code 插件
Claude Code Desktop图形界面、并行会话、应用预览、可视化审查安装 macOS 或 Windows 桌面端
Claude Code on the web希望任务断开后继续跑，或从浏览器/手机查看使用 claude.ai/code 并连接 GitHub 仓库
Slack团队群里把问题直接转成开发任务安装 Claude App，并启用 Claude Code 路由
GitHub Actions / GitLab CI/CD自动 PR 审查、Issue 处理、定时维护在 CI 中运行 Claude Code，并配置密钥和 workflow
企业云厂商数据驻留、采购合规、集中管控使用 Claude Enterprise、Anthropic Console、Bedrock、Vertex AI 或 Foundry

本地 CLI 安装 ​

本地 CLI 是最完整的 Claude Code 形态，适合开发者日常编码、运行测试、读写文件、配置 MCP、远程服务器开发和脚本化自动化。

Native 原生安装 ​

官方 Quickstart 当前把 Native 安装作为首选入口。

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

包管理器安装 ​

如果团队已经有统一的电脑初始化脚本、镜像或包管理策略，可以用包管理器。

macOS Homebrew：

bash
brew install --cask claude-code

Windows WinGet：

powershell
winget install Anthropic.ClaudeCode

Linux 的 Debian/Ubuntu、Fedora/RHEL、Alpine 也有官方包管理器安装方式。因为仓库地址、签名 key、指纹和升级命令可能随版本调整，团队脚本应以官方安装页为准。

npm 安装 ​

如果团队已经统一使用 Node.js，也可以用 npm：

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

注意：

  • 需要 Node.js 18 或更高版本。
  • 不要使用 sudo npm install -g，否则容易引入权限和安全问题。
  • npm 方式升级时用 npm install -g @anthropic-ai/claude-code@latest。
  • 安装后运行 claude doctor 检查安装类型和版本。

Windows、WSL 和 Git Bash ​

Windows 团队最容易混乱，所以要先定标准路径。

路径适合场景注意事项
Windows 原生 PowerShell主要做 Windows 本地开发建议安装 Git for Windows，方便 Claude Code 使用 Bash 类工具
WSLWindows 电脑开发 Linux 服务Node、npm、Claude Code 都放在 WSL 内，不要混用 Windows 路径
Git Bash已经大量使用 Git for Windows 的团队必要时设置 CLAUDE_CODE_GIT_BASH_PATH 指向 bash.exe

WSL 中建议检查：

bash
which node
which npm

如果结果指向 /mnt/c/...，说明可能调用了 Windows 里的 Node/npm。开发 Linux 项目时，应改成 WSL 内部安装的 Node/npm。

IDE 部署 ​

IDE 部署适合希望“少切窗口、可视化审查变更”的团队。

VS Code 及兼容编辑器 ​

在 VS Code、Cursor、Windsurf、VSCodium、Kiro 等编辑器中安装 Claude Code 扩展。它提供 Claude 面板、可视化 diff、选中文件上下文、集成终端，并与 CLI 共享 Claude Code 配置。

建议流程：

  1. 安装编辑器扩展。
  2. 登录 Claude 账号或受支持的企业提供方。
  3. 打开项目仓库目录。
  4. 在 Claude Code 面板中发起任务，或在集成终端运行 claude。
  5. 把项目规则写入 CLAUDE.md，让 CLI 和 IDE 会话共享同一套上下文。

JetBrains ​

从 JetBrains Marketplace 安装 Claude Code 插件，重启 IDE 后使用。适合 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains 用户。

Desktop 桌面端 ​

Claude Code Desktop 适合偏图形化的团队：可以做并行会话、可视化 diff、应用预览、集成终端和文件编辑器。

当前部署注意点：

  • Desktop 支持 macOS 和 Windows。
  • Linux 桌面用户优先使用 CLI、Web 或 IDE 集成。
  • Desktop 与 CLI 使用同一套 Claude Code 底层能力，并会使用 ~/.claude/ 配置目录。

Web 和云端会话 ​

Claude Code on the web 适合长任务、离开电脑后继续运行、从浏览器或手机查看结果的场景。它运行在 Anthropic 管理的云端环境中，需要连接仓库。

典型流程：

  1. 打开 https://claude.ai/code。
  2. 登录符合条件的账号。
  3. 连接 GitHub。
  4. 授权目标仓库。
  5. 根据项目需要配置 setup scripts、依赖安装和网络访问。
  6. 提交任务，审查 Claude 生成的分支或 PR。

适合场景：Issue 转 PR、较长时间的重构、离线后仍要继续的代码任务。

Slack 部署 ​

Claude Code in Slack 会把 Slack 里与开发相关的 @Claude 提及路由到 Claude Code on the web。

团队配置：

  1. 安装或配置 Slack 中的 Claude App。
  2. 每个成员连接自己的 Claude 账号。
  3. 确认 Claude Code on the web 已配置 GitHub 仓库访问。
  4. 把 Claude 邀请到允许处理开发任务的频道。
  5. 选择 Code only 或 Code + Chat 等路由模式。

适合场景：线上问题反馈、产品/项目经理在群里描述需求、支持团队把 bug 直接转成代码任务。

CI/CD 部署 ​

CI/CD 适合让 Claude 响应仓库事件，而不是等待某个开发者打开终端。

GitHub Actions ​

快速方式：

bash
claude
/install-github-app

手动方式：

  1. 在目标仓库安装 Claude GitHub App。
  2. 在仓库 Secrets 中添加 ANTHROPIC_API_KEY 或企业云厂商凭据。
  3. 在 .github/workflows/ 下添加 workflow。
  4. 在 Issue 或 PR 评论中用 @claude 测试。

生产环境要注意：限制权限、检查触发条件、保留 PR 人工审查。

GitLab CI/CD ​

典型方式：

  1. 在 GitLab CI/CD Variables 中添加 masked 变量，例如 ANTHROPIC_API_KEY。
  2. 在 .gitlab-ci.yml 中添加 Claude job。
  3. 决定触发方式：手动、MR、定时、评论提及或外部 webhook。
  4. 让 Claude 的变更进入 MR，而不是直接改主分支。

GitLab CI/CD 也可以接入 Amazon Bedrock 或 Google Vertex AI，以满足企业云和数据驻留要求。

企业部署 ​

企业部署的重点不是“装上命令”，而是先确定账号、数据、权限、审查和成本模型。

模式适合团队部署重点
Claude Team / Enterprise大多数希望快速落地的团队席位、账单、SSO、权限策略、统一培训
Anthropic Console使用 API 计费的开发者或团队API key、工作区、成本跟踪
Amazon BedrockAWS 原生团队IAM、区域、Bedrock 模型可用性
Google Vertex AIGCP 原生团队Workload Identity、区域、Vertex 模型配置
Microsoft FoundryAzure 原生团队企业网关、策略、提供方接入

团队落地建议：

  1. 每个操作系统只保留一条标准安装路径。
  2. 仓库根目录加入 CLAUDE.md，写清构建、测试、架构和协作规则。
  3. 需要共享工具时，把 .mcp.json 放到仓库中统一维护。
  4. 上线前先定义允许工具、禁止工具、密钥使用和代码审查策略。
  5. 先从代码问答、小 bug、测试补充、文档整理开始。
  6. 等团队习惯 review 和回滚后，再推进更自动化的 Slack、CI/CD、Web 长任务。

安装后检查清单 ​

安装或部署完成后执行：

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

确认：

  • 能正常登录。
  • Claude 能看到项目文件。
  • Git 命令可用。
  • 构建和测试命令可运行。
  • 仓库存在 CLAUDE.md。
  • MCP server 或连接器在目标环境中可用。

培训推荐顺序 ​

面向开发和项目经理培训时，建议这样安排：

  1. 先用本地 CLI 在一个示例仓库跑通。
  2. 加入 CLAUDE.md，展示项目规则如何影响输出。
  3. 在 VS Code 或 Desktop 中重复同一任务，让非终端用户看到图形化流程。
  4. 展示 Claude Code on the web 的 Issue 到 PR 流程。
  5. 最后再讲 Slack 和 CI/CD，因为它们牵涉权限、仓库、密钥和团队流程。
  6. 收尾必须讲权限、Secrets、人工审查和回滚纪律。

官方来源 ​