VLX FLUX

简体中文

English

简体中文

English

Appearance

CLI 配置教程 ​

本指南涵盖 Claude Code、Codex、Gemini CLI 的基础安装与接入配置。

前置提示

在继续阅读并配置命令行工具前，请先理解以下核心概念：

环境依赖 ​

本节涵盖 Node.js、npm 等依赖的安装。

使用 Winget 安装（Windows） ​

打开终端，运行：

bash
winget install OpenJS.NodeJS.LTS

安装完成后，在新的终端中运行 node -v 和 npm -v 验证。

使用 Brew 安装（macOS） ​

打开终端，运行：

bash
brew install node

如果未安装 Brew，请参考 Homebrew 官方文档。

验证环境 ​

在终端中运行以下命令，如果输出版本号即表示成功。

bash
node -v

提示

配置国内 npm 镜像源可提升下载速度：npm config set registry https://registry.npmmirror.com

bash
npm -v

Claude Code 配置 ​

安装 ​

Windows：

bash
npm install -g @anthropic-ai/claude-code

macOS / Linux 如需全局权限，可使用：

bash
sudo npm install -g @anthropic-ai/claude-code

配置环境变量 ​

Windows：

bash
setx ANTHROPIC_API_KEY "sk-xxxxxxxxxxxxxx" # 替换为你的 API Key

macOS/Linux：

bash
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://api.vlxflux.io"

配置文件 ​

在用户主目录下创建或编辑 .claude.json：

json
{
  "theme": "dark",
  "apiBaseUrl": "https://api.vlxflux.io"
}

启动 ​

bash
claude

Codex 配置 ​

安装 ​

Windows：

bash
npm install -g codex-cli

如需全局权限：

bash
sudo npm install -g codex-cli

环境变量 ​

Windows：

bash
setx OPENAI_API_KEY "sk-xxxxxxxxxxxxxx" # 替换为你的 API Key

macOS/Linux：

bash
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxx"
export OPENAI_BASE_URL="https://api.vlxflux.io/v1"

配置文件 ​

编辑 ~/.codex/config.json：

json
{
  "api_key": "sk-xxxxxxxxxxxxxx",
  "base_url": "https://api.vlxflux.io/v1",
  "model": "gpt-4o"
}

启动 ​

bash
codex

Gemini CLI 配置 ​

安装 ​

Windows：

bash
npm install -g @google/generative-ai-cli

如需全局权限：

bash
sudo npm install -g @google/generative-ai-cli

环境变量 ​

在 macOS/Linux 终端运行：

bash
export GEMINI_API_KEY="sk-xxxxxxxxxxxxxx"
export GOOGLE_GEMINI_BASE_URL="https://api.vlxflux.io"

配置文件 ​

编辑 ~/.gemini/config.json：

json
{
  "api_key": "sk-xxxxxxxxxxxxxx",
  "base_url": "https://api.vlxflux.io"
}

启动 ​

bash
gemini

常见问题 ​

API 密钥配置不生效？

重启终端，或使用 echo 命令检查环境变量是否成功加载。

提示模型不存在？

请确认模型名称正确，并确保该 API key 拥有对应模型权限。

无法连接服务器？

请检查 BASE_URL 是否正确、网络代理是否影响访问、以及 DNS 解析是否正常。

Claude Code 未授权？

可以重新导出 ANTHROPIC_BASE_URL 后再启动。

bash
export ANTHROPIC_BASE_URL="https://api.vlxflux.io"
claude

附加配置 ​

动态切换模型 ​

在 ~/.bashrc 或 ~/.zshrc 中添加别名：

bash
alias claude_opus='export ANTHROPIC_MODEL="claude-3-opus-20240229" && claude'

然后运行：

bash
source ~/.zshrc
claude_opus

隐藏不必要输出 ​

bash
codex "写一段快速排序" --quiet