bsf.ai 文档

简体中文

English

简体中文

English

Appearance

Step 1: 确认环境 ​

前置条件

  1. 已安装 PyCharm 2024.3 或更高版本（社区版 / 专业版均可）
  2. 已安装 Node.js 18+（Claude Code 运行依赖）
  3. 已安装 Claude Code CLI：
bash
npm install -g @anthropic-ai/claude-code
  1. 已获取 bsf.ai 密钥 → 前往获取

Step 2: 安装 Claude Code 插件 ​

从 JetBrains 插件市场安装

  1. 打开 PyCharm，进入 Settings（Mac: Cmd+, / Windows: Ctrl+Alt+S）
  2. 左侧选择 Plugins → 点击 Marketplace 标签
  3. 搜索「Claude Code」
  4. 找到 Anthropic 官方发布的「Claude Code」插件，点击 Install
  5. 安装完成后点击 Restart IDE 重启 PyCharm

NOTE

该插件本质上是在 PyCharm 内嵌了一个终端来运行 Claude Code CLI，所以必须先安装好 CLI。

Step 3: 配置 bsf.ai 网关 ​

方法一：通过 Claude Code 配置文件（推荐）

编辑 ~/.claude/settings.json（Windows: C:\Users\你的用户名\.claude\settings.json）：

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

方法二：通过系统环境变量

macOS / Linux：

bash
echo 'export ANTHROPIC_BASE_URL="https://api.bsf.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的密钥"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.bsf.ai", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的密钥", "User")

设置后需要重启 PyCharm 使环境变量生效。

Step 4: 开始使用 ​

打开 Claude Code 面板

  1. 重启 PyCharm 后，底部工具栏会出现「Claude Code」标签
  2. 点击打开 Claude Code 终端面板
  3. 首次启动会自动运行 claude 命令并连接到 bsf.ai

常用操作

  • 对话: 直接在面板中输入问题或需求
  • 引用文件: 使用 @filename 引用项目中的文件
  • 清空上下文: 输入 /clear 开始新对话，减少 token 消耗
  • 查看帮助: 输入 /help 查看所有可用命令

常见问题 ​

问题：底部看不到 Claude Code 标签
  1. 确认插件已安装并启用：Settings → Plugins → Installed → 搜索 Claude Code
  2. 尝试通过菜单打开：View → Tool Windows → Claude Code
  3. 如果仍然没有，检查 PyCharm 版本是否 >= 2024.3
问题：提示 claude 命令未找到

确保 Claude Code CLI 已全局安装且在 PATH 中：

bash
which claude    # macOS/Linux
where claude    # Windows

如果未找到，重新安装：

bash
npm install -g @anthropic-ai/claude-code
问题：连接超时或报错
  1. 确认环境变量已正确设置（重启 PyCharm 后生效）
  2. 在 PyCharm 终端中验证：
bash
echo $ANTHROPIC_BASE_URL
# 应输出 https://api.bsf.ai
  1. 检查 API 密钥是否有效 → 控制台查看