VSCode Codex面板无法使用？彻底解决方案

这篇教程详细梳理了在远程服务器上配置 Claude Code 并安装 Codex CLI 的完整操作流程。核心步骤包括：在 VS Code 远程环境中安装 Claude Code 插件，手动配置 ~/.claude/settings.json 文件以设置 API 参数，通过 Claude Code 在远程服务器上安装 Codex CLI，最后借助包装脚本解决环境变量问题。整个过程中需要注意：必须使用普通用户登录，不能使用 root 账户，且所有操作都需在远程端完成。

第一步：安装 Claude Code

安装 Claude Code 既是首要任务，也为后续安装 Codex CLI 打下基础。操作方式简单直观：打开 VS Code 并连接到远程服务器，在插件商店中搜索并安装 Claude Code for VS Code 插件。务必确保插件安装到远程环境中，这样才能直接操作服务器上的项目。特别提醒：远程环境必须使用普通用户登录，root 用户无法使用 Claude Code 面板。

第二步：配置 API 参数

远程服务器通常运行 Linux 系统，因此需要编辑 ~/.claude/settings.json 文件来填写 API 配置。根据实际经验，许多环境下该文件不会自动生成，需要手动新建并修改，可通过 Xshell 等终端工具完成。具体配置方法：使用 vim 打开 settings.json，粘贴以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你自己的api_key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

第三步：确认配置生效

文件保存后，重启 VS Code 并重新连接远程服务器。此时 Claude Code 的配置即生效，可在远程环境中正常使用。

第四步：在插件商店中搜索并安装 Codex 插件

第五步：通过 Claude Code 在远程服务器上安装 Codex CLI

直接输入安装指令，按照提示完成辅助工具的安装并确认即可。

请在远程服务器环境中安装 Codex CLI，确保是在远程端完成配置，并且测试成功返回结果。

第六步：输入关键指令（最关键一步）

这是我的 base_url 和 api_key（需要你提供），请你把扩展内置的二进制方法替换成包装脚本，启动二进制前设置 OPENAI_API_KEY 和 CODEX_HOME，并且包装脚本在真正调用二进制之前把环境变量设置好，下次完全重连时自动注入环境变量。

注：如果还是不行，输入：请围绕上面的方法继续解决 VS Code 的 Codex 面板不能用的问题。

第七步：重载窗口并重新连接

所有配置完成后，在 VS Code 中按 F1，输入“Developer: Reload Window”，重载窗口，然后重新连接远程服务器即可。