必须先验证本地grok-4.3服务是否就绪，即访问http://localhost:8080/health返回{"status":"ok"}；再安装proxy ai插件并配置custom openai provider；最后通过external tools（推荐python脚本封装方式）或run configuration绑定实现一键分析当前文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在PyCharm里不离开代码编辑界面，直接调用Grok-4.3模型完成代码解释、错误诊断或生成建议，避免反复切换浏览器或终端手动执行curl命令——这要求把Grok服务封装成可一键触发的External Tools，且能自动注入当前文件路径、选中文本等上下文信息。
确认本地Grok-4.3服务已运行
启动Grok-4.3前必须确保它已在本地监听HTTP端口，否则External Tools配置后点击运行会直接报错Connection refused。推荐使用官方提供的Docker镜像启动：docker run -d -p 8080:8080 --name grok43 grok43:latest。若用Python SDK方式部署，请确认uvicorn main:app --host 0.0.0.0 --port 8080已成功执行且无报错日志。
打开浏览器访问 http://localhost:8080/health，返回{"status":"ok"}即为就绪。这一步跳过会导致后续所有调用失败，【必须验证】。
安装Proxy AI插件（支持Grok自定义Provider）
File → Settings → Plugins → 搜索框输入“Proxy AI” → 点击Install → 重启PyCharm。
重启后，点击右侧工具栏的Proxy AI图标 → Providers → Add Provider → 选择Custom OpenAI → 填写以下字段：
API Base URL：http://localhost:8080/v1
API Key：留空（Grok-4.3本地服务无需密钥）
Model Name：grok-4.3
点Save，此时你在代码中选中文本按快捷键Ctrl+Shift+P就能调用Grok解释，但该方式无法传入完整文件上下文——要实现“一键分析当前.py文件”，仍需External Tools。
配置External Tools调用Grok-4.3
方法一：通过curl命令行直接调用（适合调试）
Settings → Tools → External Tools → + → 填写：
Group：Grok
Name：Analyze Current File
Program：curl
Arguments：-X POST http://localhost:8080/v1/chat/completions -H "Content-Type: application/json" -d "{"model":"grok-4.3","messages":[{"role":"user","content":"请逐行分析以下Python代码，指出潜在bug和优化建议：\n$FILE_CONTENT$"}]}"
Working directory：$ProjectFileDir$
⚠️注意：$FILE_CONTENT$宏仅在PyCharm 2026.1+版本支持，旧版本会显示为空字符串——此时必须改用方法二。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
方法二：用Python脚本封装调用（兼容所有版本）
第一步：在项目根目录新建grok_cli.py，内容如下：
import sys, json, requests<br>file_path = sys.argv[1]<br>with open(file_path, 'r', encoding='utf-8') as f:<br> content = f.read()<br>payload = {"model": "grok-4.3", "messages": [{"role": "user", "content": f"请严格按三段式回复：1. 语法检查；2. 逻辑风险；3. 性能建议。代码：\n{content}"}]}<br>r = requests.post("http://localhost:8080/v1/chat/completions", json=payload)<br>print(r.json()["choices"][0]["message"]["content"])
第二步：External Tools中配置：
Program：$PyInterpreterDirectory$/python
Arguments：$ProjectFileDir$/grok_cli.py $FilePath$
Working directory：$ProjectFileDir$
第三步：为该工具分配快捷键。右键菜单 → Edit Tool → Keyboard Shortcut → 设置为Alt+G。
现在选中任意.py文件 → 按Alt+G → 输出窗口将实时打印Grok-4.3的结构化分析结果。
绑定到Run Configuration实现保存即分析
第一步：打开Run → Edit Configurations → 选中当前运行配置 → 点击Modify options → Add before launch → Run External Tool → 勾选刚创建的“Analyze Current File”。
第二步：勾选“Only if exit code is 0”，防止Grok服务临时宕机导致程序无法运行。
第三步：点击OK保存。此后每次点击绿色三角形运行按钮前，PyCharm会先调用Grok扫描当前文件——【此操作不可逆，一旦启用，每次运行必触发Grok分析】。
若当前文件无语法错误，Grok输出会直接显示在Run窗口；若存在未处理异常，输出将包含修复提示并高亮问题行号。
