vscode人工智能插件需按类型区分安装：通义灵码要求vs code≥1.68.0+阿里云账号，腾讯云ai依赖网络鉴权，opencode需手动配置opencode二进制及path，fitten code支持切换本地模型但需手动配置。
VSCode 人工智能插件不能“一键通装”，必须按插件类型区分下载方式：通义灵码、腾讯云AI、OpenCode、Fitten Code 四类主流工具，安装路径、依赖条件、登录机制完全不同，混用会导致图标不显示、右键无响应、命令不可用。
通义灵码必须用 VS Code ≥1.68.0 + 阿里云账号登录
低于 1.68.0 的 VS Code（比如旧服务器上长期未更新的 1.59.1）会加载失败，左侧图标空白，点击无反应——这不是插件问题，是 Webview 兼容性中断。安装后不重启 VS Code，插件界面根本不会初始化；登录时若选微信快捷登录，服务端直接返回 401 Unauthorized，且无明确错误提示，只显示“请先登录”。
- 在线安装：Ctrl+Shift+X → 搜索
TONGYI Lingma→ 认准发布者Alibaba Cloud - 离线安装：从官网下载
.vsix文件 → 扩展面板右上角 “⋯” → “从 VSIX 安装” - 登录入口在左侧图标点击后弹出的界面，不是右下角通知栏
- 验证功能：选中一段代码 → 右键 →
通义灵码 → 解释这段代码，非解释代码或其他模糊名称
腾讯云AI代码助手3.0 不需要额外运行时，但依赖网络鉴权
它不像 OpenCode 那样要本地跑 opencode 进程，也不像 Fitten Code 需要 Bun 支持，但首次启用时会卡在“正在连接云端服务”超过 10 秒——这是正常现象，不是卡死。如果 30 秒后仍无响应，大概率是企业防火墙拦截了 https://ai.tencent.com 域名或 WebSocket 连接。
- 搜索关键词必须是
腾讯云AI代码助手，不是“Tencent AI”或“TCAI” - 安装后无需重启，但首次使用需等待约 15 秒完成模型路由协商
- 快捷指令如
/explain、/fix必须在插件聊天窗口中输入，不能在普通终端或编辑器命令面板里执行 - 不支持离线模式，断网后所有功能灰显，包括已缓存的对话历史
OpenCode 要手动下载二进制并配置 PATH，否则 opencode 命令报错
VS Code 插件市场里的 OpenCode 只是前端壳，真正干活的是你本地下载的 opencode.exe（Windows）或 opencode（macOS/Linux）。如果没放对位置或没加进 PATH，终端里敲 opencode 就会提示 command not found，插件界面也显示“未检测到核心服务”。
- Windows 推荐解压后放到
C:\Windows\System32，免配环境变量 - macOS/Linux 用户必须把二进制所在目录加入
$PATH，并在终端执行source ~/.zshrc（或~/.bash_profile）刷新 - 若遇到
bun: command not found，说明插件内置脚本依赖 Bun 运行时，需单独安装：执行powershell -c "irm bun.sh/install.ps1 | iex"（Win）或curl -fsSL https://bun.sh/install | bash（macOS/Linux） - 启动命令必须在 VS Code 内置终端中运行
opencode，不能在系统终端里开一个独立窗口
Fitten Code 默认走云端模型，但可切换本地 LLM（需手动改配置）
它不像通义灵码那样强制绑定厂商账号，注册邮箱就能用，但默认所有请求都发往 Fitten 官方 API。如果你希望用本地 Ollama 或 LM Studio 模型，得手动编辑 settings.json，否则即使装了 ollama run qwen2.5，Fitten Code 也不会自动识别。
- 快捷键
Ctrl+Alt+C是全局触发聊天，Ctrl+Alt+G是生成代码，两者行为不同，别记混 - 选中代码再触发对话，插件会自动把代码片段作为上下文传入，不选中则只做通用问答
- 要切本地模型：打开 VS Code 设置 → 搜索
fitten.modelProvider→ 改为ollama，再设fitten.ollamaModel为qwen2.5或phi3 - 不改配置就以为“已本地化”，实际所有代码都上传到了第三方服务器
最常被忽略的一点：四个插件的右键菜单项命名规则不一致，解释这段代码（通义灵码）、/explain（腾讯云）、Explain Selection（Fitten Code）、Explain Code（OpenCode），名字差一个字，功能可能完全不可用。别凭印象点，一定看准完整文字再操作。
