跨平台 AI Agent 模型切换工具，支持自动切换各种 AI Agent 工具的后台模型。
- 🔧 跨平台支持: Windows、Linux、macOS
- 🤖 多 Agent 支持: Claude Code、Kimi CLI、Gemini CLI、OpenClaw
- 🧠 多模型后端: 支持 14+ 种模型提供商
- 🔍 自动检测: 自动发现已安装的 Agent Tools
- 📝 自动配置: 自动修改配置文件，无需手动编辑
- 💾 配置备份: 自动备份原配置，安全可恢复
- 🎨 交互式界面: 友好的命令行交互体验
- 🚀 批量配置: 同时配置多个 Agent
| Agent Tool | 配置文件路径 | 说明 |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
Anthropic Claude Code CLI |
| Kimi CLI | ~/.kimi/config.json |
Moonshot Kimi CLI |
| Gemini CLI | ~/.gemini/settings.json |
Google Gemini CLI |
| OpenClaw | ~/.openclaw/openclaw.json |
OpenClaw AI 助手 |
| 提供商 | API 地址 |
|---|---|
| Ollama | http://localhost:11434/v1 |
| LM Studio | http://localhost:1234/v1 |
| LocalAI | http://localhost:8080/v1 |
| 提供商 | API 地址 |
|---|---|
| GLM (智谱 AI) | https://open.bigmodel.cn/api/paas/v4/ |
| Qwen (通义千问) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Kimi (Moonshot) | https://api.moonshot.cn/v1 |
| MiniMax | https://api.minimax.chat/v1 |
| Tencent (混元) | https://hunyuan.tencentcloudapi.com/v1 |
| Baichuan (百川) | https://api.baichuan-ai.com/v1 |
| DeepSeek | https://api.deepseek.com/v1 |
| Baidu (文心) | https://qianfan.baidubce.com/v2 |
| 提供商 | API 地址 |
|---|---|
| Google (Gemini) | https://generativelanguage.googleapis.com/v1beta |
| OpenAI | https://api.openai.com/v1 |
| Custom | 自定义 OpenAI 兼容接口 |
pip install ai-agent-model-switcherpipx install ai-agent-model-switchergit clone https://github.com/yourusername/ai-agent-model-switcher.git
cd ai-agent-model-switcher
pip install -e .安装完成后，可以使用以下命令：
model-switcher- 主命令ams- 短命令别名ai-agent-switch- 备用命令
model-switcher交互式向导会引导你：
- 选择操作模式（单独配置某个 Agent 或批量配置所有 Agent）
- 选择模型提供商
- 选择具体模型
- 输入 API Key
- 确认并应用配置
# Claude Code 使用 DeepSeek
model-switcher -a claude -p deepseek -m deepseek-chat -k YOUR_API_KEY
# Claude Code 使用 GLM
model-switcher -a claude -p glm -m glm-4 -k YOUR_API_KEY
# Claude Code 使用 Qwen
model-switcher -a claude -p qwen -m qwen-max -k YOUR_API_KEY
# Claude Code 使用 Kimi
model-switcher -a claude -p kimi -m kimi-k2 -k YOUR_API_KEY
# Gemini CLI 使用 Google Gemini
model-switcher -a gemini -p google -m gemini-2.5-flash -k YOUR_API_KEY
# OpenClaw 使用本地 Ollama
model-switcher -a openclaw -p ollama -m llama3.2model-switcher --list用法: model-switcher [选项]
选项:
-h, --help 显示帮助信息
-v, --version 显示版本号
-l, --list 列出所有配置和可用选项
-a, --agent 指定 Agent Tool (claude, kimi, gemini, openclaw)
-p, --provider 指定模型提供商
-m, --model 指定模型 ID
-k, --api-key 指定 API Key
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your-api-key",
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/v1",
"API_TIMEOUT_MS": "300000"
},
"model": "kimi2.5"
}{
"api_key": "your-api-key",
"base_url": "https://open.bigmodel.cn/api/paas/v4/",
"model": "glm-4"
}{
"defaultModel": "gemini-2.5-flash",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}{
"agent": {
"model": "anthropic/claude-opus-4-5",
"apiKey": "your-api-key"
},
"models": {
"openai/deepseek-chat": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "your-api-key"
}
}
}- glm-4, glm-4-plus, glm-4-flash, glm-4v, glm-4.5, glm-4.7
- qwen-max, qwen-plus, qwen-turbo, qwen-coder-plus, qwen-coder-turbo
- kimi-k2, kimi2.5, kimi2.5-think, kimi2
- deepseek-chat, deepseek-reasoner, deepseek-coder
- gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash, gemini-2.0-pro
- gemini-1.5-flash, gemini-1.5-pro
- gpt-4o, gpt-4o-mini, o1, o3-mini, gpt-4-turbo
- llama3.2, llama3.1, llama3, qwen2.5, mistral, mixtral
- codellama, deepseek-coder, phi4, phi3, gemma2
A: 确保 Python 的 Scripts/bin 目录在 PATH 环境变量中。如果使用 pipx 安装，pipx 会自动处理。
A: 工具会在修改前自动备份原配置（文件名带 .backup 后缀），可以手动恢复。
A: 支持，选择 "Custom" 提供商可以输入自定义的 OpenAI 兼容接口地址。
- 支持更多 Agent Tools (Aider, Continue, Cursor 等)
- 支持自定义配置文件路径
- 支持配置导入/导出
- GUI 图形界面
- API Key 加密存储
欢迎提交 Issue 和 Pull Request！
MIT License