How do I install the Codex Proxy Repair skill?

Run npx skillmds@latest add iris-ymy/codex-proxy-repair in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codex Proxy Repair safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codex Proxy Repair?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codex Proxy Repair free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codex Proxy Repair?

iris-YMY (@iris-ymy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codex Proxy Repair by iris-ymy — Agent Skill

Name: Codex Proxy Repair
Author: iris-YMY

Codex Proxy Repair

Diagnose and safely repair repeated Codex reconnecting, sampling-stream disconnects, WebSocket connection failures, or missing proxy inheritance on macOS or Windows. Use when Codex Desktop, ChatGPT Desktop's Codex surface, the IDE extension, or Codex CLI repeatedly reconnects or cannot reach chatgpt.com. Diagnose before changing settings and never guess a proxy port.

iris-YMY Updated Sep 21, 2026

File contents

Repair Codex proxy connectivity

Detect the host operating system and read exactly one platform reference:

macOS: references/macos-proxy-repair.md
Windows: references/windows-proxy-repair.md

Required behavior

Inspect effective proxy variables, system proxy settings, proxy processes, listening ports, and PID ownership before changing anything.
Distinguish HTTP, SOCKS, mixed, control, DNS, and API ports. Never treat a control or DNS port as a proxy port.
Verify a candidate HTTP or mixed proxy with a short-timeout HTTPS or HTTP CONNECT request before modification.
Back up existing non-empty values and modify only the smallest user-scoped configuration proven to be inherited by the installed Codex build.
Do not assume ~/.codex/.env is read. Use it only after local or official evidence verifies that behavior for the installed version.
Never reveal credentials or overwrite unrelated configuration.
Stop when multiple candidates remain ambiguous.
Re-read effective values, confirm the port still listens, and require a full application restart before final verification.

Writes to environment variables, launch settings, or configuration are state changes and require authorization unless already explicitly requested.

Frequently asked questions