AI CLI 工具配置教程 - 飞鹰中转站

🔍 一、环境检查与准备

在开始安装之前，我们先检查你的电脑是否已经具备必要的环境。

1.1 检查 Node.js 是否已安装

1打开终端

按 Command + 空格，输入「终端」或「Terminal」，回车打开

2检查 Node.js 和 npm 版本

node --version && npm --version

1打开 PowerShell

按 Win + X，选择「Windows PowerShell」或「终端」

2检查 Node.js 和 npm 版本

node --version
npm --version

1打开终端

按 Ctrl + Alt + T 打开终端

2检查 Node.js 和 npm 版本

node --version && npm --version

1.2 检查结果判断

检查结果	含义	下一步
`v18.x.x` 或更高	符合要求	直接跳转到你需要的工具配置章节
`v16.x.x` 或更低	版本过低	需要升级，查看第二章
`'node' 不是内部或外部命令`	未安装	需要安装，查看第二章
`command not found: node`	未安装	需要安装，查看第二章

💡 版本要求说明

大多数 AI CLI 工具需要 Node.js 18 或更高版本。推荐安装 LTS（长期支持）版本，目前是 Node.js 20 或 22。

📦 二、Node.js 安装指南

方式一：官网下载安装（推荐新手）

1下载安装包

访问 Node.js 官网：https://nodejs.org

点击下载 LTS（长期支持版）的 macOS Installer (.pkg)

2运行安装程序

双击下载的 .pkg 文件，按照提示一路点击「继续」完成安装

3验证安装

关闭并重新打开终端，然后执行：

node --version && npm --version

方式二：使用 Homebrew 安装（推荐开发者）

# 安装 Homebrew（如果没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node@20

# 配置环境变量
echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

方式三：使用 nvm（多版本管理）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重启终端后安装 Node.js
nvm install --lts
nvm alias default node

方式一：官网下载安装（推荐）

1下载安装包

访问 https://nodejs.org，下载 LTS 版本的 Windows Installer (.msi)

2运行安装程序

双击 .msi 文件
一路点击「Next」
重要：确保勾选「Add to PATH」选项
点击「Install」完成安装

3验证安装

关闭所有命令行窗口，重新打开 PowerShell，执行：

node --version
npm --version

⚠️ 重要提醒

安装完成后必须重启命令行窗口，否则环境变量不会生效！

方式二：使用 Scoop 安装

# 安装 Scoop（管理员 PowerShell）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# 安装 Node.js
scoop install nodejs-lts

Ubuntu / Debian

# 添加 NodeSource 仓库并安装
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version && npm --version

CentOS / RHEL / Fedora

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

Arch Linux

sudo pacman -S nodejs npm

通用方式：使用 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重启终端后
nvm install --lts

🤖 三、Claude Code 配置 Anthropic

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。

3.1 安装 Claude Code

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 如果遇到权限问题
sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

以管理员身份打开 PowerShell，执行：

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

3.2 配置中转站

方式一：一键配置（推荐）

# Zsh 用户（macOS 默认）
echo 'export ANTHROPIC_BASE_URL="https://cc.feiyingsteam.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxx你的key"' >> ~/.zshrc
source ~/.zshrc

# Bash 用户
echo 'export ANTHROPIC_BASE_URL="https://cc.feiyingsteam.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxx你的key"' >> ~/.bashrc
source ~/.bashrc

方式二：手动编辑配置文件

# 编辑配置文件
nano ~/.zshrc

# 在文件末尾添加以下内容
export ANTHROPIC_BASE_URL="https://cc.feiyingsteam.com"
export ANTHROPIC_API_KEY="sk-xxx你的key"

# 保存后使配置生效
source ~/.zshrc

方式一：PowerShell 命令（推荐）

# 设置环境变量（永久生效）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://cc.feiyingsteam.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxx你的key", "User")

# 重启 PowerShell 后生效

方式二：图形界面设置

按 Win + R，输入 sysdm.cpl，回车
点击「高级」→「环境变量」
在「用户变量」中点击「新建」，添加：

变量名	变量值
`ANTHROPIC_BASE_URL`	`https://cc.feiyingsteam.com`
`ANTHROPIC_API_KEY`	`sk-xxx（你的 API Key）`

3.3 验证配置

# 检查环境变量
echo $ANTHROPIC_BASE_URL  # macOS/Linux
$env:ANTHROPIC_BASE_URL   # Windows PowerShell

# 启动 Claude Code 测试
claude

✅ 配置成功标志

Claude Code 正常启动，能够发送消息并收到回复。

3.4 常用命令

命令	说明
`claude`	启动交互模式
`claude --version`	查看版本
`/model`	切换模型
`/clear`	清除对话
`Ctrl + C`	中断操作
`Ctrl + D`	退出

💚 四、Codex CLI 配置 OpenAI

Codex CLI 是 OpenAI 推出的命令行编程助手，基于 GPT 模型。

4.1 安装 Codex CLI

# 使用 npm 安装
npm install -g @openai/codex

# 验证安装
codex --version

4.2 配置中转站

# Zsh 用户（macOS 默认）
echo 'export OPENAI_BASE_URL="https://cc.feiyingsteam.com/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="sk-xxx你的key"' >> ~/.zshrc
source ~/.zshrc

# Bash 用户
echo 'export OPENAI_BASE_URL="https://cc.feiyingsteam.com/v1"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="sk-xxx你的key"' >> ~/.bashrc
source ~/.bashrc

# PowerShell 设置环境变量
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://cc.feiyingsteam.com/v1", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxx你的key", "User")

# 重启 PowerShell 后生效

4.3 配置文件方式

Codex 也支持通过配置文件设置：

# 创建配置文件 ~/.codex/config.json
mkdir -p ~/.codex
cat > ~/.codex/config.json << 'EOF'
{
    "apiKey": "sk-xxx你的key",
    "apiBase": "https://cc.feiyingsteam.com/v1",
    "model": "gpt-4o"
}
EOF

4.4 验证配置

# 启动 Codex CLI
codex

# 或者直接提问
codex "写一个快速排序算法"

4.5 常用命令

命令	说明
`codex`	启动交互模式
`codex "问题"`	直接提问
`codex --model gpt-4o`	指定模型
`codex --help`	查看帮助

💎 五、Gemini CLI 配置 Google

Gemini CLI 是 Google 推出的命令行 AI 助手，基于 Gemini 模型。

5.1 安装 Gemini CLI

# 使用 npm 安装
npm install -g @anthropic-ai/gemini-cli

# 或者使用官方安装脚本
curl -fsSL https://gemini.google.com/cli/install.sh | bash

# 验证安装
gemini --version

5.2 配置中转站

# Zsh 用户（macOS 默认）
echo 'export GEMINI_API_BASE="https://cc.feiyingsteam.com"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的key"' >> ~/.zshrc
source ~/.zshrc

# Bash 用户
echo 'export GEMINI_API_BASE="https://cc.feiyingsteam.com"' >> ~/.bashrc
echo 'export GEMINI_API_KEY="你的key"' >> ~/.bashrc
source ~/.bashrc

# PowerShell 设置环境变量
[Environment]::SetEnvironmentVariable("GEMINI_API_BASE", "https://cc.feiyingsteam.com", "User")
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的key", "User")

# 重启 PowerShell 后生效

5.3 配置文件方式

# 创建配置文件 ~/.gemini/config.json
mkdir -p ~/.gemini
cat > ~/.gemini/config.json << 'EOF'
{
    "apiKey": "你的key",
    "apiBase": "https://cc.feiyingsteam.com",
    "model": "gemini-2.0-flash"
}
EOF

5.4 验证配置

# 启动 Gemini CLI
gemini

# 直接提问
gemini "解释一下什么是递归"

5.5 支持的模型

模型 ID	说明
`gemini-2.0-flash`	快速响应，适合日常使用
`gemini-1.5-pro`	高级模型，复杂任务
`gemini-1.5-flash`	平衡速度和质量

🤖 六、Droid CLI 配置 Android

Droid CLI 是一个专注于 Android 开发的 AI 命令行助手。

6.1 安装 Droid CLI

# 使用 npm 安装
npm install -g droid-cli

# 验证安装
droid --version

6.2 配置中转站

# Zsh 用户（macOS 默认）
echo 'export DROID_API_BASE="https://cc.feiyingsteam.com"' >> ~/.zshrc
echo 'export DROID_API_KEY="sk-xxx你的key"' >> ~/.zshrc
source ~/.zshrc

# Bash 用户
echo 'export DROID_API_BASE="https://cc.feiyingsteam.com"' >> ~/.bashrc
echo 'export DROID_API_KEY="sk-xxx你的key"' >> ~/.bashrc
source ~/.bashrc

# PowerShell 设置环境变量
[Environment]::SetEnvironmentVariable("DROID_API_BASE", "https://cc.feiyingsteam.com", "User")
[Environment]::SetEnvironmentVariable("DROID_API_KEY", "sk-xxx你的key", "User")

# 重启 PowerShell 后生效

6.3 配置文件方式

# 创建配置文件 ~/.droid/config.json
mkdir -p ~/.droid
cat > ~/.droid/config.json << 'EOF'
{
    "apiKey": "sk-xxx你的key",
    "apiBase": "https://cc.feiyingsteam.com",
    "model": "gpt-4o",
    "provider": "openai"
}
EOF

6.4 验证配置

# 启动 Droid CLI
droid

# 在 Android 项目中使用
cd your-android-project
droid "帮我优化这个 RecyclerView 适配器"

6.5 常用命令

命令	说明
`droid`	启动交互模式
`droid "问题"`	直接提问
`droid init`	初始化项目配置
`droid analyze`	分析当前项目

🔧 七、安装常见报错解决

以下是各工具安装过程中可能遇到的错误及解决方案：

EACCES 权限被拒绝 ▼

错误示例：npm ERR! code EACCES

解决方案：

# 方案一：使用 sudo（macOS/Linux）
sudo npm install -g 包名

# 方案二：修改 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# 方案三：Windows 管理员权限
# 右键 PowerShell → 以管理员身份运行

ETIMEDOUT 网络连接超时 ▼

解决方案：使用国内镜像源

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 安装完成后改回官方源（可选）
npm config set registry https://registry.npmjs.org

EBADENGINE Node.js 版本不兼容 ▼

解决方案：升级 Node.js 到 18 或更高版本

请参考第二章：Node.js 安装指南

command not found 命令找不到 ▼

原因：npm 全局目录不在 PATH 中

# 查看 npm 全局路径
npm config get prefix

# macOS/Linux：添加到 PATH
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Windows：在环境变量中添加 npm 全局路径

Invalid API Key API Key 无效 ▼

排查步骤：

确认 Key 复制完整，没有多余空格
确认 Key 格式正确（通常以 sk- 开头）
检查 BASE_URL 是否正确设置
重启终端使环境变量生效
联系中转站客服确认 Key 状态

ECONNREFUSED 连接被拒绝 ▼

可能原因：代理设置问题

# 如果使用代理，设置 npm 代理
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

# 清除代理设置
npm config delete proxy
npm config delete https-proxy

git not found Git 未安装 ▼

错误示例：npm ERR! git not found 或 'git' 不是内部或外部命令

原因：Claude Code 等工具依赖 Git，需要先安装 Git

macOS 安装 Git：

# 方法一：使用 Xcode 命令行工具（推荐）
xcode-select --install

# 方法二：使用 Homebrew
brew install git

# 验证安装
git --version

Windows 安装 Git：

访问 https://git-scm.com/download/win
下载并运行安装程序
安装时保持默认选项，一路点击「Next」
重启 PowerShell 后验证：git --version

Linux 安装 Git：

# Ubuntu / Debian
sudo apt update && sudo apt install git -y

# CentOS / RHEL
sudo yum install git -y

# Arch Linux
sudo pacman -S git

# 验证安装
git --version

📝 八、VS Code / Cursor 配置

8.1 VS Code Claude 扩展

安装 Claude 扩展

在扩展商店搜索 Claude，安装 Anthropic 官方扩展

8.2 Cline 扩展配置（推荐）

配置步骤

在扩展商店搜索 Cline 并安装
点击左侧边栏的 Cline 图标
在设置中配置：
- API Provider: Anthropic
- Base URL: https://cc.feiyingsteam.com
- API Key: sk-xxx你的key

8.3 Continue 扩展配置

按 Cmd/Ctrl + Shift + P，输入 Continue: Open config.json

{
    "models": [
        {
            "title": "Claude Sonnet (飞鹰中转)",
            "provider": "anthropic",
            "model": "claude-sonnet-4-5-20250929",
            "apiBase": "https://cc.feiyingsteam.com",
            "apiKey": "sk-xxx你的key"
        },
        {
            "title": "GPT-4o (飞鹰中转)",
            "provider": "openai",
            "model": "gpt-4o",
            "apiBase": "https://cc.feiyingsteam.com/v1",
            "apiKey": "sk-xxx你的key"
        }
    ]
}

8.4 Cursor 配置

⚠️ 注意

Cursor 自带的 AI 功能使用 Cursor 自己的服务。但你可以在 Cursor 的终端中使用各种 CLI 工具。

在 Cursor 中打开终端（Ctrl + `），然后运行 claude、codex 等命令。

❓ 九、常见问题 FAQ

Q: 中转站和官方 API 有什么区别？ ▼

A: 功能完全一样，中转站作为代理转发请求。优势：

无需海外信用卡
支持国内支付
网络更稳定

Q: 如何切换不同的 AI 工具？ ▼

A: 每个工具使用不同的环境变量，可以同时配置多个工具。直接运行对应的命令即可切换：

claude - Claude Code
codex - Codex CLI
gemini - Gemini CLI
droid - Droid CLI

Q: 环境变量设置后不生效怎么办？ ▼

A: 请尝试：

重启终端窗口
执行 source ~/.zshrc 或 source ~/.bashrc
Windows 用户重启 PowerShell
如果还不行，重启电脑

Q: 如何升级这些 CLI 工具？ ▼

# 升级 Claude Code
npm update -g @anthropic-ai/claude-code

# 升级 Codex CLI
npm update -g @openai/codex

# 或者重新安装最新版
npm install -g 包名@latest

Q: 如何卸载这些工具？ ▼

# 卸载
npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g @openai/codex

# 删除配置文件
rm -rf ~/.claude ~/.codex ~/.gemini ~/.droid

📋 环境变量速查表

工具	BASE URL 变量	API KEY 变量	BASE URL 值
Claude	`ANTHROPIC_BASE_URL`	`ANTHROPIC_API_KEY`	`https://cc.feiyingsteam.com`
Codex	`OPENAI_BASE_URL`	`OPENAI_API_KEY`	`https://cc.feiyingsteam.com/v1`
Gemini	`GEMINI_API_BASE`	`GEMINI_API_KEY`	`https://cc.feiyingsteam.com`
Droid	`DROID_API_BASE`	`DROID_API_KEY`	`https://cc.feiyingsteam.com`