插件与 CLI 配置 - Bee Agents 文档

环境准备

在开始配置 AI 工具之前，请确保已安装 Node.js 18+ 环境。

检查 Node.js 版本：

Terminal

Bash

node --version
# 预期输出: v18.x.x 或更高

安装 Node.js：

Terminal

Bash

# 使用 Homebrew 安装
brew install node@22

# 或使用 nvm
nvm install 22
nvm use 22

PowerShell

# 使用 winget 安装
winget install OpenJS.NodeJS.LTS

# 或下载安装包
# https://nodejs.org/

Terminal

Bash

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 或使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22

Claude Code

Anthropic 官方 AI 编程命令行工具，支持代码生成、重构、调试等功能。

1. 安装 Claude Code：

Terminal

Bash

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

2. 配置方式 A：环境变量（推荐）

~/.zshrc 或 ~/.bashrc

Bash

# 添加到 shell 配置文件
export ANTHROPIC_BASE_URL="https://api.beeagents.org"
export ANTHROPIC_API_KEY="sk-你的令牌"

# 使配置生效
source ~/.zshrc

PowerShell (管理员)

PowerShell

# 设置系统环境变量
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.beeagents.org", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的令牌", "User")

# 重启终端使配置生效

2. 配置方式 B：配置文件

~/.claude/settings.json

JSON

{
  "apiBaseUrl": "https://api.beeagents.org",
  "apiKey": "sk-你的令牌"
}

3. 验证配置：

Terminal

Bash

claude --version
claude "你好，请自我介绍一下"

✓

预期结果：Claude Code 正常响应，说明配置成功。

遇到问题？

Q: 提示 "Authentication failed"？

A: 请检查令牌是否正确，确保令牌分组为 claude。

Q: 提示 "Connection refused"？

A: 请检查网络连接，确认可以访问 api.beeagents.org。

CodeX (OpenAI)

OpenAI 官方 AI 编程命令行工具，支持 GPT-4o 等模型。

1. 安装 CodeX：

Terminal

Bash

npm install -g @openai/codex

2. 配置环境变量：

~/.zshrc 或 ~/.bashrc

Bash

export OPENAI_BASE_URL="https://api.beeagents.org/v1"
export OPENAI_API_KEY="sk-你的令牌"

# 使配置生效
source ~/.zshrc

3. 验证配置：

Terminal

Bash

codex --version
codex "创建一个简单的 Hello World 程序"

✓

预期结果：CodeX 正常响应，说明配置成功。注意使用 openai 分组的令牌。

Gemini CLI

Google 官方 AI 编程命令行工具，支持 Gemini 1.5 Pro 等模型。

1. 安装 Gemini CLI：

Terminal

Bash

npm install -g @anthropic-ai/gemini-cli

2. 配置环境变量：

~/.zshrc 或 ~/.bashrc

Bash

export GEMINI_API_KEY="sk-你的令牌"
export GOOGLE_AI_STUDIO_BASE_URL="https://api.beeagents.org"

# 使配置生效
source ~/.zshrc

3. 验证配置：

Terminal

Bash

gemini --version
gemini "请解释一下 JavaScript 的闭包"

✓

预期结果：Gemini CLI 正常响应。注意使用 gemini 分组的令牌。