Claude Code的Idea插件开发指南：从零搭建到高效编码

1次阅读

共计 2859 个字符，预计需要花费 8 分钟才能阅读完成。

在开始开发 Claude Code 的 Idea 插件前，需要确保开发环境满足以下要求：

JDK 版本：推荐使用 JDK 11 或更高版本，这是 IntelliJ 插件开发的主流支持版本
IDEA 版本：2021.3 及以上社区版或旗舰版，注意安装 Plugin Development Kit 插件
构建工具：Gradle 6.8+（IDEA 内置）或手动配置
首先在 IDEA 中创建新项目，选择 ”IntelliJ Platform Plugin” 模板

在 build.gradle.kts 中配置必要的依赖：

intellij {version.set("2021.3")
    plugins.set(listOf("java", "Kotlin"))
}

dependencies {implementation("com.squareup.okhttp3:okhttp:4.9.3") // HTTP 客户端
    implementation("com.google.code.gson:gson:2.8.9")  // JSON 处理
}

IntelliJ 插件主要基于以下核心机制构建：

Action 系统：用户交互的入口点，通过注册动作响应菜单 / 快捷键

public class ClaudeAction extends AnAction {
    @Override
    public void actionPerformed(@NotNull AnActionEvent e) {
        // 获取当前编辑器
        Editor editor = e.getData(CommonDataKeys.EDITOR);
        // 调用 Claude 服务处理代码
    }
}

Service 机制 ：插件生命周期管理，分项目级(ProjectService) 和应用级(ApplicationService)
PSI(Program Structure Interface)：用于代码分析和操作的核心 API

class ClaudeAuthService {
    private val tokenStorage = PersistentStateComponent

    fun authenticate(clientId: String, clientSecret: String): Boolean {val request = Request.Builder()
            .url("https://api.claude.ai/oauth2/token")
            .post(FormBody.Builder()
                .add("grant_type", "client_credentials")
                .build())
            .header("Authorization", Credentials.basic(clientId, clientSecret))
            .build()

        return try {val response = OkHttpClient().newCall(request).execute()
            val tokens = Gson().fromJson(response.body?.string(), TokenResponse::class.java)
            tokenStorage.saveTokens(tokens)
            true
        } catch (e: Exception) {
            Notifications.Bus.notify(Notification("Claude", "认证失败", e.message!!, NotificationType.ERROR))
            false
        }
    }
}

public class ClaudeCompletion {
    private static final String API_ENDPOINT = "https://api.claude.ai/v1/completions";

    public String getSuggestion(String prompt) throws IOException {JsonObject requestBody = new JsonObject();
        requestBody.addProperty("prompt", prompt);
        requestBody.addProperty("max_tokens", 150);

        Request request = new Request.Builder()
            .url(API_ENDPOINT)
            .post(RequestBody.create(requestBody.toString(), 
                MediaType.get("application/json")))
            .header("Authorization", "Bearer" + getAccessToken())
            .build();

        try (Response response = client.newCall(request).execute()) {return parseResponse(response.body().string());
        }
    }
}

缓存层设计：
对常用代码片段建议缓存 24 小时

使用 Caffeine 实现内存缓存：

val cache = Caffeine.newBuilder()
    .maximumSize(1000)
    .expireAfterWrite(24, TimeUnit.HOURS)
    .build<String, String>()

异步处理：
耗时操作放入后台线程

使用 IDEA 的 Task.Backgroundable：

new Task.Backgroundable(project, "Getting Claude Suggestions") {public void run(@NotNull ProgressIndicator indicator) {// API 调用代码}
}.queue();

请求批处理：将多个小请求合并为单个 API 调用

ClassNotFound 异常：检查 build.gradle 是否包含所有运行时依赖
认证失败：确认 OAuth token 未过期（默认 1 小时有效期）
PSI 访问冲突：确保在 ReadAction 中执行代码分析

在 plugin.xml 中添加：

<extensions defaultExtensionNs="com.intellij">
    <notificationGroup 
        id="Claude Notifications" 
        displayType="BALLOON"
        isLogByDefault="true"/>
</extensions>