Codex CLI 是開源 AI 程式碼輔助工具，可在本地終端機執行，同時透過 API 連接遠端 AI 模型。以 Rust 編寫，兼具效能與安全性，能夠讀取、修改並執行所選目錄中的程式碼，同時維持嚴格的沙箱保護機制。
本指南將教你如何透過 Novita AI 為 Codex CLI 配置先進 AI 模型，包含專注於程式碼編寫的 Qwen Coder、專注於推理的 DeepSeek，以及代理型模型 Kimi K2 等。
什麼是 Codex CLI？
Codex CLI 是終端機為基礎的編碼代理工具，結合本地執行與雲端 AI 能力。與僅能產生程式碼片段的一般程式碼生成工具不同，Codex CLI 能理解整個專案、執行自己建立的程式碼、除錯問題，並反覆迭代直到解決方案正常運作。
主要功能
本地優先架構：完全在你的機器上執行，僅透過 API 呼叫遠端 AI 模型。你的程式碼保留在本地，同時能運用強大的雲端 AI 能力。
專案理解能力：讀取整個程式碼庫，理解現有的模式、依賴關係和編碼風格，產出能無縫整合到專案中的程式碼。
自主運作能力：可長時間獨立運作，將複雜任務拆解並系統性執行，只需極少監督。
彈性審核模式：
- 建議模式：每一步驟都會請求審核（預設）
- 自動編輯模式：自動編輯檔案，但執行指令前會請求確認
- 全自動模式：完全自主運作，無需提示
安全功能：在停用網路、目錄沙箱化的環境中執行，在保留完整功能的同時保護你的系統。
Codex CLI 與 Claude Code 的主要差異
在開始設定 Codex CLI 之前，了解它與另一款熱門 AI 編碼輔助工具 Claude Code 的差異非常重要：
Codex CLI
- 模型支援：支援 OpenAI 模型與 OpenAI 相容 API，同時支援多家供應商
- 架構：在終端機執行的本地代理工具，透過 API 呼叫遠端模型
- 開源屬性：完全開源，接受社群貢獻
Claude Code
- 模型支援：專注於 Anthropic 的 Claude 模型與 Anthropic 相容 API
- 架構：整合網頁、桌面與 IDE 平台的跨平台體驗
- 開發模式：核心為專有技術，僅提供 API 存取
Codex CLI 在精準度與處理複雜任務（尤其是既有程式碼庫）的能力上更勝一籌。Claude Code 則通常因其使用者體驗與新專案初始設定流程更受青睞。部分使用者發現同時使用兩款工具能獲得最佳效果。
若你需要 Claude 專屬的工作流程，可參考我們的使用 Novita AI 搭配 Claude Code 指南。
為什麼要在 Codex CLI 中使用第三方 API？
雖然 Codex CLI 原生支援 OpenAI 的模型，但 Novita AI 等第三方 API 仍具備關鍵優勢：
專注領域的模型：可使用 DeepSeek V3.1 等尖端推理模型、Qwen Coder 等程式設計專用模型，以及 Kimi K2 等代理型工作流程模型。
成本與效能：價格具競爭力，且模型針對特定任務優化，從輕量回應到複雜問題解決都能勝任。
自訂模型：透過 Novita AI，你還能在 Codex CLI 中快速使用自己的自訂模型，滿足特殊需求。
可靠性：替代供應商能降低速率限制，確保在服務中斷或區域限制期間仍能穩定存取。
如何在 Codex CLI 中使用 Novita AI 模型
前置條件
- 建立帳號：造訪 Novita AI 官方網站 註冊帳號。
- 生成 API 金鑰：登入後，前往 金鑰管理 頁面生成你的 API 金鑰。
- 選擇模型名稱：你需要從 Novita AI 的**模型庫** 複製要使用的模型名稱，部分可用模型包含：
deepseek/deepseek-v3.1qwen/qwen3-coder-480b-a35b-instructmoonshotai/kimi-k2-0905openai/gpt-oss-120bzai-org/glm-4.5google/gemma-3-12b-it
- 安全儲存：你將在配置時需要用到它。
安裝
透過 npm 安裝（推薦）
npm install -g @openai/codex
透過 Homebrew 安裝（macOS）
brew install codex
驗證安裝
codex --version
配置 Novita AI 模型
建立配置文件
Codex CLI 使用 TOML 格式的配置文件，位置如下：
- macOS/Linux：
~/.codex/config.toml - Windows：
%USERPROFILE%\.codex\config.toml
基礎配置模板
model = "MODEL_NAME"
model_provider = "novitaai"
[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"
可用模型與適用場景
| 模型 | 適用場景 | 優勢 |
|---|---|---|
deepseek/deepseek-v3.1 |
複雜演算法與架構設計 | 推理與問題解決能力出眾 |
qwen/qwen3-coder-480b-a35b-instruct |
程式碼生成與重構 | 專為程式設計任務優化 |
moonshotai/kimi-k2-0905 |
代理型工作流程與自動化 | 執行速度快，長上下文處理能力強 |
openai/gpt-oss-120b |
一般開發任務 | 可靠的基準效能 |
zai-org/glm-4.5 |
工具整合與除錯 | 工具呼叫成功率高 |
google/gemma-3-12b-it |
輕量級開發任務 | 回應高效且快速 |
快速開始
啟動 Codex CLI
codex
基礎使用範例
程式碼生成：
> 建立一個處理 REST API 回應的 Python 類別，包含錯誤處理機制
專案分析：
> 檢視這個程式碼庫，並提出效能改進建議
錯誤修復：
> 修復登入功能中的認證錯誤
測試：
> 為使用者服務模組生成全面的單元測試
搭配既有專案使用
在啟動 Codex CLI 前，先切換到你的專案目錄：
cd /path/to/your/project
codex
Codex CLI 會自動理解你的專案結構、讀取現有檔案，並在整個工作階段中保留對程式碼庫的上下文。
結論
搭配 Novita AI 模型的 Codex CLI 提供了強大且靈活的開發環境，結合了本地控制與雲端 AI 能力。透過為每個任務選擇合適的模型並正確配置環境，你可以在維持程式碼品質與安全性的同時，大幅加速開發工作流程。
建議先使用 Qwen Coder 進行基礎配置，處理一般開發任務，之後隨著需求演進，再嘗試使用 DeepSeek 處理複雜推理，或使用 Kimi K2 處理自主工作流程。
關於 Novita AI
Novita AI 是 AI 雲端平台，為開發者提供簡單的 API 介面部署 AI 模型，同時也提供實惠且可靠的 GPU 雲端服務，用於建構與擴展 AI 應用。
推薦閱讀
