AI 助手安装指南

Appearance

Claude Code - IDE 集成教程 ​

支持的 IDE ​

Claude Code 支持以下 IDE：

  • Visual Studio Code（包括 Cursor、Windsurf 等分支）
  • JetBrains IDEs（PyCharm、WebStorm、IntelliJ、GoLand 等）

一、VSCode 集成 ​

安装插件 ​

  1. 打开 VSCode
  2. 点击左侧扩展图标（或按 Ctrl+Shift+X / Cmd+Shift+X）
  3. 搜索 "Claude Code"
  4. 点击安装官方插件

配置插件 ​

方法 1：使用 config.json（推荐） ​

新版本插件强制登录的解决方案：

  1. 创建配置文件：
bash
# macOS/Linux
mkdir -p ~/.claude
nano ~/.claude/config.json

# Windows
mkdir C:\Users\你的用户名\.claude
notepad C:\Users\你的用户名\.claude\config.json
  1. 输入以下内容：
json
{
  "primaryApiKey": "fox"
}

方法 2：在 VSCode 中配置 ​

  1. 打开 VSCode 设置（Ctrl+, / Cmd+,）
  2. 搜索 "Claude Code"
  3. 配置 API Key 和 Base URL

使用方式 ​

  1. 在 VSCode 内置终端中运行 claude
  2. 插件会自动检测并连接
  3. 你可以在 IDE 中直接看到 Claude Code 的改动

二、Cursor 集成 ​

Cursor 是基于 VSCode 的 AI 编辑器，有两种使用方式：

方法 1：直接安装插件（推荐） ​

  1. 打开 Cursor
  2. 点击扩展图标
  3. 搜索 "Claude Code"
  4. 安装官方插件

方法 2：基于 WSL（Windows 用户） ​

通过 WSL 在 Cursor 中使用 Claude Code：

步骤 1：安装 WSL 扩展 ​

  1. 打开 Cursor
  2. 搜索并安装 "WSL" 扩展
  3. 重启 Cursor

步骤 2：连接到 WSL ​

  1. 点击左下角终端图标
  2. 选择 "Connect to WSL using Distro"
  3. 选择 "Ubuntu"
  4. Cursor 会自动连接到 Ubuntu 系统

步骤 3：在 WSL 中使用 ​

  1. 在 Cursor 终端中运行 claude
  2. 可以可视化看到代码操作

注意：如果没有 "Connect to WSL" 选项，需要先安装 WSL 扩展。

三、JetBrains IDEs 集成 ​

安装插件 ​

  1. 打开 JetBrains IDE（PyCharm、WebStorm、IntelliJ 等）
  2. 进入 Settings/Preferences → Plugins
  3. 搜索 "Claude Code"
  4. 点击安装

或者通过链接下载： https://plugins.jetbrains.com/plugin/claude-code

使用方式 ​

  1. 在 IDE 内置终端中运行 claude
  2. 插件会自动检测并连接
  3. 你可以在 IDE 中直接看到 Claude Code 的改动

手动指定 IDE ​

如果自动检测失败，可以手动指定：

bash
claude
> /ide

然后选择你使用的 IDE。

常见问题 ​

1. IDE 无法检测到 Claude Code ​

确保：

  • 在 IDE 的内置终端中启动 Claude Code
  • 插件已正确安装并启用
  • 尝试重启 IDE

2. 无法看到代码改动 ​

检查：

  • Claude Code 是否有文件操作权限
  • IDE 是否打开了正确的项目目录

3. WSL 连接失败 ​

确保：

  • 已安装 WSL 和 Ubuntu
  • WSL 扩展已正确安装
  • 尝试重启 Cursor

更多资源 ​

AI 助手安装指南

Copyright © 2026