介绍 ai-switch：在 Shell 中即时切换 AI 提供商环境

正文#

你是否也曾为此烦恼？#

随着 AI code CLI 的快速发展，开发者们常常需要在不同的 AI 模型之间切换，尤其是在使用像 Claude Code 这样的开发环境时。你可能正在为项目比较来自 DeepSeek、智谱 GLM、Kimi 和 Qwen 等不同提供商的模型效果。

每个提供商都需要自己的一套环境变量，比如 API Key 和 API Base URL。管理这些配置通常意味着：

• 在你的 ~/.bashrc 或 ~/.zshrc 文件中维护多个配置块。
• 在切换项目时，手动注释掉一个块，然后取消注释另一个块。
• 重新加载你的 shell (source ~/.bashrc) 来使更改生效。

这个过程不仅繁琐，而且容易出错。忘记切换环境可能会导致你的脚本调用错误的 API，或者更糟糕的是，因为找不到密钥而失败。

解决方案：ai-switch#

ai-switch 是一个轻量级的 Shell 工具，旨在彻底解决这个问题。它允许你创建独立的、可移植的环境配置文件，并用一个简单的命令在它们之间即时切换。

它的核心理念是：

• 告别手动编辑：不再需要反复修改你的 shell 启动文件。
• 保持整洁：每个 AI 提供商的配置都保存在一个独立的、只包含 export 语句的文件中。
• 自动继承：一旦你切换了环境，所有新打开的终端都会自动继承你当前的选择。

主要功能#

ai-switch 提供了一组简单直观的命令来管理你的 AI 环境配置文件：

• ai list: 列出所有可用的配置文件。
• ai current 或 ai status: 显示当前激活的配置文件。
• ai switch <profile> 或 ai checkout <profile>: 切换到指定的配置文件（如果安装了 fzf，还支持模糊搜索）。
• ai add <name>: 创建一个新的配置文件模板，并在你的默认编辑器中打开它。
• ai remove <profile>: 删除一个配置文件。
• ai edit <name>: 编辑一个现有的配置文件。
• ai doctor: 检查安装和配置是否正确。

所有的配置文件都存储在 $AI_PROFILES_DIR 目录下，默认为 ~/.ai-profiles。

如何使用：查看默认配置#

ai-switch 的一个核心亮点是它内置了针对主流国产大模型的默认配置模板，特别为 Claude Code 等开发环境作了适配。首次安装时，这些模板会自动复制到你的 ~/.ai-profiles 目录下。

有趣的是，这些配置巧妙地利用了环境变量，将不同厂商的 API 统一适配为 OpenAI 或 Anthropic 的接口规范。这意味着，你的客户端（如 Claude Code）无需任何修改，就可以通过切换环境来无缝调用不同的模型。

让我们看看这些默认配置的具体内容：

1. DeepSeek#

• 文件: ~/.ai-profiles/deepseek
• 内容:

  export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
  export ANTHROPIC_AUTH_TOKEN=your-deepseek-api-key
  export ANTHROPIC_MODEL=deepseek-chat
  export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat

• 说明: 此配置将 DeepSeek 的 API 适配为 Anthropic 的接口。你需要将 your-deepseek-api-key 替换为你的真实密钥。

2. 智谱 GLM#

• 文件: ~/.ai-profiles/glm
• 内容:

  export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
  export ANTHROPIC_API_KEY="your-glm-api-key"
  export ANTHROPIC_MODEL="glm-4.5"
  export ANTHROPIC_SMALL_FAST_MODEL="glm-4.5-air"

• 说明: 同样适配为 Anthropic 接口。

3. Kimi#

• 文件: ~/.ai-profiles/kimi
• 内容:

  export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
  export ANTHROPIC_API_KEY="your-kimi-api-key"
  export ANTHROPIC_MODEL="kimi-k2-turbo-preview"
  export ANTHROPIC_SMALL_FAST_MODEL="kimi-k2-turbo-preview"

• 说明: 适配为 Anthropic 接口。

4. Qwen#

• 文件: ~/.ai-profiles/qwen
• 内容:

  export OPENAI_API_KEY="your-qwen-api-key"
  export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
  export OPENAI_MODEL="qwen-max"
  export OPENAI_SMALL_FAST_MODEL="qwen-turbo"

切换环境#

配置好密钥后，切换环境就非常简单了：

# 切换到 DeepSeek
ai switch deepseek

# 检查当前环境，你的客户端现在会使用 Anthropic 接口调用 DeepSeek
ai current
# Output: deepseek

# 切换到通义千问
ai switch qwen

# 你的客户端现在会使用 OpenAI 接口调用通义千问
ai current
# Output: qwen

通过这种方式，ai-switch 极大地简化了在不同模型间切换的复杂性，让你能更专注于编码和模型评估。

安装#

安装 ai-switch 非常简单，只需要一个命令：

curl -fsSL https://raw.githubusercontent.com/Cactusinhand/ai-switch/main/install.sh | bash

然后重新加载你的 shell 即可开始使用：

source ~/.bashrc  # 或者 source ~/.zshrc

总结#

ai-switch 是一个“小而美”的工具，它解决了一个在多 AI 服务开发中非常具体但又普遍存在的痛点。通过将环境配置模块化并提供简单的切换机制，它极大地提高了开发效率，并减少了因环境错误导致的问题。

如果你也曾为管理多个 AI 环境而烦恼，不妨试试 ai-switch。

更多信息，请访问项目主页：https://github.com/Cactusinhand/ai-switch

最后，如果你不习惯使用 CLI 工具而喜欢带有界面的工具，cc-switch 是个不错的替代品。