> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamsoclo.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Codex CLI, la extensión de VS Code y la app de Codex — un solo comando

export const InstallBox = ({lang = "vi", tools = ["codex", "claude"]}) => {
  const T = ({
    vi: {
      label: "API key hoặc mã CDK",
      ph: "sk-... hoặc TSL-XXXX-XXXX-XXXX",
      note: "Key chỉ được chèn vào lệnh ngay trên trình duyệt. Mã CDK được đổi qua trang Đổi mã CDK để lấy key, giống khi bạn tự đổi mã.",
      copy: "Copy",
      copied: "Đã copy",
      run: "Mở Terminal (macOS, Linux) hoặc PowerShell (Windows), dán lệnh rồi Enter.",
      redeeming: "Đang đổi mã CDK lấy key...",
      okTitle: "Đã đổi mã CDK. Key của bạn:",
      save: "Lưu key này lại. Đổi lại cùng mã luôn ra đúng key này, lệnh bên dưới đã điền sẵn key.",
      fail: "Không đổi được mã:",
      retry: "Thử lại",
      copyKey: "Copy key",
      pkg: "Gói"
    },
    en: {
      label: "API key or CDK code",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "A key is only inserted into the command in your browser. A CDK code is redeemed through the CDK redeem page to get your key, the same as redeeming it yourself.",
      copy: "Copy",
      copied: "Copied",
      run: "Open Terminal (macOS, Linux) or PowerShell (Windows), paste the command and press Enter.",
      redeeming: "Redeeming the CDK code...",
      okTitle: "CDK code redeemed. Your key:",
      save: "Save this key. Redeeming the same code always returns this key; the command below already uses it.",
      fail: "Could not redeem the code:",
      retry: "Retry",
      copyKey: "Copy key",
      pkg: "Package"
    },
    zh: {
      label: "API 密钥或 CDK 码",
      ph: "sk-... 或 TSL-XXXX-XXXX-XXXX",
      note: "密钥只在浏览器中插入命令。CDK 码会通过兑换页面兑换出密钥，与你自己兑换相同。",
      copy: "复制",
      copied: "已复制",
      run: "打开终端（macOS、Linux）或 PowerShell（Windows），粘贴命令后回车。",
      redeeming: "正在兑换 CDK 码...",
      okTitle: "CDK 码已兑换。你的密钥：",
      save: "请保存此密钥。同一个码再次兑换总是得到这个密钥，下方命令已自动填入。",
      fail: "无法兑换：",
      retry: "重试",
      copyKey: "复制密钥",
      pkg: "套餐"
    },
    "zh-TW": {
      label: "API 金鑰或 CDK 碼",
      ph: "sk-... 或 TSL-XXXX-XXXX-XXXX",
      note: "金鑰只在瀏覽器中插入指令。CDK 碼會透過兌換頁面兌換出金鑰，與你自行兌換相同。",
      copy: "複製",
      copied: "已複製",
      run: "開啟終端機（macOS、Linux）或 PowerShell（Windows），貼上指令後按 Enter。",
      redeeming: "正在兌換 CDK 碼...",
      okTitle: "CDK 碼已兌換。你的金鑰：",
      save: "請保存此金鑰。同一個碼再次兌換總是得到這個金鑰，下方指令已自動填入。",
      fail: "無法兌換：",
      retry: "重試",
      copyKey: "複製金鑰",
      pkg: "方案"
    },
    ja: {
      label: "API キーまたは CDK コード",
      ph: "sk-... または TSL-XXXX-XXXX-XXXX",
      note: "キーはブラウザ内でコマンドに挿入されるだけです。CDK コードは交換ページを通じてキーに交換されます（自分で交換するのと同じです）。",
      copy: "コピー",
      copied: "コピーしました",
      run: "ターミナル（macOS、Linux）または PowerShell（Windows）を開き、コマンドを貼り付けて Enter。",
      redeeming: "CDK コードを交換しています...",
      okTitle: "CDK コードを交換しました。あなたのキー：",
      save: "このキーを保存してください。同じコードを再交換すると常にこのキーになります。下のコマンドには記入済みです。",
      fail: "交換できません：",
      retry: "再試行",
      copyKey: "キーをコピー",
      pkg: "パッケージ"
    },
    fr: {
      label: "Clé API ou code CDK",
      ph: "sk-... ou TSL-XXXX-XXXX-XXXX",
      note: "Une clé est seulement insérée dans la commande, dans votre navigateur. Un code CDK est échangé via la page d’échange pour obtenir votre clé, comme si vous l’échangiez vous-même.",
      copy: "Copier",
      copied: "Copié",
      run: "Ouvrez le Terminal (macOS, Linux) ou PowerShell (Windows), collez la commande et appuyez sur Entrée.",
      redeeming: "Échange du code CDK...",
      okTitle: "Code CDK échangé. Votre clé :",
      save: "Conservez cette clé. Le même code renvoie toujours cette clé ; la commande ci-dessous l’utilise déjà.",
      fail: "Échange impossible :",
      retry: "Réessayer",
      copyKey: "Copier la clé",
      pkg: "Forfait"
    },
    ru: {
      label: "API-ключ или код CDK",
      ph: "sk-... или TSL-XXXX-XXXX-XXXX",
      note: "Ключ только подставляется в команду в браузере. Код CDK активируется через страницу активации, чтобы получить ключ, — так же, как вручную.",
      copy: "Копировать",
      copied: "Скопировано",
      run: "Откройте Терминал (macOS, Linux) или PowerShell (Windows), вставьте команду и нажмите Enter.",
      redeeming: "Активация кода CDK...",
      okTitle: "Код CDK активирован. Ваш ключ:",
      save: "Сохраните этот ключ. Повторная активация того же кода всегда возвращает этот ключ; команда ниже уже его использует.",
      fail: "Не удалось активировать код:",
      retry: "Повторить",
      copyKey: "Копировать ключ",
      pkg: "Пакет"
    },
    ar: {
      label: "مفتاح API أو كود CDK",
      ph: "sk-... أو TSL-XXXX-XXXX-XXXX",
      note: "المفتاح يُدرج في الأمر في متصفحك فقط. كود CDK يُستبدل عبر صفحة الاستبدال للحصول على مفتاحك، كما لو استبدلته بنفسك.",
      copy: "نسخ",
      copied: "تم النسخ",
      run: "افتح الطرفية (macOS، Linux) أو PowerShell (Windows)، الصق الأمر واضغط Enter.",
      redeeming: "جارٍ استبدال كود CDK...",
      okTitle: "تم استبدال كود CDK. مفتاحك:",
      save: "احفظ هذا المفتاح. استبدال الكود ذاته دائماً يُعيد هذا المفتاح؛ الأمر أدناه يستخدمه بالفعل.",
      fail: "تعذَّر استبدال الكود:",
      retry: "إعادة المحاولة",
      copyKey: "نسخ المفتاح",
      pkg: "الباقة"
    },
    cs: {
      label: "API klíč nebo CDK kód",
      ph: "sk-... nebo TSL-XXXX-XXXX-XXXX",
      note: "Klíč se jen vloží do příkazu ve vašem prohlížeči. CDK kód se uplatní přes stránku pro uplatnění CDK a získáte klíč, stejně jako kdybyste ho uplatnili sami.",
      copy: "Kopírovat",
      copied: "Zkopírováno",
      run: "Otevřete Terminál (macOS, Linux) nebo PowerShell (Windows), vložte příkaz a stiskněte Enter.",
      redeeming: "Uplatňuji CDK kód...",
      okTitle: "CDK kód uplatněn. Váš klíč:",
      save: "Tento klíč si uložte. Opětovné uplatnění stejného kódu vždy vrátí tento klíč; příkaz níže ho už používá.",
      fail: "Kód se nepodařilo uplatnit:",
      retry: "Zkusit znovu",
      copyKey: "Kopírovat klíč",
      pkg: "Balíček"
    },
    da: {
      label: "API-nøgle eller CDK-kode",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "En nøgle indsættes kun i kommandoen i din browser. En CDK-kode indløses via CDK-indløsningssiden for at få din nøgle, på samme måde som hvis du indløste den selv.",
      copy: "Kopier",
      copied: "Kopieret",
      run: "Åbn Terminal (macOS, Linux) eller PowerShell (Windows), indsæt kommandoen og tryk Enter.",
      redeeming: "Indløser CDK-koden...",
      okTitle: "CDK-kode indløst. Din nøgle:",
      save: "Gem denne nøgle. Indløsning af den samme kode returnerer altid denne nøgle; kommandoen nedenfor bruger den allerede.",
      fail: "Kunne ikke indløse koden:",
      retry: "Prøv igen",
      copyKey: "Kopier nøgle",
      pkg: "Pakke"
    },
    de: {
      label: "API-Schlüssel oder CDK-Code",
      ph: "sk-... oder TSL-XXXX-XXXX-XXXX",
      note: "Ein Schlüssel wird nur im Browser in den Befehl eingefügt. Ein CDK-Code wird über die CDK-Einlöseseite in deinen Schlüssel umgewandelt, genauso wie wenn du ihn selbst einlöst.",
      copy: "Kopieren",
      copied: "Kopiert",
      run: "Öffne Terminal (macOS, Linux) oder PowerShell (Windows), füge den Befehl ein und drücke Enter.",
      redeeming: "CDK-Code wird eingelöst...",
      okTitle: "CDK-Code eingelöst. Dein Schlüssel:",
      save: "Speichere diesen Schlüssel. Das Einlösen desselben Codes gibt immer diesen Schlüssel zurück; der Befehl unten verwendet ihn bereits.",
      fail: "Code konnte nicht eingelöst werden:",
      retry: "Erneut versuchen",
      copyKey: "Schlüssel kopieren",
      pkg: "Paket"
    },
    es: {
      label: "Clave API o código CDK",
      ph: "sk-... o TSL-XXXX-XXXX-XXXX",
      note: "Una clave solo se inserta en el comando en tu navegador. Un código CDK se canjea a través de la página de canje para obtener tu clave, igual que si lo hicieras tú mismo.",
      copy: "Copiar",
      copied: "Copiado",
      run: "Abre Terminal (macOS, Linux) o PowerShell (Windows), pega el comando y presiona Enter.",
      redeeming: "Canjeando el código CDK...",
      okTitle: "Código CDK canjeado. Tu clave:",
      save: "Guarda esta clave. Canjear el mismo código siempre devuelve esta clave; el comando de abajo ya la usa.",
      fail: "No se pudo canjear el código:",
      retry: "Reintentar",
      copyKey: "Copiar clave",
      pkg: "Paquete"
    },
    fi: {
      label: "API-avain tai CDK-koodi",
      ph: "sk-... tai TSL-XXXX-XXXX-XXXX",
      note: "Avain lisätään komentoon vain selaimessasi. CDK-koodi lunastetaan CDK-lunastussivun kautta avaimeksi, aivan kuin lunastaisit sen itse.",
      copy: "Kopioi",
      copied: "Kopioitu",
      run: "Avaa Pääte (macOS, Linux) tai PowerShell (Windows), liitä komento ja paina Enter.",
      redeeming: "Lunastetaan CDK-koodia...",
      okTitle: "CDK-koodi lunastettu. Avaimesi:",
      save: "Tallenna tämä avain. Saman koodin lunastaminen uudelleen palauttaa aina tämän avaimen; alla oleva komento käyttää sitä jo.",
      fail: "Koodia ei voitu lunastaa:",
      retry: "Yritä uudelleen",
      copyKey: "Kopioi avain",
      pkg: "Paketti"
    },
    he: {
      label: "מפתח API או קוד CDK",
      ph: "sk-... או TSL-XXXX-XXXX-XXXX",
      note: "מפתח מוכנס רק לפקודה בדפדפן שלכם. קוד CDK ממומש דרך דף המימוש לקבלת המפתח שלכם, כמו מימוש ידני.",
      copy: "העתקה",
      copied: "הועתק",
      run: "פתחו Terminal (macOS, Linux) או PowerShell (Windows), הדביקו את הפקודה ולחצו Enter.",
      redeeming: "ממש את קוד CDK...",
      okTitle: "קוד CDK מומש. המפתח שלכם:",
      save: "שמרו את המפתח הזה. מימוש אותו קוד שוב תמיד מחזיר את אותו מפתח; הפקודה למטה כבר משתמשת בו.",
      fail: "לא ניתן לממש את הקוד:",
      retry: "נסו שוב",
      copyKey: "העתקת מפתח",
      pkg: "חבילה"
    },
    hi: {
      label: "API key या CDK code",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "Key केवल browser में command में insert होती है. CDK code redeem page के ज़रिए key में convert होता है, जैसे आप खुद redeem करते हैं.",
      copy: "Copy",
      copied: "Copied",
      run: "Terminal (macOS, Linux) या PowerShell (Windows) खोलें, command paste करें और Enter दबाएं.",
      redeeming: "CDK code redeem हो रहा है...",
      okTitle: "CDK code redeem हो गया. आपकी key:",
      save: "यह key save करें. उसी code को दोबारा redeem करने पर हमेशा यही key मिलती है; नीचे की command में पहले से fill है.",
      fail: "Code redeem नहीं हो सका:",
      retry: "फिर कोशिश करें",
      copyKey: "Key copy करें",
      pkg: "Package"
    },
    id: {
      label: "API key atau kode CDK",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "Key hanya disisipkan ke perintah di browser Anda. Kode CDK ditukarkan melalui halaman penukaran CDK untuk mendapatkan key, sama seperti menukarnya sendiri.",
      copy: "Salin",
      copied: "Disalin",
      run: "Buka Terminal (macOS, Linux) atau PowerShell (Windows), tempel perintah dan tekan Enter.",
      redeeming: "Menukarkan kode CDK...",
      okTitle: "Kode CDK berhasil ditukar. Key Anda:",
      save: "Simpan key ini. Menukarkan kode yang sama selalu menghasilkan key ini; perintah di bawah sudah menggunakannya.",
      fail: "Tidak bisa menukarkan kode:",
      retry: "Coba lagi",
      copyKey: "Salin key",
      pkg: "Paket"
    },
    it: {
      label: "Chiave API o codice CDK",
      ph: "sk-... o TSL-XXXX-XXXX-XXXX",
      note: "Una chiave viene solo inserita nel comando nel tuo browser. Un codice CDK viene riscattato tramite la pagina di riscatto per ottenere la tua chiave, come se lo facessi tu stesso.",
      copy: "Copia",
      copied: "Copiato",
      run: "Apri il Terminale (macOS, Linux) o PowerShell (Windows), incolla il comando e premi Invio.",
      redeeming: "Riscatto del codice CDK in corso...",
      okTitle: "Codice CDK riscattato. La tua chiave:",
      save: "Salva questa chiave. Riscattare lo stesso codice restituisce sempre questa chiave; il comando qui sotto la usa già.",
      fail: "Impossibile riscattare il codice:",
      retry: "Riprova",
      copyKey: "Copia chiave",
      pkg: "Pacchetto"
    },
    ko: {
      label: "API 키 또는 CDK 코드",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "키는 브라우저에서 명령에만 삽입됩니다. CDK 코드는 CDK 교환 페이지를 통해 키로 교환됩니다. 직접 교환하는 것과 같습니다.",
      copy: "복사",
      copied: "복사됨",
      run: "Terminal (macOS, Linux) 또는 PowerShell (Windows)을 열고 명령을 붙여넣고 Enter를 누르세요.",
      redeeming: "CDK 코드 교환 중...",
      okTitle: "CDK 코드 교환 완료. 내 키:",
      save: "이 키를 저장하세요. 같은 코드를 다시 교환하면 항상 이 키가 반환됩니다; 아래 명령에 이미 입력되어 있습니다.",
      fail: "코드를 교환할 수 없습니다:",
      retry: "다시 시도",
      copyKey: "키 복사",
      pkg: "패키지"
    },
    nl: {
      label: "API-sleutel of CDK-code",
      ph: "sk-... of TSL-XXXX-XXXX-XXXX",
      note: "Een sleutel wordt alleen in de browser in het commando ingevoegd. Een CDK-code wordt via de inwisselpagina omgezet naar je sleutel, net zoals wanneer je het zelf inwisselt.",
      copy: "Kopiëren",
      copied: "Gekopieerd",
      run: "Open Terminal (macOS, Linux) of PowerShell (Windows), plak het commando en druk op Enter.",
      redeeming: "CDK-code wordt ingewisseld...",
      okTitle: "CDK-code ingewisseld. Jouw sleutel:",
      save: "Sla deze sleutel op. Dezelfde code inwisselen geeft altijd dezelfde sleutel; het commando hieronder gebruikt hem al.",
      fail: "Kon de code niet inwisselen:",
      retry: "Opnieuw proberen",
      copyKey: "Sleutel kopiëren",
      pkg: "Pakket"
    },
    no: {
      label: "API-nøkkel eller CDK-kode",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "En nøkkel settes bare inn i kommandoen i nettleseren din. En CDK-kode løses inn via CDK-innløsningssiden for å få nøkkelen din, på samme måte som om du løste den inn selv.",
      copy: "Kopier",
      copied: "Kopiert",
      run: "Åpne Terminal (macOS, Linux) eller PowerShell (Windows), lim inn kommandoen og trykk Enter.",
      redeeming: "Løser inn CDK-koden...",
      okTitle: "CDK-kode innløst. Nøkkelen din:",
      save: "Lagre denne nøkkelen. Innløsning av den samme koden returnerer alltid denne nøkkelen; kommandoen nedenfor bruker den allerede.",
      fail: "Kunne ikke løse inn koden:",
      retry: "Prøv igjen",
      copyKey: "Kopier nøkkel",
      pkg: "Pakke"
    },
    pl: {
      label: "Klucz API lub kod CDK",
      ph: "sk-... lub TSL-XXXX-XXXX-XXXX",
      note: "Klucz jest wstawiany do polecenia tylko w przeglądarce. Kod CDK jest wymieniany przez stronę wymiany, aby uzyskać klucz, tak samo jak przy samodzielnej wymianie.",
      copy: "Kopiuj",
      copied: "Skopiowano",
      run: "Otwórz Terminal (macOS, Linux) lub PowerShell (Windows), wklej polecenie i naciśnij Enter.",
      redeeming: "Trwa wymiana kodu CDK...",
      okTitle: "Kod CDK wymieniony. Twój klucz:",
      save: "Zachowaj ten klucz. Wymiana tego samego kodu zawsze zwraca ten sam klucz; poniższe polecenie już go używa.",
      fail: "Nie udało się wymienić kodu:",
      retry: "Spróbuj ponownie",
      copyKey: "Kopiuj klucz",
      pkg: "Pakiet"
    },
    pt: {
      label: "Chave API ou código CDK",
      ph: "sk-... ou TSL-XXXX-XXXX-XXXX",
      note: "Uma chave só é inserida no comando no seu navegador. Um código CDK é resgatado pela página de resgate para obter sua chave, igual a fazer você mesmo.",
      copy: "Copiar",
      copied: "Copiado",
      run: "Abra o Terminal (macOS, Linux) ou PowerShell (Windows), cole o comando e pressione Enter.",
      redeeming: "Resgatando o código CDK...",
      okTitle: "Código CDK resgatado. Sua chave:",
      save: "Salve esta chave. Resgatar o mesmo código sempre retorna esta chave; o comando abaixo já a usa.",
      fail: "Não foi possível resgatar o código:",
      retry: "Tentar novamente",
      copyKey: "Copiar chave",
      pkg: "Pacote"
    },
    sv: {
      label: "API-nyckel eller CDK-kod",
      ph: "sk-... or TSL-XXXX-XXXX-XXXX",
      note: "En nyckel infogas bara i kommandot i din webbläsare. En CDK-kod löses in via CDK-inlösningssidan för att få din nyckel, på samma sätt som om du löser in den själv.",
      copy: "Kopiera",
      copied: "Kopierat",
      run: "Öppna Terminal (macOS, Linux) eller PowerShell (Windows), klistra in kommandot och tryck Enter.",
      redeeming: "Löser in CDK-koden...",
      okTitle: "CDK-kod inlöst. Din nyckel:",
      save: "Spara den här nyckeln. Inlösning av samma kod returnerar alltid den här nyckeln; kommandot nedan använder den redan.",
      fail: "Det gick inte att lösa in koden:",
      retry: "Försök igen",
      copyKey: "Kopiera nyckel",
      pkg: "Paket"
    },
    tr: {
      label: "API anahtarı veya CDK kodu",
      ph: "sk-... veya TSL-XXXX-XXXX-XXXX",
      note: "Anahtar yalnızca tarayıcınızda komuta eklenir. CDK kodu, kendiniz kullanmışsınız gibi CDK kullanım sayfası üzerinden anahtara dönüştürülür.",
      copy: "Kopyala",
      copied: "Kopyalandı",
      run: "Terminal'i (macOS, Linux) veya PowerShell'i (Windows) açın, komutu yapıştırıp Enter'a basın.",
      redeeming: "CDK kodu kullanılıyor...",
      okTitle: "CDK kodu kullanıldı. Anahtarınız:",
      save: "Bu anahtarı saklayın. Aynı kodu yeniden kullanmak her zaman bu anahtarı döndürür; aşağıdaki komut onu zaten kullanıyor.",
      fail: "Kod kullanılamadı:",
      retry: "Tekrar dene",
      copyKey: "Anahtarı kopyala",
      pkg: "Paket"
    },
    uk: {
      label: "API-ключ або код CDK",
      ph: "sk-... або TSL-XXXX-XXXX-XXXX",
      note: "Ключ лише підставляється в команду у вашому браузері. CDK-код активується через сторінку активації для отримання ключа — так само, як якщо б ви активували його самостійно.",
      copy: "Копіювати",
      copied: "Скопійовано",
      run: "Відкрийте Термінал (macOS, Linux) або PowerShell (Windows), вставте команду і натисніть Enter.",
      redeeming: "Активація CDK-коду...",
      okTitle: "CDK-код активовано. Ваш ключ:",
      save: "Збережіть цей ключ. Повторна активація того самого коду завжди повертає цей ключ; команда нижче вже використовує його.",
      fail: "Не вдалося активувати код:",
      retry: "Спробувати знову",
      copyKey: "Копіювати ключ",
      pkg: "Пакет"
    }
  })[lang] || ({});
  const NAMES = {
    codex: "Codex",
    claude: "Claude Code"
  };
  const [val, setVal] = useState("");
  const [tool, setTool] = useState(tools[0]);
  const [os, setOs] = useState("unix");
  const [copied, setCopied] = useState(false);
  const [rd, setRd] = useState({
    code: "",
    status: "",
    key: "",
    info: "",
    error: ""
  });
  const PRODUCTS = {
    gpt: "GPT",
    astra: "GPT Astra",
    claude: "Claude",
    grok: "Grok"
  };
  const raw = (val || "").trim().replace(/[^A-Za-z0-9_-]/g, "");
  const isCdk = (/^TSL(-[A-Za-z0-9]{4}){3,}$/i).test(raw);
  const redeem = code => {
    setRd({
      code: code,
      status: "loading",
      key: "",
      info: "",
      error: ""
    });
    fetch("https://redeem.teamsoclo.site/api/redeem", {
      method: "POST",
      headers: {
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        code: code
      })
    }).then(r => r.json()).then(d => {
      if (d && d.ok && d.key) setRd({
        code: code,
        status: "ok",
        key: d.key,
        info: (PRODUCTS[d.product] || d.product || "") + (d.tier ? " · " + ((/^\d+(\.\d+)?[MB]$/i).test(d.tier) ? "$" + (parseFloat(d.tier) * ((/B$/i).test(d.tier) ? 1000 : 1)).toLocaleString("en-US") : d.tier) : ""),
        error: ""
      }); else setRd({
        code: code,
        status: "err",
        key: "",
        info: "",
        error: d && d.error || "error"
      });
    }).catch(e => setRd({
      code: code,
      status: "err",
      key: "",
      info: "",
      error: String(e && e.message || e)
    }));
  };
  useEffect(() => {
    if (!isCdk) {
      if (rd.code) setRd({
        code: "",
        status: "",
        key: "",
        info: "",
        error: ""
      });
      return;
    }
    const code = raw.toUpperCase();
    if (rd.code === code) return;
    const t = setTimeout(() => redeem(code), 400);
    return () => clearTimeout(t);
  }, [raw]);
  const copyText = text => {
    try {
      navigator.clipboard.writeText(text);
    } catch (e) {}
  };
  useEffect(() => {
    try {
      if ((/Win/i).test(navigator.platform || navigator.userAgent)) setOs("win");
    } catch (e) {}
  }, []);
  const v = (isCdk && rd.status === "ok" ? rd.key : raw) || "sk-xxx";
  const base = "https://redeem.teamsoclo.site/install/" + tool;
  const cmd = os === "win" ? "$env:TSL_KEY=\"" + v + "\"; irm " + base + ".ps1 | iex" : "curl -fsSL " + base + ".sh | bash -s -- --key " + v;
  const copy = () => {
    try {
      navigator.clipboard.writeText(cmd);
      setCopied(true);
      setTimeout(() => setCopied(false), 1500);
    } catch (e) {}
  };
  const tab = on => "rounded-lg px-3 py-1.5 text-sm font-medium transition " + (on ? "bg-primary text-white dark:bg-primary-light dark:text-zinc-950" : "text-zinc-600 hover:bg-zinc-100 dark:text-zinc-300 dark:hover:bg-zinc-800");
  return <div className="not-prose my-6 rounded-2xl border border-zinc-200 bg-white p-5 dark:border-zinc-800 dark:bg-zinc-900">
      <label className="block text-sm font-semibold text-zinc-900 dark:text-zinc-100">{T.label}</label>
      <input type="password" autoComplete="off" spellCheck={false} value={val} placeholder={T.ph} onChange={e => setVal(e.target.value)} className="mt-2 w-full rounded-xl border border-zinc-300 bg-white px-3 py-2.5 font-mono text-sm text-zinc-900 outline-none focus:border-primary dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100 dark:focus:border-primary-light" />
      <div className="mt-2 text-xs text-zinc-500 dark:text-zinc-400">{T.note}</div>
      {isCdk && rd.status === "loading" && <div className="mt-3 rounded-xl border border-zinc-200 px-3 py-2 text-sm text-zinc-600 dark:border-zinc-700 dark:text-zinc-300">{T.redeeming}</div>}
      {isCdk && rd.status === "ok" && <div className="mt-3 rounded-xl border border-green-300 bg-green-50 p-3 dark:border-green-800 dark:bg-green-950/40">
          <div className="text-sm font-semibold text-green-800 dark:text-green-300">{T.okTitle}</div>
          <div className="mt-2 flex items-center gap-2">
            <code className="flex-1 break-all rounded-lg bg-white px-2 py-1 font-mono text-[13px] text-zinc-900 dark:bg-zinc-950 dark:text-zinc-100">{rd.key}</code>
            <button type="button" onClick={() => copyText(rd.key)} className="shrink-0 rounded-lg border border-green-400 px-3 py-1 text-xs font-semibold text-green-800 hover:bg-green-100 dark:border-green-700 dark:text-green-300 dark:hover:bg-green-900/40">{T.copyKey}</button>
          </div>
          {rd.info && <div className="mt-2 text-xs text-green-800 dark:text-green-300">{T.pkg}: {rd.info}</div>}
          <div className="mt-1 text-xs text-green-800/80 dark:text-green-300/80">{T.save}</div>
        </div>}
      {isCdk && rd.status === "err" && <div className="mt-3 flex items-center gap-3 rounded-xl border border-red-300 bg-red-50 px-3 py-2 text-sm text-red-800 dark:border-red-800 dark:bg-red-950/40 dark:text-red-300">
          <span className="flex-1">{T.fail} {rd.error}</span>
          <button type="button" onClick={() => redeem(raw.toUpperCase())} className="shrink-0 rounded-lg border border-red-400 px-3 py-1 text-xs font-semibold">{T.retry}</button>
        </div>}
      <div className="mt-4 flex flex-wrap items-center gap-2">
        {tools.length > 1 && tools.map(x => <button key={x} type="button" className={tab(tool === x)} onClick={() => setTool(x)}>{NAMES[x] || x}</button>)}
        {tools.length > 1 && <span className="mx-1 h-5 w-px bg-zinc-200 dark:bg-zinc-700"></span>}
        <button type="button" className={tab(os === "unix")} onClick={() => setOs("unix")}>macOS / Linux</button>
        <button type="button" className={tab(os === "win")} onClick={() => setOs("win")}>Windows</button>
      </div>
      <div className="mt-3 flex items-start gap-2 rounded-xl bg-zinc-950 p-3">
        <code className="flex-1 whitespace-pre-wrap break-all bg-transparent p-0 font-mono text-[13px] leading-relaxed text-zinc-100" style={{
    background: "transparent",
    padding: 0,
    border: 0
  }}>{cmd}</code>
        <button type="button" onClick={copy} className="shrink-0 rounded-lg border border-zinc-700 px-3 py-1 text-xs font-semibold text-zinc-100 hover:bg-zinc-800">{copied ? T.copied : T.copy}</button>
      </div>
      <div className="mt-2 text-xs text-zinc-500 dark:text-zinc-400">{T.run}</div>
    </div>;
};

Codex es el agente de programación de OpenAI y viene en tres formas: **Codex CLI** en el terminal, la **extensión de Codex** en VS Code y la **app de Codex**. Los tres leen la misma carpeta `~/.codex`, por lo que una sola configuración cubre los tres.

## Instalación con un solo comando

Reemplaza `sk-xxx` con tu clave, abre una terminal, pega y presiona Enter. El script verifica la clave, **lista todos los modelos que la clave puede llamar y te permite elegir** (Enter = recomendado: `gpt-astra` para Astra, `gpt-5.6-sol` para GPT, `claude-opus-5` para Claude), instala Codex CLI y escribe la configuración.

<InstallBox lang="es" tools={["codex"]} />

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://redeem.teamsoclo.site/install/codex.sh | bash -s -- --key sk-xxx
    ```

    El script primero pregunta por un idioma (1 = vietnamita, 2 = inglés; omite con `--lang en` o `--lang vi`). Sin `--key` solicita la clave. Para forzar un modelo añade `--model gpt-astra` o `--model gpt-5.6-sol`.
  </Tab>

  <Tab title="Windows">
    Abre **PowerShell** (Inicio, escribe PowerShell):

    ```powershell theme={null}
    $env:TSL_KEY="sk-xxx"; irm https://redeem.teamsoclo.site/install/codex.ps1 | iex
    ```

    Para forzar un modelo añade `$env:TSL_MODEL="gpt-astra";` antes de `irm`; establece el idioma con `$env:TSL_LANG="en";`.
  </Tab>
</Tabs>

Lee el código fuente antes de ejecutar si lo deseas: [codex.sh](https://redeem.teamsoclo.site/install/codex.sh), [codex.ps1](https://redeem.teamsoclo.site/install/codex.ps1). El script solo se ejecuta en tu máquina y envía la clave únicamente a `gpt.teamsoclo.site` para verificación.

### Qué hace el script

0. **Verifica la clave** con el gateway y elige el modelo para tu paquete; una clave incorrecta se detiene aquí sin tocar tu máquina.
1. **Respalda** tu `config.toml` existente, si lo hay, como `config.toml.bak.<timestamp>`.
2. Escribe `~/.codex/config.toml`: modelo `gpt-5.6-sol`, el gateway de TeamSocLo, Responses API.
3. Almacena la clave en la **variable de entorno** `TEAMSOCLO_API_KEY` (en `~/.zshrc` / `~/.bashrc`, o como variable de usuario en Windows). La clave **no está en el archivo de configuración**, por lo que puedes compartir `config.toml` sin filtrarla.
4. Instala o actualiza **Codex CLI** con `npm install -g @openai/codex`.

Ejecútalo de nuevo en cualquier momento para cambiar claves o paquetes; la configuración anterior siempre se respalda primero.

<Tip>
  ¿Prefieres no usar el terminal? [TeamSocLo Key Tool](/es/quickstart) es una app para Windows y macOS: pega tu clave una vez para configurar Codex, Claude Code y más de 20 herramientas.
</Tip>

## Después de instalar

<Steps>
  <Step title="Abre una nueva terminal, ejecuta codex">
    ```bash theme={null}
    codex
    ```

    La terminal antigua no ha cargado la nueva variable; abre una nueva pestaña. Pregunta cualquier cosa a Codex para verificar.
  </Step>

  <Step title="VS Code: instala la extensión, cierra completamente, vuelve a abrir">
    VS Code → Extensiones → busca **Codex** (el agente de programación de OpenAI) → Instalar. Luego **cierra VS Code completamente**: macOS `Cmd + Q`, Windows cierra todas las ventanas. Reload Window no es suficiente; la extensión lee la configuración solo al inicio del proceso.
  </Step>

  <Step title="App de Codex">
    Vuelve a abrir la app después de ejecutar el comando. En macOS el comando configuró la variable para apps GUI mediante `launchctl`; en Windows `setx` aplica a las apps que se inicien después.
  </Step>
</Steps>

No se necesita inicio de sesión en OpenAI. `requires_openai_auth = false` le dice a Codex que use la clave del gateway desde la variable de entorno.

## Configuración manual

Si prefieres editarlo tú mismo, `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`) debe contener exactamente:

```toml theme={null}
model = "gpt-5.6-sol"
model_provider = "teamsoclo"

[model_providers.teamsoclo]
name = "TeamSocLo"
base_url = "https://gpt.teamsoclo.site/v1"
env_key = "TEAMSOCLO_API_KEY"
wire_api = "responses"
requires_openai_auth = false
```

y la variable de entorno `TEAMSOCLO_API_KEY` debe contener tu clave.

<Warning>
  Mantén `wire_api = "responses"`. Codex usa la Responses API; cambiar a `chat` lo rompe.
</Warning>

Abre la carpeta de configuración rápidamente:

<CodeGroup>
  ```bash macOS theme={null}
  open ~/.codex
  ```

  ```bash Linux theme={null}
  xdg-open ~/.codex
  ```

  ```powershell Windows theme={null}
  explorer "$env:USERPROFILE\.codex"
  ```
</CodeGroup>

## Cambiar el modelo

El paquete GPT Astra usa `gpt-astra`. Edita la primera línea de `config.toml` y reinicia Codex:

```toml theme={null}
model = "gpt-astra"
```

Una clave GPT que llama a `gpt-astra` obtiene "no available channel", y viceversa. El modelo sigue el paquete que compraste, ver [Modelos y paquetes](/es/models).

## Desinstalar

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    perl -ni -e 'print unless /TEAMSOCLO_API_KEY/' ~/.zshrc ~/.bashrc 2>/dev/null; launchctl unsetenv TEAMSOCLO_API_KEY 2>/dev/null; rm -rf ~/.codex; npm uninstall -g @openai/codex
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    reg delete "HKCU\Environment" /v TEAMSOCLO_API_KEY /f; Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"; npm.cmd uninstall -g @openai/codex
    ```
  </Tab>
</Tabs>

Para mantener Codex pero volver a tu configuración anterior, copia `config.toml.bak.<timestamp>` sobre `config.toml`.

## Si no funciona

* Abriste una **nueva terminal** o **cerraste VS Code completamente** después de instalar.
* `echo $TEAMSOCLO_API_KEY` (Windows: `echo %TEAMSOCLO_API_KEY%` en cmd) muestra la clave completa.
* `base_url` termina con `/v1`, `wire_api` es `responses`.
* La clave sigue siendo válida y tiene cupo: [verificar aquí](https://gpt.teamsoclo.site/check).
* De lo contrario, ver [Solución de problemas](/es/faq), que tiene una sección de Codex.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.