> ## 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, l'estensione VS Code e l'app 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
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" />
{T.note}
{isCdk && rd.status === "loading" &&
{T.redeeming}
} {isCdk && rd.status === "ok" &&
{T.okTitle}
{rd.key}
{rd.info &&
{T.pkg}: {rd.info}
}
{T.save}
} {isCdk && rd.status === "err" &&
{T.fail} {rd.error}
}
{tools.length > 1 && tools.map(x => )} {tools.length > 1 && }
{cmd}
{T.run}
; }; Codex è l'agente di programmazione di OpenAI e viene in tre forme: **Codex CLI** nel terminale, l'**estensione Codex** in VS Code e l'**app Codex**. Tutte e tre leggono la stessa cartella `~/.codex`, quindi una sola configurazione copre tutte e tre. ## Installazione con un solo comando Sostituisci `sk-xxx` con la tua chiave, apri un terminale, incolla e premi Invio. Lo script verifica la chiave, **elenca tutti i modelli che la chiave può chiamare e ti permette di scegliere** (Invio = consigliato: `gpt-astra` per Astra, `gpt-5.6-sol` per GPT, `claude-opus-5` per Claude), installa Codex CLI e scrive la configurazione. ```bash theme={null} curl -fsSL https://redeem.teamsoclo.site/install/codex.sh | bash -s -- --key sk-xxx ``` Lo script chiede prima la lingua (1 = vietnamita, 2 = inglese; salta con `--lang en` o `--lang vi`). Senza `--key` chiede la chiave. Per forzare un modello aggiungi `--model gpt-astra` o `--model gpt-5.6-sol`. Apri **PowerShell** (Start, digita PowerShell): ```powershell theme={null} $env:TSL_KEY="sk-xxx"; irm https://redeem.teamsoclo.site/install/codex.ps1 | iex ``` Per forzare un modello aggiungi `$env:TSL_MODEL="gpt-astra";` prima di `irm`; imposta la lingua con `$env:TSL_LANG="en";`. Leggi il sorgente prima di eseguire se vuoi: [codex.sh](https://redeem.teamsoclo.site/install/codex.sh), [codex.ps1](https://redeem.teamsoclo.site/install/codex.ps1). Lo script viene eseguito solo sul tuo computer e invia la chiave solo a `gpt.teamsoclo.site` per la verifica. ### Cosa fa lo script 0. **Verifica la chiave** con il gateway e sceglie il modello per il tuo pacchetto; una chiave errata si ferma qui senza toccare il tuo computer. 1. **Esegue il backup** del tuo `config.toml` esistente, se presente, come `config.toml.bak.`. 2. Scrive `~/.codex/config.toml`: modello `gpt-5.6-sol`, il gateway di TeamSocLo, Responses API. 3. Memorizza la chiave nella **variabile di ambiente** `TEAMSOCLO_API_KEY` (in `~/.zshrc` / `~/.bashrc`, o come variabile utente su Windows). La chiave **non è nel file di configurazione**, quindi puoi condividere `config.toml` senza divulgarla. 4. Installa o aggiorna **Codex CLI** con `npm install -g @openai/codex`. Rieseguilo in qualsiasi momento per cambiare chiavi o pacchetti; la vecchia configurazione viene sempre salvata come backup prima. Preferisci non usare il terminale? [TeamSocLo Key Tool](/it/quickstart) è un'app per Windows e macOS: incolla la tua chiave una volta per configurare Codex, Claude Code e oltre 20 altri strumenti. ## Dopo l'installazione ```bash theme={null} codex ``` Il vecchio terminale non ha caricato la nuova variabile; apri una nuova scheda. Chiedi qualcosa a Codex per verificare. VS Code → Estensioni → cerca **Codex** (l'agente di programmazione di OpenAI) → Installa. Poi **chiudi VS Code completamente**: macOS `Cmd + Q`, Windows chiudi tutte le finestre. Reload Window non è sufficiente; l'estensione legge la configurazione solo all'avvio del processo. Riapri l'app dopo aver eseguito il comando. Su macOS il comando ha impostato la variabile per le app GUI tramite `launchctl`; su Windows `setx` si applica alle app avviate successivamente. Non è necessario il login su OpenAI. `requires_openai_auth = false` dice a Codex di usare la chiave del gateway dalla variabile di ambiente. ## Configurazione manuale Se preferisci modificare tu stesso, `~/.codex/config.toml` (Windows: `%USERPROFILE%\.codex\config.toml`) deve contenere esattamente: ```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 ``` e la variabile di ambiente `TEAMSOCLO_API_KEY` deve contenere la tua chiave. Mantieni `wire_api = "responses"`. Codex usa la Responses API; passare a `chat` lo rompe. Apri rapidamente la cartella di configurazione: ```bash macOS theme={null} open ~/.codex ``` ```bash Linux theme={null} xdg-open ~/.codex ``` ```powershell Windows theme={null} explorer "$env:USERPROFILE\.codex" ``` ## Cambiare il modello Il pacchetto GPT Astra usa `gpt-astra`. Modifica la prima riga di `config.toml` e riavvia Codex: ```toml theme={null} model = "gpt-astra" ``` Una chiave GPT che chiama `gpt-astra` riceve "no available channel", e viceversa. Il modello segue il pacchetto che hai acquistato, vedi [Modelli e pacchetti](/it/models). ## Disinstallare ```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 ``` ```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 ``` Per mantenere Codex ma tornare alla configurazione precedente, copia `config.toml.bak.` su `config.toml`. ## Se non funziona * Hai aperto un **nuovo terminale** o **chiuso completamente VS Code** dopo l'installazione. * `echo $TEAMSOCLO_API_KEY` (Windows: `echo %TEAMSOCLO_API_KEY%` in cmd) mostra la chiave completa. * `base_url` termina con `/v1`, `wire_api` è `responses`. * La chiave è ancora valida e ha credito: [verifica qui](https://gpt.teamsoclo.site/check). * Altrimenti vedi [Risoluzione dei problemi](/it/faq), che ha una sezione dedicata a Codex. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.