FreeLLMAPI CLI完全手册15个setup命令与launch零持久化启动器【免费下载链接】freellmapi7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.项目地址: https://gitcode.com/GitHub_Trending/fr/freellmapiFreeLLMAPI 是一个把 34 家免费 LLM 提供商、635 个免费模型端点聚合到单一/v1端点的本地网关自带智能路由、自动故障切换与加密密钥管理。它的配套 CLInpx freellmapi能把 Claude Code、Codex、Aider 等 15 种编码智能体一键接入网关读取服务器实时模型目录、生成对应配置文件还提供launch零持久化启动器——凭据只注入子进程内存全程不落盘。 快速上手三步接入第一个编码智能体前提Node.js ≥ 20.18且 FreeLLMAPI 网关已在运行安装见 docs/install.md。第 1 步获取统一 API 密钥。在仪表盘的 Keys 页面复制你的freellmapi-…统一密钥这是所有客户端唯一需要的凭据桌面版用户也可以直接从托盘弹窗获取第 2 步运行 setup 命令。以 Claude Code 为例npx freellmapi setup-claude --url http://localhost:3001 --api-key 你的统一密钥第 3 步直接启动工具即可。CLI 已自动写入正确的 base URL、模型 ID 与上下文窗口无需再手动改任何配置。不想每次输参数设置环境变量即可被 CLI 自动识别export FREELLMAPI_URLhttp://localhost:3001 export FREELLMAPI_API_KEY你的统一密钥 建议先加--dry-run预览将要写入的差异确认无误后再正式执行。 15 个 setup 命令完整清单npx freellmapi list可随时打印完整清单。每个命令都会拉取网关实时目录模型 ID、上下文窗口来生成配置而不是写死一个模型名setup 命令目标工具写入位置setup-claudeClaude Code~/.claude/settings.jsonsetup-codexCodex CLI~/.codex/config.tomlsetup-claude/launchClaude Code零持久化不落盘仅注入环境变量setup-codex/launch-codexCodex零持久化不落盘仅注入参数与环境setup-clineCline~/.cline/data/settings/providers.jsonsetup-continueContinue~/.continue/config.yamlsetup-aiderAider~/.aider.conf.ymlsetup-opencodeOpenCode~/.config/opencode/opencode.jsonsetup-gooseGoose~/.config/goose/provider configsetup-qwenQwen Code~/.qwen/settings .envsetup-rooRoo Code~/.roo/freellmapi.jsonsetup-kiloKilo Code~/.config/kilo/kilo.jsoncsetup-crushCrush~/.config/crush/crush.jsonsetup-dshDeepSeek Harness~/.dsh/settings.yaml.envsetup-mimoMiMo Code~/.config/mimocode/config.jsonsetup-cursorCursor不写文件打印隧道覆盖配置指南setup-generic任意 OpenAI 兼容客户端不写文件打印环境变量与 curl 示例完整实现见 cli/src/tools.ts命令说明见 cli/README.md。⚙️ 常用参数与命名配置参数作用--url URL网关地址默认http://localhost:3000--api-key KEY统一 API 密钥也可用FREELLMAPI_API_KEY环境变量--profile NAME生成命名配置如 Claude/Codex 的多套 profile 并存--model ID固定某个模型而不是用默认的auto智能路由--dry-run只打印差异不写入任何文件例如为一台新机器单独建一套 Claude 配置npx freellmapi setup-claude --profile work --model auto命名 profile 会写入~/.claude/profiles/name/用CLAUDE_CONFIG_DIR指向它即可切换互不干扰。 launch零持久化启动器的原理launch和launch-codex与 setup 系列最大的区别是凭据从不会写到磁盘上。npx freellmapi launch # 启动 Claude Code npx freellmapi launch-codex # 启动 Codex CLI工作原理见 cli/src/index.tsCLI 先向网关/v1/models拉取实时目录选定模型不指定时默认挑一个具体可用模型让本次会话的模型可见、可复现把ANTHROPIC_AUTH_TOKEN、base URL、模型 ID 等写进子进程的环境变量然后以继承 stdio 的方式启动claude/codex进程退出后凭据随之消失你的 shell 环境、配置文件里什么都不会留下。同时它会主动清除环境中的真实ANTHROPIC_API_KEY防止你自己的 Anthropic 密钥被误发给网关。对安全敏感的共享机器场景非常合适。️ 安全设计合并而非覆盖随时可回滚所有 setup 生成器都是非破坏性的实现见 cli/src/config-files.ts结构化合并只改动自己负责的字段保留你已有的其他 provider、注释和键序时间戳备份写入已存在的文件前先创建一份带时间戳的备份--dry-run差异预览先看 diff 再落盘敏感文件权限包含密钥的文件按敏感文件处理。换句话说你可以放心反复执行 setup 命令它幂等且不覆盖。 doctor一键诊断流量到底走没走网关最隐蔽的故障是你改了配置但工具实际请求根本没到达网关比如某个环境变量优先级更高把 base URL 顶掉了。doctor专门诊断这个问题npx freellmapi doctor # 默认检查 claude 和 codex npx freellmapi doctor --timeout 10000它会按每个工具自己的解析规则还原实际生效的 URL再探测网关/livez端点给出明确裁决routed已正确路由、degraded网关自身不健康、elsewhere指向了别的服务、shadowed被更高优先级配置掩盖、unreachable连不通。裁决逻辑见 cli/src/doctor.ts。退出码非 0 即有异常可直接用在脚本里做前置检查。 延伸资料CLI 命令与参数速查cli/README.md各智能体详细接入指南含 Cursor 隧道、Ollama 兼容、MCP 服务器docs/clients.md网关安装与部署Docker / 桌面版 / systemddocs/install.md免费额度全景34 家提供商约 74 亿 tokens/月的免费推理容量详见 README.md⚡ 小贴士auto是网关的虚拟模型由路由器按速度/能力/可靠度实时挑选最优上游。给长期配置默认写auto给一次性launch会话固定具体模型两者搭配使用体验最佳。【免费下载链接】freellmapi7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.项目地址: https://gitcode.com/GitHub_Trending/fr/freellmapi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考