tmf use — 切换提供商

语法

tmf use <provider> [options]

描述

为所有已检测到的 AI 应用（或用 --app 指定某个应用）切换 LLM 提供商和模型。执行切换前会自动备份当前配置文件，以便后续通过 tmf rollback 还原。

应用会自动检测。如果某个应用的可执行文件不在 PATH 中，即使其配置目录存在（如之前卸载残留），也会被静默跳过。

选项

选项	描述
-a, --app <app>	目标应用：codex、claude-code（别名 claude、cc）、openclaw、opencode、hermes、pi
-k, --key <api-key>	新提供商的 API Key
-m, --model <model>	单个模型名称
--models <models...>	多模型设置（见下文）
--env <env...>	自定义环境变量（KEY=VALUE 格式）
--effort <level>	专注程度：low、medium、high、xhigh

模板匹配

tmf use <name> 优先查找已保存的同名模板。若匹配成功，直接应用模板配置，无需调用 Provider API。模板可通过 tmf save 或 tmf set --save-as 创建。

CLI 选项（--key、--model、--models、--env、--effort、--app）在运行时覆盖模板值。

模型分配（--models）

--models 支持两种格式，用于在 Claude Code 中为不同角色设置模型：

位置格式（opus → sonnet → haiku，先强后弱）：

tmf use deepseek --models deepseek-v4-pro[1m] deepseek-v4-pro deepseek-v4-flash

将设置：

• ANTHROPIC_DEFAULT_OPUS_MODEL = deepseek-v4-pro[1m]
• ANTHROPIC_DEFAULT_SONNET_MODEL = deepseek-v4-pro
• ANTHROPIC_DEFAULT_HAIKU_MODEL = deepseek-v4-flash
• ANTHROPIC_MODEL（主模型）= deepseek-v4-pro[1m]

键值格式（顺序自由）：

tmf use deepseek --models opus=deepseek-v4-pro[1m],sonnet=deepseek-v4-pro,haiku=deepseek-v4-flash

设置角色模型后，Claude Code 在 haiku/sonnet/opus 之间切换时自动路由到对应模型，无需每次重新运行 tmf use。

示例

# 将所有检测到的应用切换到 DeepSeek
tmf use deepseek

# 仅切换 Claude Code，使用键值格式分配角色模型
tmf use deepseek --app claude-code --models opus=deepseek-v4-pro[1m],sonnet=deepseek-v4-pro,haiku=deepseek-v4-flash

# 使用位置格式分配模型
tmf use deepseek --models deepseek-v4-pro[1m] deepseek-v4-pro deepseek-v4-flash

# 指定单个模型并设置自定义环境变量
tmf use siliconflow --model Qwen/Qwen2.5-7B-Instruct --env MAX_TOKENS=4096

# 设置专注程度
tmf use deepseek --effort max