Bagaimana untuk menjadikan aplikasi Codex berfungsi pada Windows/Linux?

OpenAI Codex ialah “pusat perintah” baharu untuk pembangunan perisian dipacu agen: apl desktop + CLI + sambungan IDE yang membolehkan pembangun menjalankan aliran kerja pengaturcaraan berbilang agen, mencipta worktree terasing untuk eksperimen, dan mengautomasikan tugasan kejuruteraan yang besar serta berjalan lama. Apl OpenAI Codex ialah antara muka desktop untuk menjalankan dan mengorkestrasikan agen pengaturcaraan AI secara setempat dan di awan. Ia dilancarkan pada macOS dan — setakat awal Mac 2026 — diperluas ke Windows, dengan sokongan Linux dirancang.

Apakah apl Codex — dan mengapa ia penting

Codex ialah keluarga agen pengaturcaraan AI dan alat berkaitan yang membantu pembangun menulis, melakukan refaktor, menguji, dan mengorkestrasikan kod melalui aliran kerja berasaskan agen, tugasan berjalan lama, dan koordinasi berbilang agen. Apl Codex ialah produk desktop yang menghimpunkan agen-agen tersebut dalam satu UI untuk pengurusan projek, thread agen selari, dan thread berterusan/disokong awan. Apl ini melengkapi Codex CLI dan integrasi IDE (cth., pemalam) dan direka untuk menjadi “pusat kawalan misi” bagi pengaturcaraan berasaskan agen.

Mengapa ini penting sekarang:

• Pengganda produktiviti: Aliran kerja berasaskan agen membolehkan anda menjalankan banyak tugasan secara selari — cth., menjana kod rangka, menjalankan suit ujian, dan melakukan triage laporan pepijat — menjimatkan masa pembangun yang nyata.
• Automasi berjalan lama: Codex boleh mengekalkan dan memajukan tugasan merentasi jam atau hari (penting untuk siasatan CI, naik taraf kebergantungan, atau refaktor besar).
• Integrasi platform: OpenAI telah mengembangkan Codex ke pengalaman desktop dan IDE, dan apl kini menyokong Windows secara natif (dan macOS sudah), yang memperluas capaian kepada lebih ramai pembangun. Metrik awal melaporkan versi macOS mencecah lebih satu juta muat turun dalam minggu pertama — satu isyarat permintaan yang kukuh.
• Momentum persaingan: Pelancaran apl adalah sebahagian daripada perlumbaan yang lebih luas dengan vendor lain yang menambah ciri pengaturcaraan berasaskan agen (konteks daripada liputan industri).

OpenAI sedang beriterasi dengan pantas — catatan log perubahan yang kerap pada akhir Feb 2026 menunjukkan pembaikan dan peningkatan prestasi harian, jadi jangkakan apl akan terus berkembang sementara anda mengintegrasikannya ke dalam aliran kerja anda.

Ketersediaan semasa & aliran kerja yang disokong

• CLI Codex disokong pada macOS, Windows dan Linux serta boleh dipasang melalui pengurus pakej (npm/Homebrew) atau dengan memuat turun binari platform. CLI berjalan secara setempat, boleh memeriksa dan mengedit repositori, dan akan meminta anda log masuk dengan ChatGPT atau kunci API.
• Apl desktop Codex (GUI) dihantar terlebih dahulu pada macOS; ketersediaan Windows ditambah dalam kemas kini susulan. Pada masa penulisan, borang pendaftaran wujud untuk ketersediaan desktop Linux (OpenAI meminta maklumat distro). Jika anda mahukan GUI Linux hari ini, pilihan anda ialah: gunakan CLI + sambungan IDE, jalankan Codex berasaskan awan/web di chatgpt.com/codex, atau (untuk pengguna lasak) jalankan projek komuniti yang memport apl Electron macOS ke Linux (tidak rasmi).

3 Cara untuk menjalankan Codex pada mesin anda

Terdapat tiga mod praktikal untuk pengguna Windows dan Linux:

1. Apl desktop natif (Windows): Binaan Windows rasmi (sandboxing natif, integrasi PowerShell). Disyorkan untuk kebanyakan desktop Windows.
2. WSL (Windows Subsystem for Linux) + apl Codex: Berguna jika anda mengutamakan persekitaran Linux atau rantaian alat pembangunan anda natif Linux. Apl Windows boleh dikonfigurasikan untuk menggunakan WSL bagi runtime agen.
3. Linux (CLI / mod pembangun): Walaupun binaan desktop Linux pada mulanya “akan datang”, anda boleh menjalankan Codex CLI, pemalam IDE, atau usaha komuniti untuk menjalankan pengalaman desktop di Linux (atau ikuti pendaftaran notifikasi OpenAI). Repositori CLI codex (OpenAI) tersedia untuk aliran kerja agen setempat.

Keperluan sistem & pertimbangan keselamatan (ringkasan)

• Windows: Windows 10/11 (64-bit). PowerShell natif dan sandbox Windows tersedia dalam apl Windows untuk mengehadkan pelaksanaan kod yang tidak dipercayai. Jika anda menggunakan WSL, WSL2 disyorkan.
• Linux: Berbeza mengikut distro. Apl desktop belum tersedia umum; buat masa ini gunakan CLI atau pemalam IDE. Pendaftaran tersedia untuk dimaklumkan tentang binaan Linux.
• RAM/CPU: Beban kerja agen boleh berat jika anda memintanya menjalankan ujian atau binaan — rancang untuk berbilang teras dan 8–16GB RAM untuk penggunaan santai, lebih banyak untuk keserentakan tinggi.
• Amalan terbaik keselamatan: Gunakan ciri sandbox apl, jalankan agen dengan hak minimum, asingkan direktori projek, dan gunakan kunci API jangka pendek atau daftar masuk pengguna dan bukannya membenamkan kunci dalam repo.

Cara membuat apl Codex berfungsi pada Windows — langkah demi langkah

Dua senario biasa pada Windows:1) Gunakan apl desktop Codex (Microsoft Store / pemasang natif).
2) Gunakan Codex CLI dalam PowerShell atau WSL, pilihan bersama sambungan VS Code.

Di bawah ialah urutan praktikal bergaya diuji: pasang, konfigur, sambung ke WSL (pilihan), dan nyahpintas masalah.

1) Muat turun & pasang apl Codex Windows rasmi

1. Lawati halaman apl Codex dan muat turun pemasang Windows (MSI/EXE) daripada halaman dokumentasi/muat turun rasmi. (Halaman apl Codex OpenAI memaparkan muat turun Windows dan nota sokongan Windows.)
2. Jalankan pemasang sebagai Pentadbir. Jika Windows SmartScreen memberi amaran, sahkan penerbit dan benarkan pemasangan.

Contoh PowerShell (pemasangan senyap melalui prompt admin):

# From an elevated PowerShell prompt (Admin)$installer = "C:\path\to\Codex-Setup.exe"Start-Process -FilePath $installer -ArgumentList "/S" -Wait

2) Larian pertama, daftar masuk, dan mod API vs. akaun

Lancarkan Codex dari Start Menu. Pada larian pertama anda akan digesa untuk daftar masuk dengan akaun ChatGPT/OpenAI anda atau menyediakan kunci API OpenAI. Daftar masuk dengan akaun memberikan pengalaman paling lancar (thread berasaskan awan, keadaan berterusan). Menggunakan kunci API berfungsi tetapi mungkin mengehadkan ciri awan tertentu. Lihat dokumentasi pembangun untuk perbezaan tepat.

Tetapkan kunci API sebagai pembolehubah persekitaran (PowerShell):

# Temporary for session$env:OPENAI_API_KEY = "sk-..."# Permanent (example - user environment)setx OPENAI_API_KEY "sk-..." /M

Petua keselamatan: Utamakan daftar masuk interaktif atau kunci jangka pendek; elakkan mengkomit kunci ke kawalan sumber.

3) Konfigurasi sandboxing dan integrasi PowerShell

Apl Windows menjalankan tugasan agen menggunakan sandbox natif untuk mengurangkan risiko pengubahsuaian hos sewenang-wenangnya. Semak halaman Security atau Settings apl untuk togol ketegasan sandbox dan semak direktori mana yang dikongsi dengan agen.

Jika anda mengutamakan PowerShell untuk hook agen, pastikan apl dibenarkan menjalankan profil PowerShell dan dasar pelaksanaan anda membenarkan skrip yang diperlukan. Contoh menetapkan dasar pelaksanaan (admin):

Set-ExecutionPolicy RemoteSigned -Scope LocalMachine

4) Pilihan: konfigurasikan Codex untuk menggunakan WSL2 (disyorkan jika anda mempunyai rantaian alat Linux)

Jika anda membangun dalam rantaian alat Linux (apt, pip, make, perkhidmatan systemd), konfigurasikan Codex untuk melaksanakan tugasan agen dalam WSL2 dan bukannya Windows natif:

Pasang WSL2 (jika belum):

# Run in an elevated PowerShellwsl --install# Reboot if requested

Pilih distro (Ubuntu disyorkan):

wsl --install -d Ubuntu

Dalam apl Codex Settings → Runtime, pilih WSL sebagai backend pelaksanaan dan arahkan Codex kepada distro WSL lalai anda (cth., Ubuntu). Apl kemudian akan menjana proses agen dalam persekitaran WSL anda supaya rantaian alat Linux dan laluan fail berfungsi secara natif.

5) Sahkan pemasangan & jalankan ujian pantas

Daripada UI apl, cipta tugasan agen ringkas untuk menyediakan rangka program kecil dan jalankan ujian unit. Atau, gunakan CLI:

Ujian CLI (PowerShell):

# Check codex version (if installed)codex --version# Run a quick agent job (pseudo-command; follow CLI docs)codex agent run --task "create python app skeleton with pytest" --project "demo"

Jika CLI tidak berada pada PATH, tambah folder pemasangan ke PATH anda atau gunakan pelancar yang dibekalkan oleh pemasang.

6) Menyahpintas masalah Windows yang lazim

• Apl tidak bermula: Semak Windows Event Viewer dan %LOCALAPPDATA%\Codex\logs.
• Sandbox menyekat agen daripada menulis fail: Laraskan tetapan apl untuk perkongsian folder atau peta folder projek ke senarai dibenarkan apl.
• Skrip PowerShell disekat: Kaji semula dasar pelaksanaan dan nyahsekat skrip (Unblock-File path\script.ps1).
• Agen gagal menggunakan WSL: Pastikan WSL2 dipasang dan distro telah diinisialisasi (lari pertama selesai). Gunakan wsl -l -v untuk menyemak status.

H2 — Cara membuat apl/CLI Codex berfungsi pada Linux (langkah demi langkah)

Dua pendekatan Linux yang praktikal:1) Disokong rasmi: Codex CLI + sambungan IDE (disokong sepenuhnya).
2) GUI tidak rasmi: projek jambatan komuniti yang menjalankan apl Electron macOS pada Linux (eksperimen, tidak disokong).

Pada masa penulisan, apl desktop Linux Codex diumumkan sebagai akan datang dan pengguna boleh mendaftar untuk notifikasi; namun, Codex CLI dan integrasi pembangun tersedia dan merupakan laluan praktikal untuk pengguna Linux. Selain itu, binaan rentas platform oleh komuniti wujud untuk pengguna lanjutan.

Laluan rasmi: Codex CLI + VS Code (stabil, disyorkan)

Pengalaman Linux yang paling mantap dan disokong hari ini ialah CLI bersama sambungan IDE Codex (VS Code, Cursor, dll.). CLI disokong secara jelas pada Linux.

Langkah 1 — Sediakan sistem anda (contoh Ubuntu)

# update OSsudo apt update && sudo apt upgrade -y# install build essentials & gitsudo apt install -y build-essential git curl# install Node.js via nvm (recommended)curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.4/install.sh | bash# restart shell or source ~/.bashrc, then:nvm install --lts

Langkah 2 — Pasang Codex CLI

# install globally without sudo (using npm + nvm)npm install -g @openai/codex# verifycodex --version

Langkah 3 — Pengesahan

# run the interactive CLI to authenticatecd /path/to/your/repocodex# follow the sign-in prompt: sign in with ChatGPT (OAuth) or paste API key

Langkah 4 — Guna codex
Contoh:

# interactive modecodex# single-shot non-interactivecodex "Write unit tests for utils/crypto.js"# run specific commands# create a sandboxed change and show diffcodex "Add a users table migration" --dry-run

Langkah 5 — Guna Git worktree (disyorkan)

# from repository rootgit checkout -b maingit worktree add ../codex-sandbox codex-sandbox-branchcd ../codex-sandbox# run Codex here so it operates on an isolated worktreecodex

Keselamatan & konfigurasi

• CLI menyimpan konfigurasi dalam ~/.codex/config.toml (lalai/override) — beri perhatian kepada kebenaran. Gunakan stor kredensial OS (Secret Service / Gnome Keyring / pass) atau pembolehubah persekitaran untuk kunci API dan bukannya fail teks biasa jika boleh.

Laluan tidak rasmi: menjalankan GUI desktop pada Linux (eksperimen)

Apl desktop OpenAI bermula pada macOS dan Windows; pengguna Linux pada masa ini boleh mendaftar untuk notifikasi bagi keluaran Linux rasmi. Sementara itu, projek komuniti telah merekayasa songsang cara menjalankan pakej Electron macOS pada Linux dengan mengekstrak app.asar, menyusun semula modul natif, dan melancarkan backend codex app-server setempat untuk menyambungkan UI. Pendekatan ini tidak disokong dan mungkin rosak dengan kemas kini—gunakan hanya untuk eksperimen dan jangan sekali-kali pada kod produksi atau repo sensitif.

Jika anda masih mahu mencuba (peringkat tinggi):

1. Muat turun .dmg macOS (daripada sumber rasmi yang anda kawal).
2. Ekstrak app.asar (pakej Electron).
3. Bina semula modul Node natif untuk Linux (node-pty, better-sqlite3, dll.).
4. Pasang Codex CLI dan jalankan codex app-server setempat untuk bertindak sebagai backend.
5. Cipta skrip pembungkus yang menetapkan pembolehubah persekitaran dan melancarkan UI Electron yang dinyahpek bersama backend setempat.

Jangan lakukan ini pada mesin sensitif. Repositori dan skrip komuniti wujud untuk mengautomasi langkah-langkah ini, tetapi ia bukan saluran sokongan rasmi.

Amalan terbaik: keselamatan, prestasi dan aliran kerja pasukan

Keselamatan — lindungi hos anda

• Gunakan sandboxing: Bila boleh, aktifkan sandbox ketat apl atau jalankan beban kerja agen dalam kontena/VM. Binaan Windows menambah sokongan sandbox natif; utamakannya untuk kod yang tidak dipercayai.
• Hak minimum untuk mount fail: Hanya kongsi folder projek tertentu dengan apl.
• Kredensial jangka pendek: Gunakan kunci API jangka pendek, token berasaskan peranan, atau daftar masuk interaktif. Putar kunci dan audit penggunaannya.
• Kebersihan repositori: Jangan sekali-kali komit rahsia — gunakan .gitignore dan pengimbas rahsia. Gunakan pembolehubah persekitaran atau stor rahsia.

Prestasi — urus persaingan sumber

• Pendikitkan keserentakan agen: Jangan jalankan berdozen-dozen binaan penuh secara selari pada komputer riba sederhana. Gunakan tetapan keserentakan apl atau penyelaras.
• Gunakan WSL atau kontena untuk tugasan berat: Alihkan binaan dan ujian berat ke WSL atau persekitaran berkontena untuk mengelakkan perangkap prestasi sistem fail Windows.
• Profilkan tugasan: Gunakan pemantauan CPU/RAM (Task Manager, top, htop) ketika agen berjalan untuk memahami kebuntuan.

Syor aliran kerja pasukan

• Konfigurasi bersama: Kekalkan resipi agen (prompt tugasan, rantaian alat, skrip lancar) dalam direktori codex/ bersama (tanpa rahsia) supaya pasukan boleh menghasilkan semula larian agen.
• Kawalan CI: Gunakan agen Codex untuk mencadangkan perubahan kod, tetapi hadkan penggabungan dengan semakan CI — jangan biarkan agen menggabung secara automatik tanpa semakan manusia.
• Pembalakan & audit: Aktifkan pembalakan terperinci untuk tindakan agen supaya anda boleh menjejak apa yang dilakukan agen dan kembali semula jika perlu.

Matriks penyahpepijatan (rujukan pantas)

Nota penutup

Apl Codex mewakili langkah konkrit ke arah automasi berasaskan agen yang berjalan lama untuk pembangun. Dengan keluaran Windows dan iterasi berterusan, pembangun kini mempunyai lebih banyak cara untuk menjalankan, mengorkestrasikan, dan mengintegrasikan Codex ke dalam aliran kerja merentas platform. Jika anda memasangnya buat kali pertama, utamakan pemasang Windows rasmi atau CLI rasmi pada Linux; utamakan sandboxing dan WSL untuk keserasian dengan rantaian alat Linux; dan ikuti amalan terbaik keselamatan serta operasi di atas.

CometAPI ialah platform pengagregatan sehenti untuk API model besar, menawarkan integrasi dan pengurusan perkhidmatan API yang lancar. Ia menyokong pemanggilan pelbagai model AI arus perdana, seperti Claude Sonnet/ Opus 4.6 dan GPT-5.3 Codex. Sebelum mengakses, pastikan anda telah log masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga rasmi untuk membantu anda mengintegrasikan Codex.

Sedia untuk bermula?→ Daftar untuk mula menulis kod hari ini !

Jika anda mahu mengetahui lebih banyak tip, panduan dan berita tentang AI, ikuti kami di VK, X dan Discord!