Claude API 接入实战：从零开始实现 IDEA 插件开发

2次阅读

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

Claude API 是 Anthropic 公司推出的大语言模型服务接口（Large Language Model API），支持通过编程方式调用其对话和文本生成能力。相比直接使用网页版，API 集成可以实现以下典型场景：

智能代码补全 ：根据当前代码上下文提供建议
文档生成 ：自动生成函数注释或技术文档
错误诊断 ：分析异常堆栈并给出修复建议

其特色在于响应格式同时支持常规 JSON 和流式传输（Streaming），适合需要实时交互的 IDE 插件场景。

在 build.gradle.kts 中添加以下依赖项（注意使用 plugins 块和 dependencies 分离的现代写法）：

plugins {id("java")
    id("org.jetbrains.kotlin.jvm") version "1.9.0"
    id("org.jetbrains.intellij") version "1.15.0"
}

dependencies {implementation("io.ktor:ktor-client-core:2.3.3")
    implementation("io.ktor:ktor-client-cio:2.3.3")
    implementation("io.ktor:ktor-client-content-negotiation:2.3.3")
    implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.3")
    implementation("commons-codec:commons-codec:1.16.0") // HMAC 签名用
}

登录 Anthropic 控制台
在 API Keys 页面创建新密钥
记录下 API Key 和当前账户的 API Version（如 2023-06-01）

使用 Ktor 的 HttpClient 配置指数退避重试策略：

val client = HttpClient(CIO) {install(HttpRequestRetry) {
        maxRetries = 3
        retryOnExceptionIf { _, cause ->
            cause is SocketTimeoutException || cause is ConnectTimeoutException
        }
        delayMillis { retry -> 
            (1000L * retry * retry) // 1s, 4s, 9s 二次退避
        }
    }
    // 其他配置...
}

Claude API 要求在每个请求的 x-api-signature 头中包含 HMAC-SHA256 签名：

fun generateSignature(
    apiKey: String,
    timestamp: String,
    body: String
): String {val secretKey = SecretKeySpec(apiKey.toByteArray(), "HmacSHA256")
    val mac = Mac.getInstance("HmacSHA256")
    mac.init(secretKey)
    val rawHmac = mac.doFinal("$timestamp$body".toByteArray())
    return Hex.encodeHexString(rawHmac)
}

通过协程实现逐块接收响应内容（关键代码节选）：

suspend fun streamCompletion(prompt: String): Flow<String> = flow {val response = client.post("https://api.anthropic.com/v1/complete") {
        headers {append("Content-Type", "application/json")
            append("x-api-signature", generateSignature(apiKey, timestamp, requestBody))
        }
        setBody(TextContent(requestBody, ContentType.Application.Json))
    }

    response.bodyAsChannel().toFlow().collect { bytes ->
        emit(bytes.decodeToString())
    }
}

每个 API Key 默认限制 60 RPM（Requests Per Minute）
推荐实现本地请求队列管理：

class RateLimiter(private val maxPermits: Int, private val period: Duration) {private val semaphore = Semaphore(maxPermits)
    private val timer = fixedRateTimer(period = period)

    init {timer.scheduleAtFixedRate(0, period.toMillis()) {semaphore.release(maxPermits - semaphore.availablePermits())
        }
    }

    suspend fun acquire() = withContext(Dispatchers.IO) {semaphore.acquire()
    }
}

使用 IntelliJ 自带的 PasswordSafe 组件（需要添加 intellij.platform.credentialStore 依赖）：

val credentialAttributes = CredentialAttributes(
    "Claude_API_Key",
    serviceName = "ClaudePlugin"
)

// 存储
PasswordSafe.instance.set(credentialAttributes, apiKey)

// 读取
val apiKey = PasswordSafe.instance.get(credentialAttributes)

通过 Micrometer 埋点（需额外添加依赖）：

val registry = SimpleMeterRegistry()
val timer = Timer.builder("claude.api.latency")
    .publishPercentiles(0.5, 0.95)
    .register(registry)

fun measureRequest(block: () -> Unit) {val sample = Timer.start()
    try {block()
    } finally {sample.stop(timer)
    }
}

<idea-plugin>
    <id>com.your.company.unique.id</id>
    <name>Claude Assistant</name>
    <version>1.0</version>

    <depends>com.intellij.modules.platform</depends>

    <extensions defaultExtensionNs="com.intellij">
        <toolWindow id="Claude" anchor="right" 
                   factoryClass="com.your.package.ClaudeToolWindowFactory"/>
    </extensions>

    <actions>
        <action id="Claude.GenerateCode" 
                class="com.your.package.GenerateCodeAction" 
                text="Ask Claude" description="Get AI suggestions">
            <add-to-group group-id="EditorPopupMenu" anchor="last"/>
        </action>
    </actions>
</idea-plugin>