CLIProxyAPI 配置怎么调模型映射、多账号轮换与安全控制一次讲清【免费下载链接】CLIProxyAPIWrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini Series, GPT Series, Grok Series, Claude model through API项目地址: https://gitcode.com/gh_mirrors/cl/CLIProxyAPICLIProxyAPI 把 Codex、Claude Code、Antigravity 等本地 CLI 凭证包装成兼容 OpenAI/Gemini/Claude 的 API 服务本文讲它的高级配置要点模型映射、多账号轮换、安全控制、渠道接入与重试调优。所有键名以 config.example.yaml 为准。把请求路由到可用模型最常见的问题是客户端请求的模型名在本地任何渠道都不存在请求直接失败。有两种改法。给模型加客户端可见的名字oauth-model-alias按渠道给模型改名模型列表和请求路由同时生效fork: true表示保留原名、额外多挂一个别名。oauth-model-alias: gemini-cli: - name: gemini-2.5-pro alias: g25p fork: true codex: - name: gpt-5 alias: g5配完之后 gemini-cli 渠道可以用g25p请求codex 渠道用g5原名仍在列表里。给 Amp 渠道设兜底Amp CLI 请求了本地没有的模型时用ampcode的model-mappings把它指向一个相近模型。ampcode: model-mappings: - from: claude-haiku-4-5-20251001 to: gemini-2.5-flash效果Amp 再来这个模型的请求会被代理转投目标模型客户端不用改。让多账号稳定跑量同一渠道登录了多个账号时用哪个、额度撞顶后怎么办由两块配置控制。挑选轮换策略routing: strategy: fill-first默认round-robin在各账号间均摊fill-first先把第一个账号用尽再轮下一个适合优先烧完单个账号额度的场景。需要把同一会话固定在同一个账号上时再开启session-affinity。配额撞顶时自动切换quota-exceeded: switch-project: true switch-preview-model: true antigravity-credits: true效果某个账号配额用完会自动换项目或预览模型免费额度全部耗尽时Claude 模型还能回落到 credits 兜底。锁住管理入口管理 API 能在线改配置能力越大越不能裸奔。收紧远程管理remote-management: allow-remote: false secret-key: mgmt-2026 disable-control-panel: trueallow-remote: false表示只有本机可以碰管理入口secret-key是所有管理请求必带的密钥而把它留空的效果是完全禁用管理 API。签发 API 密钥配合host把服务面也锁起来host: 127.0.0.1 api-keys: - key-for-codex-client - key-for-internal-tools效果客户端必须携带其中一个 key 才能调 API不同 key 发给不同客户端出问题好定位是谁在用。接入第三方渠道并单独调参前面讲的是 OAuth 渠道这里补两类付费密钥接入方式。登记 Gemini 密钥gemini-api-key: - api-key: AIzaSy...01 prefix: beta excluded-models: - gemini-3-*prefix: beta表示请求名必须带beta/前缀才命中这条密钥excluded-models支持通配符把不想走这条密钥的模型挡在外面。对接 OpenAI 兼容上游OpenRouter 之类的服务按 OpenAI 兼容渠道接入openai-compatibility: - name: openrouter base-url: https://openrouter.ai/api/v1 api-key-entries: - api-key: sk-or-v1-...效果该上游的模型进入合并后的模型列表api-key-entries里可以登记多条 key 轮换使用。打开用量观测与自动重试启用用量统计usage-statistics-enabled: true logging-to-file: true开启后管理 API 能读到聚合用量logging-to-file让日志落到滚动文件而不是跟着进程一起丢。调整重试与冷却request-retry: 5 max-retry-credentials: 2 max-retry-interval: 20request-retry针对 403/408/5xx 这类响应重试max-retry-credentials限制一次失败最多换几个凭证避免一个坏请求把全部账号轮一遍max-retry-interval是有冷却的凭证最多等多久。常见坑remote-management.secret-key留空不是免密而是整个管理 API 直接返回 404要用面板就别留空oauth-model-alias只作用于 OAuth 渠道gemini-api-key、claude-api-key这类密钥渠道不吃别名跨渠道重名别名还可能让路由变模糊routing.strategy设成fill-first会优先吃第一个账号想均匀分摊就用默认的round-robinampcode.model-mappings只对 Amp 渠道生效客户端照旧请求原模型名改的是代理侧的转发目标【免费下载链接】CLIProxyAPIWrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini Series, GPT Series, Grok Series, Claude model through API项目地址: https://gitcode.com/gh_mirrors/cl/CLIProxyAPI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考