ApiFlux 使用前準備：安裝終端機和基礎環境

本指南面向第一次使用命令列工具的使用者。完成本頁後，使用者會知道如何開啟終端機、安裝常用基礎環境、設定 API Key，並理解 Windows 與 macOS / Linux 命令為什麼不一樣。

如果只是在 ApiFlux 控制台建立 API Key，可以先看建立 ApiFlux API Key。如果要連線 Codex CLI、Claude Code、OpenCode，建議先讀完本頁。

需要先知道的 3 個概念

1. 終端機是什麼

終端機是輸入命令的地方。Codex CLI、Claude Code、OpenCode 都屬於命令列工具，需要在終端機裡啟動。

Windows 使用者可以點選開始選單，搜尋 PowerShell。macOS 使用者可以按 Command + 空格，搜尋 Terminal 或 終端機。Linux 使用者通常可以從應用選單中開啟 Terminal。

開啟後執行：

pwd

如果能看到目前目錄，說明終端機可以正常使用。

2. API Key 是什麼

API Key 是工具存取 ApiFlux 的憑證。可以把它理解成一把「介面鑰匙」。

指南中統一使用佔位寫法：

YOUR_APIFLUX_API_KEY

實際操作時，請替換成使用者自己在 ApiFlux 控制台建立的 Key。

[!WARNING] 不要把真實 API Key 發到公開群、論壇、GitHub、公開影片或未打碼截圖中。

3. Base URL 是什麼

Base URL 是工具把請求發到哪裡的地址。ApiFlux 的 OpenAI-compatible Base URL 是：

https://apiflux.ai/v1

官網入口是：

https://apiflux.ai/

官網入口用於登入和管理帳號；Base URL 用於設定工具和 SDK。兩者不要混用。

Windows 準備步驟

1. 開啟 PowerShell

點選開始選單，搜尋：

PowerShell

開啟後可以輸入命令。

2. 安裝 Node.js LTS

Codex CLI 和 OpenCode 常見安裝方式會用到 npm。npm 會隨 Node.js 一起安裝。

開啟 Node.js 官網：

https://nodejs.org/

下載並安裝 LTS 版本。安裝完成後，關閉 PowerShell，再重新開啟。

驗證是否安裝成功：

node -v
npm -v

如果能看到版本號，說明安裝成功。

3. 設定 ApiFlux Key

暫時環境變數只在目前 PowerShell 視窗有效，適合第一次測試：

$env:APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

檢查是否設定成功：

echo $env:APIFLUX_API_KEY

如果希望以後每次開啟 PowerShell 都能使用這個 Key，可以設定為使用者環境變數：

[Environment]::SetEnvironmentVariable("APIFLUX_API_KEY","YOUR_APIFLUX_API_KEY","User")

設定後請關閉 PowerShell，再重新開啟。

macOS 準備步驟

1. 開啟終端機

按 Command + 空格，搜尋：

Terminal

2. 安裝 Node.js LTS

開啟 Node.js 官網：

https://nodejs.org/

下載並安裝 LTS 版本。安裝完成後，關閉終端機，再重新開啟。

驗證是否安裝成功：

node -v
npm -v

3. 設定 ApiFlux Key

暫時設定：

export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

檢查是否設定成功：

echo $APIFLUX_API_KEY

長期設定可以寫入 ~/.zshrc：

echo 'export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux 準備步驟

1. 開啟終端機

從應用選單開啟 Terminal。

2. 安裝常用基礎工具

Ubuntu / Debian 使用者可以執行：

sudo apt update
sudo apt install -y curl git

Fedora 使用者可以執行：

sudo dnf install -y curl git

3. 安裝 Node.js LTS

開啟 Node.js 官網：

https://nodejs.org/

按照 Linux 安裝說明安裝 LTS 版本。

安裝完成後驗證：

node -v
npm -v

4. 設定 ApiFlux Key

暫時設定：

export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"

檢查：

echo $APIFLUX_API_KEY

長期設定可以寫入 ~/.bashrc：

echo 'export APIFLUX_API_KEY="YOUR_APIFLUX_API_KEY"' >> ~/.bashrc
source ~/.bashrc

如果使用 zsh，則寫入 ~/.zshrc。

Windows 是否需要 WSL

不一定。普通使用者可以直接使用 Windows PowerShell。

如果使用者經常使用開發工具、Git、Node.js、Linux 命令，推薦安裝 WSL，然後在 WSL 裡按 Linux 指南操作。這樣與大多數開發文件更一致。