前置条件
在安装 Claude Code 插件前，建议先准备以下开发环境（尤其在 Windows 上）：
Node.js 与 npm
- 推荐安装 Node.js LTS 版本（自带 npm）。
- 验证安装：
node -v与npm -v均能输出版本号。 - macOS/Linux 可选用
nvm管理多版本；Windows 可用nvm-windows（可选）。
Git（Windows 包含 Git Bash）
- Windows：安装 Git for Windows（自带 Git Bash 终端）。安装完成后在开始菜单找到“Git Bash”。
- macOS：可通过 Xcode Command Line Tools 或 Homebrew 安装 Git。
- Linux：使用发行版包管理器安装（如
apt install git、dnf install git、pacman -S git）。 - 验证安装：
git --version输出版本号。
IDE 与终端建议
- 安装稳定版 VS Code 或 JetBrains 系列 IDE。
- Windows 建议在 VS Code 集成终端中选择 Git Bash 作为默认终端，运行 npm 等命令更兼容： Ctrl+Shift+P → Terminal: Select Default Profile → Git Bash。
Claude Code 安装指南
Claude Code 为主流 IDE 提供插件（VS Code 与 JetBrains 系列），并可与 Claude 账号或 API Key 一起使用。请选择您的系统并按步骤完成安装。
提示：以下为快速上手步骤。若需最准确的最新说明，请以官方文档与插件市场页面为准。
Windows 安装
请先完成上方“前置条件”，尤其是安装 Git for Windows（安装时选择默认配置即可，会附带 Git Bash 终端）与 Node.js/npm。后续在 VS Code 中建议使用 Git Bash 终端运行命令。
方式一：VS Code 插件
- 安装最新版 VS Code（推荐稳定版）。
- 打开 VS Code，进入扩展视图（侧栏 Extensions）。
- 搜索 “Claude” 或 “Claude Code”（发布者 Anthropic），点击安装。
- 安装完成后，通过命令面板（Ctrl+Shift+P）执行 “Claude: Sign in” 登录，或在扩展设置中填入 API Key。
- 可选：如需离线/受限网络环境，下载对应 VSIX 包后使用命令安装：
code --install-extension yourfile.vsix。
方式二：JetBrains 插件
- 打开 IDE（IntelliJ IDEA / PyCharm / WebStorm 等），进入 Settings → Plugins。
- 在 Marketplace 搜索 “Claude” 或 “Claude Code”，点击安装并重启 IDE。
- 首次使用在工具栏或 Tools 菜单中找到 Claude，按照指引登录或配置 API Key。
可选：安装 Claude 桌面应用（Windows 版），登录后可配合插件使用；若企业网络有限制，请配置系统或 IDE 代理。
macOS 安装
方式一：VS Code 插件
- 安装最新 VS Code（Apple Silicon/Intel 均可）。
- 打开扩展视图，搜索并安装 “Claude / Claude Code”（Anthropic）。
- 通过命令面板执行 “Claude: Sign in” 登录，或在扩展设置中粘贴 API Key（如使用 API 方式）。
- 若出现安全提示，前往 系统设置 → 隐私与安全 允许 VS Code 权限；如启用内联建议，必要时在 辅助功能 中勾选 VS Code。
方式二：JetBrains 插件
- 在 Settings → Plugins → Marketplace 搜索 “Claude / Claude Code”。
- 安装后重启 IDE，在 Tools/Claude 面板中登录或配置 API Key。
可选：安装 Claude 桌面应用（macOS 版），首次启动若被 Gatekeeper 拦截，请在 隐私与安全 中选择仍要打开。
Linux 安装
方式一：VS Code / VS Code OSS
- 通过发行版包管理器或官网下载并安装 VS Code。
- 打开扩展页搜索 “Claude / Claude Code”（Anthropic）并安装；在部分地区如搜索不到，可手动下载 VSIX 安装：
code --install-extension yourfile.vsix。 - 执行 “Claude: Sign in” 登录，或在设置中配置 API Key（可通过环境变量
CLAUDE_API_KEY或 IDE 设置）。
方式二：JetBrains 插件
- 打开 Settings → Plugins → Marketplace，搜索并安装 “Claude / Claude Code”。
- 重启 IDE 后在 Tools/Claude 面板登录，或在插件设置中粘贴 API Key。
说明：Linux 暂无官方桌面版，正常使用不受影响。请确保已安装 ca-certificates 以避免证书问题；企业/校园网请按需配置代理。
安装后验证
- VS Code：按 Ctrl/Cmd+Shift+P，执行 “Claude: New Chat” 或 “Ask Claude”，能正常打开侧边栏并收到回复即完成。
- JetBrains：在 Tools → Claude 中发起对话或选中代码右键使用 Claude，能得到回复即完成。
CLI（命令行）安装
可选方案：安装 Claude Code 的命令行工具，便于在终端中直接使用。Windows 推荐使用 Git Bash 运行安装命令；如遇权限问题，请以管理员身份运行终端。
- 打开终端：Windows 使用 Git Bash（或 CMD/PowerShell），macOS/Linux 使用系统终端。
- 运行安装命令：
npm install -g @anthropic-ai/claude-code - 验证安装：
claude --version显示版本号即安装成功。
常见问题
- 无法登录：检查网络与代理；在受限网络下使用 API Key 更稳妥。
- 扩展搜索不到：升级 IDE 到最新稳定版，或改用 VSIX/离线插件安装。
- 请求失败/证书错误：安装系统根证书（如
ca-certificates），确认时间同步。 - 公司合规：如需本地化或私有化接入，请联系管理员开通企业端点后在插件中切换。
- 命令不可用：如果
claude显示未找到，检查全局 npm bin 是否已加入 PATH。Windows 通常为%AppData%\npm或nvm的全局目录；macOS/Linux 可将$(npm config get prefix)/bin加入 PATH 并重启终端。
初始设置
安装完成后，您需要进行一些基本设置：
- 登录您的账号
- 选择默认模型
- 配置 IDE 集成（可选）