bsf.ai 文档

简体中文

English

简体中文

English

Appearance

Step 1: 安装 Node.js 环境 ​

方法一：使用 Homebrew 安装（推荐）

bash
brew install node

如果未安装 Homebrew，可以先安装它：

bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方法二：官网下载

  1. 访问 https://nodejs.org
  2. 下载 LTS 版本的 .pkg 文件并安装

TIP

验证安装是否成功

bash
node --version
npm --version

Step 2: 安装 Claude Code ​

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

TIP

验证 Claude Code 安装

bash
claude --version

Step 3: 设置环境变量 ​

确定你的 Shell 类型

bash
echo $SHELL

macOS Catalina 及以后默认使用 zsh。

方法一：临时设置（当前会话）

bash
export ANTHROPIC_BASE_URL="https://api.bsf.ai"
export ANTHROPIC_AUTH_TOKEN="your_api_key"

方法二：zsh 永久设置（推荐）

bash
echo '' >> ~/.zshrc
echo '# API config' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.zshrc
source ~/.zshrc

方法三：bash 永久设置

bash
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your_api_key"' >> ~/.bash_profile
source ~/.bash_profile

方法四： 配置文件 （推荐）

修改配置文件 vim ~/.claude/settings.json

json
{
"env": {
   "ANTHROPIC_AUTH_TOKEN": "替换为您的API Key",
   "ANTHROPIC_BASE_URL": "https://api.bsf.ai",
   "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
 },
 "permissions": {
   "allow": [],
   "deny": []
 }
}

TIP

验证环境变量设置

bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

Step 4: 开始使用 ​

启动 Claude Code

bash
claude

在特定项目中使用

bash
cd ~/Projects/my-project
claude

常见问题 ​

问题：安全性阻止运行
  1. 打开「系统偏好设置」>「隐私与安全性」
  2. 找到被阻止的应用，点击「仍要打开」
问题：npm 权限错误 (EACCES)

遇到 EACCES 错误时，修复 npm 权限：

bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code