快速开始

智能安装

交互式向导,按工具生成配置

智能安装向导会一步步问你:用哪个工具、Key 是多少、默认想用哪个模型,然后帮你把对应的环境变量和配置文件都写好。第一次接入,或同时挂多个工具时,用它最不容易漏。

打开向导

bash
npx aicoderbox init

向导会问你

  1. 1选工具 —— Claude Code / Codex CLI / Gemini CLI / OpenCode / Hermes,可多选。
  2. 2填 Key —— 粘贴 sk-acb- 开头的 API Key,向导会先探一次网关确认有效。
  3. 3选默认模型 —— 从可用列表里挑一个当默认,例如 claude-sonnet-5gpt-5.5
  4. 4写配置 —— 向导按你选的工具分别写入环境变量与配置文件。
  5. 5自测一次 —— 立即发一条测试消息,确认整条链路能通。

生成的配置长这样

json
// ~/.aicoderbox/config.json
{
  "base_url": "https://coder.aicoderbox.com",
  "api_key": "sk-acb-xxxx",
  "default_model": "claude-sonnet-5",
  "tools": ["claude-code", "codex"]
}

多工具共存

每个工具读各自的环境变量,向导会分别写入,互不打架。想换默认模型,一条命令搞定:

bash
aicoderbox use gpt-5.5
一把 Key 走天下: 所有工具共享同一把 Key 与同一个积分余额池,不用给每个工具单独充值,用量也统一在控制台「用量明细」里看得到。