Lightweight coding agent that runs in your terminal
★ 135,398⑂ 21,474👁 666⑃ 19,107● 40,904▤ 1,294
+112
Daily
+1,284
Weekly
+5,865
Monthly
135,398
stars
21,474
forks
666
watchers
19,107
prs
40,904
issues
1,294
releases
README
Codex CLI is a coding agent from OpenAI that runs locally on your computer. If you want Codex in your code editor (VS Code, Cursor, Windsurf), install in your IDE. If you want the desktop app experience, run codex app or visit the Codex App page. If you are looking for the cloud-based agent from OpenAI, Codex Web, go to chatgpt.com/codex. --- Quickstart Installing and running Codex CLI Run the following on Mac or Linux to install Codex CLI: shell curl -fsSL https://chatgpt.com/codex/install.sh | sh Run the following on Windows to install Codex CLI: shell powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" The standalone installers download from https://releases.openai.com/codex by default and fall back to GitHub Releases if a metadata or asset download is unavailable. To force GitHub Releases, set CODEX_INSTALLER_USE_RELEASES_OPENAI_COM to false (0 and no are also accepted): shell curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh powershell $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex Codex CLI can also be installed via the following package managers: shell Install using npm npm install -g @openai/codex shell Install using Homebrew brew install --cask codex Then simply run codex to get started. You can also go to the latest GitHub Release and download the appropriate binary for your platform. Each GitHub Release contains many executables, but in practice, you likely want one of these: - macOS - Apple Silicon/arm64: codex-aarch64-apple-darwin.tar.gz - x86_64 (older Mac hardware): codex-x86_64-apple-darwin.tar.gz - Linux - x86_64: codex-x86_64-unknown-linux-musl.tar.gz - arm64: codex-aarch64-unknown-linux-musl.tar.gz Each archive contains a single entry with the platform baked into the name (e.g., codex-x86_64-unknown-linux-musl), so you likely want to rename it to codex after extracting it. Using Codex with your ChatGPT plan Run codex and select Sign in with ChatGPT. We recommend signing into your ChatGPT account to use Codex as part of your Plus, Pro, Business, Edu, or Enterprise plan. Learn more about what's included in your ChatGPT plan. You can also use Codex with an API key, but this requires additional setup. Docs - Codex Documentation - Contributing - Installing & building - Open source fund This repository is licensed under the Apache-2.0 License.
Top issues
#51601Windows app 26.1002.51308: sandbox setup fails with sharing violation when validating its own active runtime125 comments · 2026-10-07#36040Regression: iOS Remote only lists projects with recent chats117 comments · 2026-07-29#20214Codex App frequently freezes/stutters on Windows 11 Pro despite sufficient system resources114 comments · 2026-04-29#28969Add setting to disable the auto-resolve in 60 seconds for questions99 comments · 2026-06-18#9203Please make "/undo" back99 comments · 2026-01-14#49458[Windows] dot-started local tasks lack Computer Use tools while ordinary local Codex sessions work98 comments · 2026-09-30#48237unexpected status 401 Unauthorized issue97 comments · 2026-09-25#52407Windows Dots: CUA MXC launcher fails with HRESULT 0x80070003 after direct shell recovery96 comments · 2026-10-09
Discussions
#61681Automating Codex project handoffs with NotebookLM0 comments · 2026-11-15#61668AI-Memory-Book: local, cited conversation recall for Codex over MCP0 comments · 2026-11-15#61667A handoff note that reopens after reload, plus Codex setup0 comments · 2026-11-15#61666A Codex-assisted browser check that requires reopening the saved file0 comments · 2026-11-15#61640Google Ads campaigns from Codex: a free plugin that builds them paused for your review (I'm from AdeptAds)0 comments · 2026-11-15#61614Feature Proposal: Automatic Task Resumption After Usage Limit Reset0 comments · 2026-11-15#61612Feature Proposal:0 comments · 2026-11-15#61585Chatstone's Codex-side archive adapter: hook wakeups are not transcript completion0 comments · 2026-11-15
Latest release
0.169.0 rust-v0.169.0 2026-11-13New Features - The opt-in terminal workspace supports multiple side-chat tabs. Switch between them with the keyboard or mouse, and reopen saved local side chats after restarting Codex. (59784, 60152, 60181) - Search older tasks from the agent command center by name, prompt preview, or working directory. (60286) - Turn on Collapse turn details in the full-screen transcript to fold completed activity beneath each prompt while keeping answers visible and tool output searchable. (60554, 60555, 60556, 60557) - Add or edit custom model providers from the terminal. With custom gateway onboarding ena
相关报道 (12)
動區動趨開發工具 Postman 會自動幫 AI 代理裝外掛,不需開發者批准同意2026-11-04動區動趨AI 逆向工具「REA 」GitHub 十天衝上 17 萬星,真的什麼都能拆嗎?2026-10-13TechNews 科技新報GitHub 擁抱 Claude、Codex,編碼代理程式進駐平台2026-02-04TechNews 科技新報OpenAI 推出 AI 編碼代理工具「Codex」,付費用戶優先使用2025-05-16华尔街见闻OpenAI收购Pierre,不仅要写代码,还要把整个GitHub给端了2026-11-05cnBeta.COMOpenAI收购神秘团队 奥特曼要在Codex里再造一个GitHub2026-11-05新浪财经刚刚,OpenAI收购Pierre,Codex要对Git下手?_手机新浪网2026-11-05投资界刚刚,OpenAI收购Pierre,Codex要对Git下手?2026-11-04智源社区OpenAI 将收购 Pierre Computer,计划把 Code Storage 整合进 Codex,瞄准微软 GitHub2026-11-04Pasquale PillitteriOpenAI 发布 Pando,用 Codex 在 10 周内构建的 Git 后端2026-11-04
News & coverage (24)
Hacker NewsChatGPT Desktop forwards your SSH agent to remote machines▲ 203 · 71 comments · 2026-11-09Hacker NewsTell HN: The Codex App is replaced by ChatGPT▲ 6 · 4 comments · 2026-07-13Hacker NewsA GPT-5.4 bug led to OpenAI banning goblins and raccoons▲ 6 · 1 comments · 2026-04-29Hacker NewsAsk HN: Is Codex login down for all workspace (non-personal) users?▲ 6 · 2 comments · 2026-01-15Hacker NewsAsk HN: GPT-5.3-Codex being silently routed to GPT-5.2?▲ 5 · 3 comments · 2026-02-12Hacker NewsShow HN: BYO AI free notetaking with optional screen reading for OpenClaw/hermes▲ 3 · 3 comments · 2026-07-14Hacker NewsAsk HN: Are Google Search AI hallucinations common?▲ 1 · 0 comments · 2025-12-31Hacker NewsCodex can read sensitive files outside the CWD without approval▲ 1 · 0 comments · 2025-11-25noteWhy Did OpenAI Build Its Own Git in 10 Weeks? The Truth Behind the 7.38 Billion Monthly Commit Limit and the Pierre Acquisition2026-11-10noteMy Codex Challenge at Sixty: How I Got Lost on GitHub but Still Built a Web Page Without Writing Code2026-11-08