BLACKBOX AI

BLACKBOX AI是什么？

BLACKBOX AI是一套面向开发者的AI编程平台，由Blackbox AI Technologies运营。它早期因代码搜索、代码自动补全和浏览器插件受到关注，现在已经扩展为覆盖Web、VS Code与其他IDE、终端CLI、远程Agent、App Builder、模型API和Agent API的完整开发工具。

用户既可以像使用聊天助手一样询问代码，也可以让Agent读取整个仓库、编辑多个文件、运行终端命令、执行测试并根据结果继续修复。平台还聚合OpenAI、Anthropic、Google、xAI及其他提供商的多种模型，让团队在一个账户和工作流中选择或比较模型。

核心功能

1. 代码库理解与问答

BLACKBOX AI可以分析项目目录、源文件、配置、依赖和提交历史，回答“这个模块如何工作”“数据从哪里进入”“某个错误可能在哪一层”等问题。它适合接手陌生项目、定位调用关系、生成文档和准备重构。

代码库较大时，Agent通常通过检索和摘要选择上下文，并不会在每次回答中完整读取所有文件。被忽略的配置、生成代码、子模块和运行环境可能改变结论，重要分析应结合搜索、测试与人工审查。

2. Agent式代码修改

在VS Code、Web或终端中，用户可以直接描述功能，让Agent创建项目、添加文件、修改现有代码、生成配置、补充测试、修复错误和撰写文档。与单纯返回代码片段不同，Agent能够在授权后把改动写入工作区，并继续读取命令输出自我修正。

执行能力越强，风险也越高。安装依赖、运行迁移、修改环境变量、删除文件、发布版本或访问生产资源前，必须检查命令和影响范围。

建议在独立分支、容器或测试环境中运行，并保持可恢复的版本控制状态。

3. 运行命令与测试闭环

Agent可以调用终端执行构建、测试、格式化、包安装和脚本，读取错误后继续修改。这种“编辑—运行—观察—修复”循环能处理比单轮代码生成更完整的任务，例如修复失败测试、升级依赖或建立新项目骨架。

自动化结果仍受测试覆盖率和环境限制。测试通过不代表安全、性能、兼容性和业务逻辑全部正确；

涉及数据库、云资源、密钥和外部接口时要限制权限，并在运行前检查脚本。

4. 多模型聊天与编程

BLACKBOX AI聚合多家模型，当前官网与插件会展示Claude、GPT、Gemini、Grok、MiniMax、Kimi、GLM和其他模型。具体型号变化很快，可用列表取决于方案、额度和发布节奏，目录不应把某个模型当作永久默认。

聚合平台方便比较速度、成本和代码质量，但BLACKBOX订阅并不等于获得各模型厂商的独立账号或原生API额度。上下文、工具调用、内容政策和输出速度也可能与模型原厂产品不同。

5. 多Agent并行执行

Pro Plus及以上方案提供Multi-Agent Execution，可让不同Agent或模型在独立Git分支上并行处理同一任务，再比较实现。CLI文档列出的可配置代理包括Blackbox、Claude、Codex、Gemini、Goose、OpenCode和Qwen等，部分外部代理需要单独配置对应密钥或环境。

并行方案会增加Token、时间和合并成本。多个Agent可能同时修改相同模块、采用不同依赖或产生不兼容架构，最终仍需要开发者审查差异、运行完整测试并决定合并哪一版。

6. BLACKBOX CLI

官方CLI在终端中提供对话、代码编辑、命令执行、Agent切换、技能管理、远程任务和多Agent命令，适合偏好命令行或需要在服务器环境工作的开发者。macOS、Linux和Windows均有安装方式，但Windows原生环境可用代理较少；

官方说明，要使用Codex、Gemini、Goose、OpenCode和Qwen等完整代理组合，Windows用户通常需要WSL，Claude相关流程还可能依赖Git Bash。

官方安装示例使用网络安装脚本。企业或安全敏感环境不应直接执行未知脚本，应先下载审查、验证来源与版本，并由软件分发流程统一安装。

7. VS Code Agent与MCP

官方VS Code扩展能够创建项目、补全代码、修复错误、运行命令和处理现有仓库，并支持MCP服务器连接外部工具、数据库、API和服务。安装后登录BLACKBOX账号即可开始，基础体验不要求单独输入API Key。

MCP会扩大Agent可访问的数据和操作范围。连接数据库、云服务、工单或内部API时应使用最小权限、测试账号和明确的允许工具列表，防止提示注入或误操作。

8. Voice Agent

VS Code Agent提供由ElevenLabs支持的语音模式，可用语音询问仓库、请求修改、调试和开发功能，并通过语音与文字接收结果。语音处理涉及第三方服务，敏感代码与内部名称不适合在开放环境中口述。

9. App Builder与Figma to Code

App Builder用于从自然语言需求生成应用原型或项目，Figma to Code则帮助把设计稿转换为前端实现。它们适合快速启动界面和验证想法，但生成结果仍需处理响应式布局、设计Token、可访问性、状态管理、后端安全和生产部署。

10. Remote Agent与GitHub任务

远程Agent可以在云端沙箱执行数据分析或代码任务。Agent API支持创建、查询、继续和取消任务，流式读取日志，管理沙箱文件，并连接GitHub仓库、分支和个人访问令牌。

涉及GitHub的任务需要显式连接账号。

不要向Agent提供权限过大的个人访问令牌。应创建最小范围、可撤销、短期令牌，并限制仓库和分支；

远程任务完成后检查提交、日志、依赖和残留密钥。

模型API与Agent API

BLACKBOX AI提供OpenAI格式兼容的模型API。开发者可以继续使用常见OpenAI SDK，只需更换基础地址、模型ID和密钥。

接口支持流式输出、工具调用、多轮消息，并提供聊天、图片和视频等不同模型，费用按具体模型和输入、输出Token计算。

模型价格页以每100万Token列出输入和输出单价，模型数量和价格动态变化，调用前应通过实时模型列表查询。订阅中标注的模型Credits与API用量、免费Agent请求之间可能存在不同计费规则，不能把月费直接理解为无限Token。

Agent API用于创建真正会操作沙箱或代码仓库的任务，和普通Chat Completion不同。获取Agent API Key需要相应订阅，GitHub任务还要配置访问令牌。

企业客户使用独立端点，并可获得更强的数据与部署控制。

免费版与订阅价格

BLACKBOX AI提供免费开始使用的基础功能，具体免费模型、请求频率和Agent限制会随活动与负载调整。现行官网月付方案如下：

官网年付切换标注约20%优惠，并可能提供首月折扣。页面不同区块对Credits和“Unlimited Agent Requests”的措辞可能随促销、免费模型与方案更新，购买前应查看结算页中的实际金额、模型范围、自动充值和公平使用限制。

Credits用于付费模型，不同模型消耗不同；“免费Agent请求”通常与指定免费模型或平台规则相关，不等于所有Claude、GPT、Gemini任务无限使用。

Pro Plus和Pro Max的Auto-Refill应在购买前确认是否默认开启以及达到何种条件会继续扣费。

企业安全与本地部署

Pro Plus及以上标注端到端聊天加密，企业方案还提供训练退出、SAML SSO、高级安全控制、自定义SLA和本地部署。官网称本地部署可在客户基础设施中运行并保持数据主权，具体组件、模型、网络依赖、日志和运维责任需要在企业合同中确认。

现行隐私政策写明，Pro版本启用零数据保留，代码不会由BLACKBOX或第三方存储或用于训练；而最新价格页把E2E加密明确列在Pro Plus及以上。

由于隐私文档与套餐结构的更新时间不同，处理机密代码前应要求官方以当前合同、数据处理协议和方案页面确认真实的数据保留与训练政策。

支持平台

BLACKBOX AI覆盖Web应用、VS Code扩展、35+ IDE集成、终端CLI、桌面与移动入口、Slack、Figma、模型API和Agent API。不同入口的模型、Agent工具、额度和更新速度并不完全一致。

VS Code适合日常本地开发，CLI适合终端和自动化，Web适合快速聊天与远程任务，API用于产品集成。团队应选择最少必要入口，统一账号、密钥、扩展权限和版本管理。

开源状态与GitHub说明

BLACKBOX AI平台、云端Agent、模型网关、IDE服务和商业API是专有产品，不是可完整自行部署的开源系统。网上曾有资料引用BLACKBOX CLI的GitHub仓库，但该地址当前无法作为稳定可核验的官方公开仓库，因此不能据此把平台标为开源。

GitHub上大量名为blackbox、blackbox-cli或Pi等仓库属于数据库备份、第三方客户端或其他工具，与BLACKBOX AI Technologies无关。判断官方项目时应核对官网文档链接、组织身份、软件包发布者和许可证。

BLACKBOX AI使用教程

完成一次基础任务

1. 明确要在BLACKBOX AI中完成的代码任务、仓库范围和验收标准；
2. 连接或导入测试项目，并先备份当前分支；
3. 先使用代码库理解与问答生成计划，再确认将修改的文件；
4. 使用Agent式代码修改执行小范围改动；
5. 运行测试、静态检查和构建，不直接接受未验证代码；
6. 人工检查权限、密钥、依赖与异常处理后再合并；

建立可复用的专业工作流

1. 选取一个低风险真实项目作为模板；
2. 固定代码库理解与问答、Agent式代码修改和运行命令与测试闭环的使用顺序；
3. 记录环境、模型、提示和失败条件；
4. 为写入、部署和删除动作设置人工审批；
5. 比较速度、成本、测试通过率和返工量；
6. 验证稳定后再扩展到团队或生产环境；

适合哪些用户？

• 需要在VS Code中完成仓库问答、代码修改和测试的开发者；
• 偏好CLI并希望切换多种编程Agent的高级用户；
• 需要从需求快速创建原型、应用或前端页面的产品团队；
• 希望比较Claude、GPT、Gemini等多模型代码结果的团队；
• 需要把模型或远程编码Agent接入内部系统的开发者；
• 要求SSO、集中账单、数据控制或本地部署的企业。

产品优势

• 从补全扩展到IDE、CLI、远程Agent和API的完整工具链；
• 能编辑文件、运行命令、读取测试结果并继续修复；
• 聚合大量模型，方便在同一平台选择和比较；
• 支持多Agent并行分支和结果对比；
• 提供MCP、Slack、Figma和GitHub连接；
• API兼容OpenAI格式，迁移现有SDK较方便；
• 企业可选SSO、高级安全控制和本地部署。

使用限制与安全建议

• AI生成代码可能包含安全漏洞、过期库、许可证冲突、错误API和未经验证的依赖；
• 所有改动都应经过代码审查、静态分析、测试和依赖扫描；
• 认证、支付、权限、加密和数据迁移尤其不能直接接受；
• Agent会执行命令并可能访问整个工作区；
• 不要在包含生产密钥的目录直接试用，使用独立分支或副本，限制Shell与MCP权限，检查每个高影响动作；
• 数据库迁移和部署必须先在测试环境演练；
• 多模型聚合意味着代码和提示可能经过BLACKBOX及所选模型提供商；
• 使用公司代码前应核对方案的数据保留、训练退出、跨境处理和第三方子处理商，不能只依赖营销页上的“加密”字样；
• 远程Agent和GitHub连接会扩大供应链风险；
• 令牌应限制到必要仓库，禁止把长期管理员Token放入提示、配置文件或聊天记录，任务完成后及时撤销；

常见问题

BLACKBOX AI可以免费用吗？

可以免费开始使用基础功能，但免费模型、Agent请求和频率有动态限制。专业模型、多Agent、App Builder和团队能力需要付费方案。

BLACKBOX AI能直接修改代码吗？

可以。VS Code、CLI和Agent可读取仓库、修改文件、运行命令与测试。

执行前应使用版本控制并检查权限。

BLACKBOX AI多少钱？

当前月付Pro 10美元、Pro Plus 20美元、Pro Max 40美元，Enterprise询价；年付页面标注约20%优惠。

模型Credits和Agent权益以结算页为准。

支持哪些IDE？

官网称Coding Agent覆盖35种以上IDE、Web和终端，VS Code是文档最完整的入口。特定编辑器的功能完整度应查看当前集成页面。

有API吗？

有。提供OpenAI格式兼容的多模型API和可创建、监控远程任务的Agent API，分别按模型Token与相应方案计费。

支持MCP吗？

支持。VS Code Agent可连接MCP服务器访问外部工具和服务，使用时应限制权限并防范提示注入。

可以私有化部署吗？

企业方案提供本地部署选项，具体模型、组件、费用和数据边界需要联系销售确认。

BLACKBOX AI开源吗？

完整平台不开源。不要因为发现同名GitHub仓库或第三方CLI就把商业Agent、API和模型网关标为开源。