CodeGeeX 默认不原生支持 Remote-SSH，需手动配置 extensionKind 为 ["ui", "workspace"]、透传本地代理、同步 auth.json 并安装远程依赖，否则插件不加载、无响应或提示未登录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在 VSCode 远程开发（Remote-SSH）中正常使用 CodeGeeX 插件，却总遇到插件不加载、提示“未连接到服务”、AI 响应空白或本地认证失效等问题，根本原因是 CodeGeeX 默认只在本地运行，远程端缺少运行时依赖、认证上下文和网络代理链路。
确认 CodeGeeX 是否支持远程模式
打开 VSCode 扩展市场 → 搜索 CodeGeeX → 点击插件详情页 → 查看「Extension Kind」字段。若显示为 【UI】 或仅标注 “Client”，说明该插件**不原生支持远程开发**；只有明确标注 “Workspace” 或 “Server” 的版本才可部署到远程服务器。当前（2026年6月）官方最新版 CodeGeeX（v2.12.3）仍为 UI 类型插件，必须强制启用远程运行策略。
这一步跳过会导致后续所有配置无效——远程窗口里根本看不到插件面板。
强制启用远程端 CodeGeeX 运行（关键步骤）
方法一：修改插件 manifest.json（需手动解压）
找到本地 VSCode 扩展目录：
Windows：%USERPROFILE%\.vscode\extensions\codex-team.codegeex-*
macOS/Linux：~/.vscode/extensions/codex-team.codegeex-*
用 ZIP 工具解压 package.json → 找到 "extensionKind" 字段 → 将其值从 ["ui"] 改为 ["ui", "workspace"] → 保存 → 重新压缩为 ZIP → 替换原文件（注意保留文件名后缀）。
方法二：VSCode 设置覆盖（推荐，免解压）
在远程连接成功后的 VSCode 窗口中 → 打开设置（Ctrl+,）→ 搜索 remote.extensionKind → 点击「在 settings.json 中编辑」→ 添加如下配置：
"remote.extensionKind": { "codex-team.codegeex": ["ui", "workspace"] }
【必须重启远程窗口才能生效】 关闭当前远程窗口 → 点击左下角绿色 SSH 状态栏 → 选择 “Reopen Folder in Remote Window”。
修复远程端网络与认证断连问题
第一步：确认远程服务器能访问 CodeGeeX 服务端
在远程终端执行：curl -I https://api.codegeex.cn/v1/chat/completions
若返回 HTTP/2 401 或 200，说明网络通；若超时或报 Could not resolve host，说明远程服务器无法直连公网，必须配置代理。
专为资深工程师设计，用于高效日常使用 GitHub Copilot CLI。适用于在规划、提示、审查或链式调用 gh copilot 命令时，探索代码库、起草变更、调试问题或加速工作流，且不偏离架构意图。
第二步：将本地代理链路透传至远程
在本地 VSCode 的 settings.json 中添加：
"remote.SSH.enableAgentForwarding": true,"http.proxy": "http://127.0.0.1:7897","codegeex.apiProxy": "http://127.0.0.1:7897"
第三步：确保远程端读取的是本地生成的 auth token
CodeGeeX 登录后会在本地生成 ~/.codegeex/auth.json。必须将该文件 SCP 复制到远程同路径：scp ~/.codegeex/auth.json 用户名@服务器IP:~/.codegeex/
远程端无此文件则始终提示“请登录”。
安装远程端运行依赖（Ubuntu/Debian 示例）
① 连接远程服务器后，打开集成终端（Ctrl+`）
② 执行：sudo apt update && sudo apt install -y curl jq python3-pip
③ 安装 CodeGeeX 所需的 Python 运行时依赖：pip3 install --user requests pydantic
④ 验证是否可调用基础 API：python3 -c "import requests; print(requests.get('https://api.codegeex.cn/v1/status', timeout=5).json())"
若报错 ModuleNotFoundError: No module named 'requests'，说明第③步失败，需检查 pip3 是否可用及用户权限。
注意：CentOS/RHEL 用户请改用 yum install -y curl jq python3-pip，且可能需额外执行 pip3 install --user --upgrade pip 升级 pip 版本。
禁用冲突插件并重载远程窗口
远程窗口中，按 Ctrl+Shift+P → 输入 “Extensions: Show Enabled Extensions” → 禁用以下任一插件：
• GitHub Copilot（与 CodeGeeX 共享同一底层模型通道，会抢夺 auth token）
• TabNine（旧版存在 TLS 握手劫持，导致 CodeGeeX 请求被静默丢弃）
• 自定义 HTTP 代理类插件（如 Auto Proxy、SwitchyOmega Helper）
完成禁用后 → 按 Ctrl+Shift+P → 输入 “Developer: Reload Window” → 回车。
此时状态栏应出现 CodeGeeX 图标，点击即可唤出对话框，输入任意问题测试响应。
