乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > AI Code Switch 使用文档

AI Code Switch 使用文档

当前时间： 2026-04-22 12:43:56 更新时间： 2026-04-22 分类：软件教程 评论(0)

AI Code Switch 使用文档

AI编程工具模型接口管理与切换工具让你的 Claude Code、Codex 等工具不再局限于官方模型版本：v4.0.2 | 作者：tangshuang

    一、产品简介

    AI Code Switch（简称 aicodeswitch）是一款帮助开发者在本地管理 AI 编程工具接入大模型的工具。它可以让你的 Claude Code、Codex 等工具不再局限于官方模型，轻松切换到任意 AI 服务商的 API。

    作为国内开发者，我们常常需要切换不同的大模型 API 接口来源。无论是使用中转服务还是国产低价模型套餐，都面临 API 切换的繁琐问题。aicodeswitch 就是为解决这一痛点而诞生的工具。

    图1：AI Code Switch 架构示意图

    核心价值主张：

    • 一个面板管理所有 AI 服务商，无需频繁修改配置文件

    • 一键切换供应商，配置文件自动生效

    • API 数据格式转换，让不同标准的模型无缝对接

    • 数据完全本地，自主可控

    二、核心功能

    2.1 架构原理

    aicodeswitch 作为一个本地代理服务，插入到 AI 编程工具与大模型供应商之间。它拦截工具的 API 请求，根据配置的路由规则，将请求转发到不同的供应商，并对返回的数据进行格式转换。

    图2：路由分发原理示意图

    2.2 功能特点

    功能
    说明
    供应商管理
    统一管理多个 AI 服务商的 API 接口
    一键切换
    点击按钮即可切换不同的供应商
    API 转流
    支持 OpenAI、Anthropic、Gemini 数据格式转换
    按需代理
    根据请求类型分发到不同模型处理
    智能故障切换
    服务故障时自动切换备用服务
    日志与统计
    超精细的日志记录和用量统计
    Skills/MCP 管理
    一键安装和启用 Skills 与 MCP

    三、安装指南

    3.1 环境要求

    安装 aicodeswitch 之前，请确保你的电脑已经安装了以下环境：

    • Node.js 18+ 和 npm（安装 Claude Code 时一般已经安装）

    • 命令行工具（macOS/Linux Terminal、Windows CMD/PowerShell）

    3.2 安装命令

    打开终端，执行以下命令：

    图3：npm 官方安装页面

    npm install-g aicodeswitch

    如果你使用 macOS 或 Linux，可能需要使用 sudo 执行上述命令：

    sudo npm install-g aicodeswitch

    3.3 安装验证

    安装完成后，可以通过以下命令验证是否安装成功：

    aicos --version

    四、快速入门

    4.1 启动服务

    安装完成后，使用以下命令启动服务并打开管理界面：

    aicos ui

    图4：命令行启动 Web 管理界面

    该命令会自动启动服务并在浏览器中打开管理界面，默认地址为 http://127.0.0.1:4567。

    其他常用命令：

    命令
    说明
    aicos start
    启动后台服务
    aicos stop
    停止服务
    aicos ui
    启动服务并打开管理界面

    4.2 配置供应商

    供应商是指提供 AI 服务的上游服务商，可以是 OpenAI、Claude、DeepSeek、GLM 官方服务，也可以是其他中转服务商（这里使用的kimi)。

    配置步骤：

    1. 创建供应商 —— 在”供应商管理”中点击”添加供应商”，选择一键配置或手动配置

    2. 填写信息 —— 输入供应商名称、API Key、Base URL 等信息

    3. 选择源类型 —— 根据供应商的接口数据格式选择对应的源类型

    支持的源类型包括：

    • OpenAI（Responses API 标准）

    • OpenAI Chat（Chat Completions API 标准）

    • DeepSeek Chat（reasoning_content 标准）

    • Claude / Claude Chat

    • Gemini / Gemini Chat

    • kimi/kimi code

      ANTHROPIC_BASE_URL=https://api.kimi.com/coding/

      ANTHROPIC_API_KEY=sk-kimi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

       # 这里填在会员页面生成的 API Key

    4.3 路由管理

    路由是 aicodeswitch 的核心功能，负责将不同客户端工具的请求路由到不同的供应商 API 服务。

    当前支持的客户端工具包括：

    • Claude Code

    • Codex

    路由规则可以根据请求类型进行区分处理，例如：

    • 代码生成请求发往高性能编程模型

    • 图片识别请求发往支持多模态的模型

    • 深度思考请求发往强推理模型

    五、高级功能

    5.1 智能故障切换

    当同一请求类型配置多个规则时，系统会按排序优先使用第一个。如果某个服务报错（4xx/5xx）或请求超时，将自动切换到下一个可用规则，确保你可以正常使用 coding 工具。

    5.2 Skills 管理

    你可以在 aicodeswitch 中集中统一管理 Skills，把 Skills 分发给 Claude Code 和 Codex，随时启用和停用。另外，你可以基于自然语言搜索 Skills，一键安装。

    5.3 MCP 管理

    你可以在 aicodeswitch 中集中统一管理 MCP（Model Context Protocol），一键安装预设 MCP，一键启用到 Claude Code 和 Codex。通过 MCP 还可以实现图像理解功能。

    5.4 用量限制

    为避免费用超支，aicodeswitch 提供以下限制功能：

    • Tokens 超量限制：避免某个服务商的用量超过限制

    • 次数超量限制：次数到达一定量后自动切换其他服务商

    5.5 配置文件

    作为 CLI 工具，你可以在 ~/.aicodeswitch/ 目录下找到配置文件。里面有一个 aicodeswitch.conf 文件，可以进行以下配置：

    # aicodeswitch的服务IPHOST=127.0.0.1# aicodeswitch的服务端口PORT=4567# 如果提供AUTH，必须输入认证值才能进入界面# AUTH=your_secret_key

    六、常见问题

    Q1：如何切换供应商？

    在路由管理页面修改规则的目标供应商，或调整优先级即可。系统会自动重新配置客户端工具的配置文件，无需手动操作。

    Q2：如何查看失败的请求？

    在日志页面，筛选状态码不为 200 的记录。详细的错误信息包括错误类型、错误详情和发生时间。

    Q3：如何备份配置？

    在系统设置页面使用”导出配置”功能，然后将提供的数据保存到本地文件中。在其他电脑上可以通过”导入配置”还原。

    Q4：是否支持团队使用？

    支持。你可以设置自定义 API Key，通过 B/S 架构让 aicodeswitch 成为在线服务，提供给团队使用。设置 AUTH 参数后，需要输入认证值才能进入管理界面。

    Q5：特殊语法 [!] 是什么？

    在发送的提示词最前面添加 [!] 来直接切换为高智商模型服务，简单快捷。例如：[!] 请帮我优化这段代码的算法复杂度。

    GitHub 官方仓库：https://github.com/tangshuang/aicodeswitch