PyCharm 集成 Claude Code 插件：安装、配置与使用指南

Claude Code 是一款强大的 AI 编程助手，能够帮助开发者完成代码补全、代码解释、重构和问题解答等任务。本文将详细介绍如何在 PyCharm 中安装并配置 Claude Code 插件，同时通过阿里云百炼（MaaS）平台接入国产大模型，实现零改动使用 Claude Code 工作流。

[1. 安装 Claude Code 插件](#1. 安装 Claude Code 插件)
[2. Claude Code 配置](#2. Claude Code 配置)
- [2.1 安装 SDK 依赖](#2.1 安装 SDK 依赖)
- [2.2 供应商配置](#2.2 供应商配置)
- [2.3 配置供应商](#2.3 配置供应商)
[3. 使用 Claude Code](#3. 使用 Claude Code)
[4. 总结](#4. 总结)

1. 安装 Claude Code 插件

打开 PyCharm，点击菜单栏的 File → Settings （Windows/Linux）或 PyCharm → Preferences（macOS）。
选择 Plugins ，点击 Marketplace 标签页。
在搜索框中输入 "Claude Code"。

如图：
点击 Install 按钮开始安装。
安装完成后，重启 PyCharm 以激活插件。
重启后，在编辑器右侧可以看到 Claude Code 插件按钮。

如图：

2. Claude Code 配置

2.1 安装 SDK 依赖

在开始配置前，需要确保已安装 Claude Code SDK 依赖。

点击右侧的 Claude Code 插件按钮，点击设置（齿轮图标），找到 SDK 依赖管理 （第 3 项），如图：

2.2 供应商配置

在 C 盘用户目录下创建一个文件夹 .claude，例如：

复制代码

C:\Users\Administrator\.claude

在该文件夹中创建一个 settings.json 文件，内容如下：

json 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的API-KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.1",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  }
}

注意：请将 "你的API-KEY" 替换为你在阿里云百炼平台申请的实际 API Key。

这是一份 Claude Code 环境变量配置，用于将 Claude Code 的请求代理到第三方模型服务。逐项解析如下：

🔗 基础连接

变量	值	作用
`ANTHROPIC_BASE_URL`	`https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic`	API 请求的代理地址。将原本发往 Anthropic 官方 API 的请求，转发到阿里云百炼（MaaS）平台，使用 Anthropic 兼容接口格式
`ANTHROPIC_AUTH_TOKEN`	`你的API-KEY`	认证令牌，需替换为你在阿里云百炼平台的实际 API Key

🧠 模型映射

Claude Code 内部按"能力等级"使用三种模型，这里将它们分别映射到国产模型：

变量	映射到	Claude Code 中的角色
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`qwen3.7-max`	最强模型（Opus 级）------ 用于复杂推理、架构设计等高难度任务
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`deepseek-v4-pro`	主力模型（Sonnet 级）------ 日常编码、文件编辑等核心工作模型
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`glm-5.1`	轻量模型（Haiku 级）------ 用于快速简单任务，如摘要、小工具调用
`CLAUDE_CODE_SUBAGENT_MODEL`	`deepseek-v4-flash`	子代理专用模型 ------ Agent 工具派出的子代理（如 Explore、Plan）使用的模型

📌 配置意图

这份配置的意图是：完全绕过 Anthropic 官方 API，通过阿里云百炼平台的 Anthropic 兼容接口，将 Claude Code 的四个模型槽位分别替换为四款国产大模型（通义千问、DeepSeek、智谱 GLM），实现零改动地使用 Claude Code 的工作流。

2.3 配置供应商

在设置（齿轮图标）中，找到 供应商管理 （第 2 项），如图：

授权并启用 "使用本地 settings.json"。

3. 使用 Claude Code

安装配置完成后，可以通过以下方式使用 Claude Code：

代码补全：在编写代码时，Claude Code 会自动提供智能补全建议。
代码解释：选中代码片段，右键选择 "Explain with Claude" 获取解释。
代码重构：选中代码，使用重构功能优化代码结构。
问题解答：在聊天窗口中直接提问编程相关问题。

如图：问题解答

如图：代码解释（右键打开 Claude Code）

如图：调用查看

在编辑器中，可以通过右键菜单调用 Claude Code 功能：

4. 总结

通过以上步骤，你已成功在 PyCharm 中安装并配置了 Claude Code 插件。借助阿里云百炼平台的 Anthropic 兼容接口，你可以将 Claude Code 的模型槽位映射到国产大模型（如通义千问、DeepSeek、智谱 GLM），在保留原有工作流的同时，享受更低成本、更稳定的 AI 编程体验。

关键点回顾：

安装插件：Marketplace 搜索 "Claude Code" 并安装。
安装 SDK 依赖：在插件设置中完成。
配置 settings.json：设置代理地址、API Key 及模型映射。
启用本地配置：在供应商管理中授权并启用 "使用本地 settings.json"。
开始使用：代码补全、解释、重构、问答一应俱全。

装。

安装 SDK 依赖：在插件设置中完成。
配置 settings.json：设置代理地址、API Key 及模型映射。
启用本地配置：在供应商管理中授权并启用 "使用本地 settings.json"。
开始使用：代码补全、解释、重构、问答一应俱全。

如果在配置过程中遇到问题，欢迎在评论区留言交流。