文心快码插件安装后必须配置本地api服务地址（如http://127.0.0.1:8501），否则代码补全、生成、解释等功能将连接超时或空白；需在vs code设置中填写“wenxinquickcode.baseurl”，并确保文心一言pc端已启动且显示“服务就绪”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
文心快码插件安装后必须完成代理配置，否则无法调用本地大模型服务，所有代码补全、生成、解释功能将显示“连接超时”或直接空白。
确认文心快码已正确安装
打开VS Code → 左侧活动栏点击扩展图标（或按 Ctrl+Shift+X）→ 在搜索框输入“文心快码” → 查看是否显示已安装且状态为“已启用”。【若仅显示“已安装”但未启用，右键选择“启用”】
这一步操作起来很简单，直接在扩展列表里点一下启用按钮就行。如果没看到“文心快码”，说明插件根本没装成功，先别往下走，回去重装。
启动本地文心一言PC端并获取服务地址
确保文心一言Windows客户端已安装并运行：双击桌面快捷方式启动 → 登录百度账号 → 等待左下角状态栏显示“服务就绪”（绿色圆点）。
点击主界面右上角齿轮图标 → 进入“设置” → 切换到“开发者选项” → 找到“本地API服务”模块 → 开启开关 → 记录下方显示的HTTP地址，典型格式为 http://127.0.0.1:8501。【该地址每次启动可能变动，务必以当前界面显示为准】
注意：如果此处开关是灰色不可点，说明你没登录账号，或当前版本不支持本地API（需升级至v3.2.0及以上），请先检查更新。
在VS Code中配置代理地址
方法一：通过设置UI配置（推荐新手）
Ctrl+, 打开设置 → 左上角搜索框输入“wenxin quick code base url” → 在“Extensions → Wenxin Quick Code”分类下找到“Base Url”选项 → 将上一步复制的地址（如 http://127.0.0.1:8501）粘贴进去 → 回车保存。
方法二：手动编辑settings.json（适合批量管理或多环境切换）
Ctrl+Shift+P → 输入“Preferences: Open Settings (JSON)” → 回车 → 在大括号内添加一行："wenxinQuickCode.baseUrl": "http://127.0.0.1:8501" → 保存文件。
两种方式效果完全一致，但方法二可直接复制粘贴多台机器复用配置。若填错端口（比如写成8500），插件会持续报错“ECONNREFUSED”，此时只需改回正确端口即可，无需重启VS Code。
验证代理连通性
第一步：在VS Code任意打开一个.py或.js文件
第二步：光标置于空行 → 按 Alt+C（Windows/Linux）或 Option+C（macOS）触发代码生成
第三步：观察右下角状态栏是否出现“文心快码：正在响应…”提示 → 若3秒内返回代码块，说明代理配置成功。
第四步：如提示“无法连接到本地服务”，请立即检查：
① 文心一言PC端是否仍在运行（任务栏有图标且未退出）；
② VS Code设置里的base url末尾有没有多余空格或中文字符；
③ 防火墙是否拦截了8501端口（Windows Defender需允许“WenxinYiYan.exe”通过专用网络）。
