跳轉到主要內容

​
OpenAI Codex CLI 集成

AiHubMix 提供了與 OpenAI Codex CLI 的無縫集成，讓你可以在命令列環境中利用先進的 AI 程式助手。透過簡單的配置步驟，即可在終端機中直接使用自然語言執行各種程式和系統操作任務。 使用之前，請先執行以下指令安裝或更新： 
npm install -g @openai/codex

​
配置步驟

​
1. 環境變數設定

打開你的 Shell 配置檔（例如 .zshrc 或 .bashrc），新增以下環境變數： 
export OPENAI_BASE_URL="https://aihubmix.com/v1"
export OPENAI_API_KEY="sk-***" # 替換為你的 AiHubMix API 密鑰
這裡的 OPENAI_API_KEY 應該使用 AiHubMix 的密鑰，變數名稱保持為 OPENAI_API_KEY 是為了相容 OpenAI 原生客戶端。

​
2. 套用配置變更

在終端機中執行以下指令，使環境變數生效： 
source ~/.zshrc  # 如果使用 zsh
# 或
source ~/.bashrc  # 如果使用 bash

​
3. 啟動 Codex CLI

定位到你的專案目錄，然後執行 codex 指令： 
cd /你的專案路徑
codex
圖片

​
4. 使用自然語言執行任務

現在你可以透過自然語言向 Codex CLI 輸入指令，例如： 
# 範例輸入
講解一下 AnimatedText
圖片

​
進階配置

  • 預設模型為 codex-mini-latest，一個專為編碼任務微調過的 o4-mini，可以在 ~/.codex/config.json修改
  • 目前僅支援 OpenAI 家的模型，模型列表可在 Responses API 文件 中查看
  • 你可以透過編輯 ~/.codex/instructions.md 檔案來自訂系統提示詞，定制 AI 助手的行為

​
實用指令參考

​
幫助指令

codex -h

​
完整指令選項

Usage
  $ codex [options] <prompt>

Options
  -h, --help                 顯示幫助資訊並退出
  -m, --model <model>        指定使用的模型 (預設: codex-mini-latest)
  -i, --image <path>         包含圖像輸入的檔案路徑
  -v, --view <rollout>       查看之前保存的會話記錄
  -q, --quiet                非互動模式，僅列印助手的最終輸出
  -a, --approval-mode <mode> 覆蓋審批策略: 'suggest', 'auto-edit', 或 'full-auto'

  --auto-edit                自動批准檔案編輯；仍會提示確認指令
  --full-auto                自動批准沙箱環境中的編輯和指令

  --no-project-doc           不自動包含倉庫中的 'codex.md' 檔案
  --project-doc <file>       包含指定的 Markdown 檔案作為上下文
  --full-stdout              不截斷指令輸出的 stdout/stderr

危險選項
  --dangerously-auto-approve-everything
                             跳過所有確認提示並直接執行指令（無沙箱保護）
                             僅用於臨時本地測試環境

實驗性選項
  -f, --full-context         以"完整上下文"模式啟動，將整個倉庫加載到上下文中
                             並在一次操作中應用批量編輯
                             僅相容 --model 參數

範例
  $ codex "編寫並運行一個列印 ASCII 藝術的 Python 程式"
  $ codex -q "修復構建問題"