Aiberm logo
登入

Codex CLI 設定

了解如何設定 Codex CLI 以使用 Aiberm 的 API。本指南涵蓋 Windows、macOS 和 Linux 的安裝與設定。

什麼是 Codex CLI？

Codex CLI 是 OpenAI 的命令列介面，專為與程式碼相關的終端機任務而設計。與通用聊天工具相比，它強調工程就緒的輸出，提供更清晰、可執行的程式碼變更。透過設定它使用 Aiberm，您可以透過具成本效益的端點存取多個 AI 模型。

前置條件

開始之前，請確認您具備：

安裝

使用 npm 全域安裝 Codex CLI：

npm install -g @openai/codex

驗證安裝：

codex --version

這應該會顯示版本號。

設定

Codex CLI 使用 config.toml 檔案進行設定。設定目錄位置因作業系統而異：

  • Windows：%userprofile%\.codex
  • macOS/Linux：~/.codex

方法 1：手動設定

前往設定目錄並建立或編輯 config.toml：

macOS/Linux：

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows：

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

加入以下設定：

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

重要提示： 請將 sk-your-aiberm-api-key 替換為你在 Aiberm 建立的實際 API Key。Key 會以明文儲存在 config.toml，請不要將此檔案提交到 Git，也不要與他人分享。

方法 2：一鍵設定

macOS/Linux：

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
EOF

Windows PowerShell：

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null
@"
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

重要提示： 請將設定中的 sk-your-aiberm-api-key 替換為你在 Aiberm 建立的實際 API Key。Key 會以明文儲存在 config.toml，請不要將此檔案提交到 Git，也不要與他人分享。

驗證設定

檢查 Node.js 安裝：

node -v
npm -v

驗證 Codex CLI 安裝：

codex --version

測試 API 連線：

codex "Hi"

如果設定正確，Codex CLI 應該使用 Aiberm 的 API 進行回應。

疑難排解

401 未授權錯誤

  • 驗證您的 API 金鑰是否正確：控制台 → API 金鑰
  • 確認 experimental_bearer_token 已填入實際的 Aiberm API Key，且沒有原樣儲存佔位符

403 禁止存取錯誤

  • 檢查您的 API 金鑰是否有效
  • 在 https://aiberm.com/console 確認您的帳戶餘額
  • 確認您的 API 金鑰可以存取所請求的模型

網路錯誤

  • 驗證您的網際網路連線
  • 檢查您是否可以在瀏覽器中存取 https://aiberm.com
  • 確認您的防火牆允許對外 HTTPS 連線
  • 確認 config.toml 中的 base_url 正確：https://aiberm.com/v1

設定未生效

  • 編輯 config.toml 後重新啟動終端機
  • 驗證 TOML 語法格式（沒有多餘空白，引號正確）
  • 檢查設定檔位置對您的作業系統是否正確
  • 確認檔案儲存為 config.toml（而不是 config.toml.txt）

找不到 Codex 命令

macOS/Linux：

# 檢查 npm 全域 bin 是否在 PATH 中
npm config get prefix

# 如果需要，在 ~/.zshrc 或 ~/.bashrc 中加入 PATH：
export PATH="$(npm config get prefix)/bin:$PATH"

Windows：

  • 驗證 npm 全域路徑是否在系統 PATH 中
  • npm 安裝後重新啟動終端機
在 GitHub 上編輯此頁