在 CC-Switch 中使用 APIMart

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

简介

​

准备工作

1. 已安装命令行工具 至少安装一个受支持的 CLI 工具，如 Claude Code 或 Codex CLI
2. 已获取 APIMart API 密钥 登录 APIMart 控制台 获取您的 API 密钥（以 sk- 开头）

​

第一步：安装 CC-Switch

brew tap farion1231/ccswitch
brew install --cask cc-switch

​

第二步：添加 APIMart 供应商

• 为 Claude Code 配置
• 为 Codex 配置

1. 切换到 Claude Code 分组在主界面顶部选择 Claude Code。2. 打开添加供应商面板点击主界面右上角的 + 按钮。3. 填写供应商信息在表单中填写以下内容：

字段	填写内容	说明
名称	APIMart	自定义标识，便于识别
端点地址	https://api.apimart.ai	APIMart 的 API 地址
API Key	sk-xxxxxxxxxxxx	您的 APIMart API 密钥
API 格式	Anthropic Messages	保持默认的 Anthropic 原生格式

4. 保存配置点击 添加 按钮保存，APIMart 会出现在供应商列表中。

1. 切换到 Codex 分组在主界面顶部选择 Codex。2. 打开添加供应商面板点击主界面右上角的 + 按钮。3. 填写供应商信息Codex 供应商通过两个配置块完成设置：在 auth.json 配置块中填入密钥：

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

在 config.toml 配置块中填入供应商配置：

model = "gpt-5.5"
model_provider = "apimart"

[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true

4. 保存配置填写完成后为供应商命名（如 APIMart），点击 添加 按钮保存。CC-Switch 会自动校验 JSON 与 TOML 格式。

​

第三步：切换供应商

​

在主界面切换

1. 在供应商列表中选中 APIMart
2. 点击 启用（或 使用）按钮
3. 看到 “切换成功” 提示即表示完成

​

通过系统托盘快速切换

1. 点击系统托盘中的 CC-Switch 图标
2. 在菜单中直接点击目标供应商名称，立即生效

​

支持的模型

​

常见问题

​

Q1: 切换供应商后没有生效？

• Claude Code：支持热切换，请开启一个新的会话；如仍未生效，重启 Claude Code
• Codex：切换后需要重新启动终端或 Codex

​

Q2: 提示 API 密钥无效？

1. 确认 API Key 以 sk- 开头，且完整复制无多余空格
2. 前往 APIMart 控制台 确认密钥状态有效
3. 检查端点地址是否填写正确（Claude Code 用 https://api.apimart.ai，Codex 用 https://api.apimart.ai/v1）

​

Q3: 添加 Codex 供应商时提示格式错误？

• JSON 中的括号、引号、逗号是否完整
• 不要使用中文引号
• TOML 中的字段名拼写是否正确

​

Q4: CC-Switch 会修改哪些文件？

• Claude Code：~/.claude/settings.json
• Codex：~/.codex/config.toml 和 ~/.codex/auth.json

​

Q5: 如何查看 API 使用情况和费用？

​

支持与帮助

• 📚 APIMart 文档中心
• 📚 CC-Switch 项目主页
• 💬 Discord 社区
• 🐦 Twitter @APIMart_
• 📧 技术支持：zhihong@apimart.ai