🌟 Bonus: OpenAI Codex CLI — referenční guide

Bonus: OpenAI Codex CLI

🎯 Pro koho je tento dokument: student, který získá vlastní OpenAI auth (ChatGPT Plus, Pro, Business, nebo OpenAI API key). Codex CLI je terminálový tool od OpenAI — analog Claude Code, ale na OpenAI modelech.

⚠️ Důležité: Codex CLI není pokrytý GitHub Copilot subscription. Pokud máš jen Copilot ze školy, tento dokument dnes nepotřebuješ. Hlavní kurz Den 8 je Copilot migration v VS Code.

🚀 Install

npm install -g @openai/codex
codex --version

Mac alternative: brew install --cask codex.

Windows tip: Pokud npm install -g selže s permission errorem, otevři PowerShell jako Admin, NEBO npm config set prefix $HOME\.npm-global.

🔐 Auth — 2 cesty

Pokud máš ChatGPT Plus/Pro/Business/Edu/Enterprise:

codex login --device-auth

CLI vrátí 6-znakový kód + URL auth.openai.com/codex/device. V prohlížeči vlož kód, potvrdíš ChatGPT login.

⚠️ NIKDY codex login bez --device-auth v VS Code integrated terminálu — localhost callback selhává (issue #12263).

⚠️ Předpoklad: ChatGPT účet musí mít device code login povolen (Settings → Security). Free tier účty to mívají vypnuté.

Cesta B: API key

Pokud máš vlastní OpenAI API key (sk-... z platform.openai.com):

$env:OPENAI_API_KEY = "sk-..."
codex login --with-api-key

Pro perzistenci: Win → environment variables → User variables → New OPENAI_API_KEY.

Status check

codex login status

Exit code 0 = OK.

📝 Instructions: AGENTS.md

Codex čte AGENTS.md v repo rootu jako primary instructions. Globálně preferuje ~/.codex/AGENTS.md.

# Migrate z Claude Code:
mkdir $HOME\.codex -Force
Copy-Item $HOME\.claude\CLAUDE.md $HOME\.codex\AGENTS.md

Project-level: ve své projektové složce Copy-Item CLAUDE.md AGENTS.md.

🔧 Skills (cross-agent compatible)

mkdir $HOME\.codex\skills -Force
Copy-Item -Recurse $HOME\.claude\skills\* $HOME\.codex\skills\

# Enable feature (persistent):
codex features enable skills

# Alternativy:
# codex --enable skills           (runtime only)
# codex -c features.skills=true   (per-call override)
# Manuál v ~/.codex/config.toml: [features]\nskills = true

Trigger: /skills v CLI vypisuje seznam. Volání /jméno-skillu nebo natural fallback („použij skill X”).

Cross-agent standard: SKILL.md je identický napříč Claude Code, Codex CLI, Copilot. Žádná úprava při kopírování.

🌐 MCP servery

Manuální TOML edit (primární — spolehlivá)

~/.codex/config.toml:

[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]

# S diakritikou v username (ASCII fallback):
env = { MEMORY_FILE_PATH = "C:\\Users\\<jméno>\\.codex\\memory.json" }

Restart codex. V CLI: /mcp → musíš vidět memory.

CLI command (sekundární — syntax různých verzí)

codex mcp add memory -- npx -y @modelcontextprotocol/server-memory

Pokud nefunguje, codex mcp add --help a porovnej.

🤖 Sub-agenti

/agent v CLI — switch mezi aktivními agent thready.

Custom agenti: ~/.codex/agents/*.toml (TOML format):

name = "code-reviewer"
description = "Specialista na review kódu"
model = "gpt-5.3-codex"
sandbox_mode = "read-only"

Codex spouští subagenty jen když explicit požádáš.

📊 Modely (Q2 2026)

Model	Použití	Auth
GPT-5.5	Flagship, complex coding	Jen ChatGPT login (ne API key zatím)
GPT-5.4	Flagship pro API	API key i ChatGPT
GPT-5.4-mini	Rychlý, levný, subagenty	API key i ChatGPT
GPT-5.3-Codex	Coding specialist	API key i ChatGPT

🛟 Troubleshooting

Symptom	Řešení
`npm install -g` permission error	PowerShell jako admin / `npm config set prefix`
Browser login nefunguje (VSCode terminal)	`codex login --device-auth`
`Invalid API key`	Vygeneruj nový z platform.openai.com
`/skills` prázdné	`codex features enable skills`, restart
`codex mcp add` syntax error	Manuální TOML edit `~/.codex/config.toml`
`/mcp` neukazuje memory	`/exit` + `codex` znovu
GPT vrací jinak než Claude	Model osobnost — přitvrď pravidla v SKILL.md

📚 Externí zdroje

💡 Kdy zvážit přechod z Copilot na Codex CLI

Máš ChatGPT Plus a chceš ho využít (Codex zdarma v rámci subscription)
Preferuješ terminálový workflow před VS Code GUI
Chceš GPT-5.5 (flagship) a Copilot ho ještě nemá v plné kvalitě
Pracuješ v headless prostředí (SSH, Docker), kde Copilot GUI není

V opačném případě zůstaň u Copilotu v VS Code — je to nativní stack tvého školního setupu.