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 指南操作。这样与大多数开发文档更一致。