7.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.
TypeScript
English · 简体中文
安装生成器
用法
npx freellmapi setup-claude # 接入 Claude Code
npx freellmapi setup-codex # 接入 Codex CLI
npx freellmapi setup-dsh # 接入 DeepSeek Harness
npx freellmapi setup-mimo # 接入 MiMo Code
npx freellmapi setup-atomcode # 接入 AtomCode
npx freellmapi --dry-run setup-claude # 预览而不写入
npx freellmapi setup-claude --model gpt-4o # 固定模型
每个生成器(cli/src/tools.ts:52-622)都会拉取实时目录、对照未过滤目录解析 --model(c942352)、对已有配置做带时间戳的备份、在不覆盖无关键的前提下合并,并以 0600 权限写入。
生成器一览
| 命令 | 目标文件 | 协议 | 备注 |
|---|---|---|---|
setup-claude |
~/.claude/settings.json |
Anthropic Messages | ANTHROPIC_BASE_URL/AUTH_TOKEN/MODEL、CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1、launch 零持久化启动器 |
setup-codex |
~/.codex/config.toml |
OpenAI Responses | [model_providers.freellmapi] wire_api=responses、launch-codex 启动器 |
setup-cline |
~/.config/Code/User/settings.json |
OpenAI Chat | Cline VS Code 扩展 |
setup-continue |
~/.continue/config.json |
OpenAI Chat | Continue 幽灵文本自动补全 |
setup-aider |
~/.aider.conf.yml |
OpenAI Chat | Aider 结对编程 |
setup-opencode |
~/.config/opencode/config.json |
OpenAI Chat | OpenCode 智能体 |
setup-goose |
~/.config/goose/config.yaml |
OpenAI Chat | Goose 智能体 |
setup-qwen |
~/.qwen/settings.json |
OpenAI/Gemini | Qwen Code,/v1 或原生 /v1beta |
setup-roo |
~/.config/roo/config.json |
OpenAI Chat | Roo Code |
setup-kilo |
~/.config/kilo/config.json |
OpenAI Chat | Kilo Code |
setup-crush |
~/.config/crush/config.json |
OpenAI Chat | Crush(charmbracelet) |
setup-dsh |
~/.dsh/config.json |
OpenAI Chat | DeepSeek Harness(#995) |
setup-mimo |
~/.config/mimocode/config.json |
OpenAI Chat | MiMo Code ~/.config/mimocode/config.json default_provider=freellmapi + [providers.freellmapi] type=openai base_url=/v1 api_key model context_window(#1003) |
setup-atomcode |
~/.atomcode/config.toml |
OpenAI Chat | AtomCode default_provider=freellmapi + [providers.freellmapi] TOML 保留其他提供方(#1025) |
setup-cursor |
仅指引 | OpenAI Chat | 手动 Cursor Settings → Models → Add Model(无文件) |
setup-generic |
仅指引 | OpenAI Chat | 任意 OpenAI 兼容客户端 |
零持久化启动器
npx freellmapi launch # 仅在 env 中注入 FREELLMAPI_API_KEY + model 并启动 `claude`
npx freellmapi launch-codex # 注入到 `codex --profile NAME`
这些命令不会写入配置文件;它们仅在子进程的环境变量中注入 FREELLMAPI_API_KEY/FREELLMAPI_MODEL。适用于临时或共享机器。
freellmapi doctor
npx freellmapi doctor
验证客户端请求是否到达本网关(检查已路由的 Authorization 头、目录、实时探针)。
通用参数
| 参数 | 作用 |
|---|---|
--dry-run |
预览变更而不写入;显示 diff |
--model <id> |
固定到指定模型(对照未过滤目录解析) |
--profile <name> |
命名配置档(Codex codex --profile NAME、Claude CLAUDE_CONFIG_DIR) |