Codex CLI:OpenAI推出的本地編碼AI智能體
Codex CLI是什么?
Codex CLI 是Openai推出的一個輕量級命令行工具,可以為終端用戶提供類似 ChatGPT 的推理能力,并能夠實際運行代碼、操作文件并進行迭代,所有操作都在版本控制下完成。它支持多模態輸入,允許用戶通過自然語言指令完成代碼生成、編輯和運行等任務。
Codex CLI主要功能
代碼生成與編輯:用戶可以通過簡單的英語指令讓 Codex CLI 生成代碼,例如“創建一個 Python 腳本,讀取 CSV 文件并打印某列的平均值”。
文件管理:支持執行文件操作,如“將所有 .txt 文件移動到名為 notes 的文件夾中”。
調試輔助:用戶可以粘貼錯誤信息,Codex CLI 會提供修復建議。
項目搭建:能夠快速生成項目模板,例如“搭建一個基本的 Node.js 服務器”。
多模態支持:支持通過截圖或圖表輸入來實現功能。
本地運行:Codex CLI 在本地運行,所有文件的讀取、寫入和命令執行均在本地完成,除非用戶主動選擇分享,否則源代碼不會離開本地環境。
Codex CLI特點
開源與免費:Codex CLI 是完全開源的,用戶可以自由查看、修改代碼,并貢獻到其開發中。
本地運行:該工具在本地終端運行,確保代碼執行和文件操作在用戶系統內完成,保障數據隱私。
模型無關性:默認使用 OpenAI 的 GPT-4-turbo 模型,但用戶可以切換到其他兼容的 API 端點,如 o3 和 o4-mini。
靈活配置:通過 .codex YAML 文件進行配置,支持自定義變量和模板。
安全模型與權限
Codex CLI 提供三種審批模式,用戶可以通過 --approval-mode 參數選擇:
建議模式(默認):可以讀取倉庫中的任何文件,但需要用戶批準所有文件寫入和 Shell 命令。
自動編輯模式:可以讀取并應用補丁寫入文件,但需要用戶批準所有 Shell 命令。
全自動模式:可以讀寫文件并執行 Shell 命令,無需用戶批準。
Codex CLI使用場景
Codex CLI 主要面向在終端環境中工作的開發者,幫助他們更高效地完成日常開發任務。它并非完全自動化的編碼助手,而是用于支持和加速常規任務。
Codex CLI安裝方法
通過 npm 安裝(推薦):
npm install -g @openai/codex
從源代碼構建:
克隆倉庫并進入 CLI 包目錄:
git clone https://github.com/openai/codex.git cd codex/codex-cli
安裝依賴并構建:
npm install npm run build
運行本地構建的 CLI 或通過 npm link 全局鏈接。
配置
Codex CLI 會在 ~/.codex/ 目錄中查找配置文件:
config.yaml:可以設置默認模型等配置項。
instructions.md:可以定義自定義指令。
使用
交互式運行:
codex
運行特定命令:
codex "explain this codebase to me"
全自動模式:
codex --approval-mode full-auto "create the fanciest todo-list app"
非交互模式 / CI 模式
可以在 CI/CD 流水線中以無頭模式運行 Codex CLI。例如:
- name: Update changelog via Codex run: | npm install -g @openai/codex export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}" codex -a auto-edit --quiet "update CHANGELOG for next release"
github地址:https://github.com/openai/codex
詳細情況:https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started