小马AI 使用文档

主题

CC-Switch-CLI 使用 ​

CC-Switch-CLI 是 CC-Switch 的命令行版本，适合服务器、远程开发机或喜欢在终端里切换配置的用户。

截图说明

本页 TUI 图片是 CC-Switch-CLI 外部工具界面示例，不依赖小马AI控制台，可先引用参考图。

安装 CC-Switch-CLI ​

macOS ​

bash
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

默认会安装到 ~/.local/bin。如果终端提示找不到 cc-switch，请确认 ~/.local/bin 已加入 PATH。

也可以手动下载：

bash
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-darwin-universal.tar.gz
tar -xzf cc-switch-cli-darwin-universal.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
xattr -cr /usr/local/bin/cc-switch

Linux x64 ​

bash
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-x64-musl.tar.gz
tar -xzf cc-switch-cli-linux-x64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/

Linux ARM64 ​

bash
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-linux-arm64-musl.tar.gz
tar -xzf cc-switch-cli-linux-arm64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/

Windows ​

前往 GitHub Releases 下载 cc-switch-cli-windows-x64.zip，解压后把 cc-switch.exe 所在目录加入 PATH。

两种使用方式 ​

进入 TUI 界面 ​

bash
cc-switch

进入界面后，按提示新增 provider、填写 API Key、选择模型并启用。

CC-Switch-CLI TUI 界面示例

使用 CLI 命令 ​

你也可以直接用命令新增小马AI配置：

bash
cc-switch provider list
cc-switch provider current
cc-switch provider switch <id>

Codex 需要加 --app：

bash
cc-switch --app codex provider list

查看当前配置：

bash
cc-switch provider current

配置前准备 ​

  1. 已安装目标 CLI：Claude Code 或 Codex
  2. 已在小马AI创建对应分组的 API 令牌
  3. 已确认目标模型在当前令牌分组中可用。

配置小马AI ​

小马AI常用端点：

text
https://code-plan.pony.codes
https://code-plan.pony.codes/v1

选择端点时按工具类型判断：

  • Claude Code：使用 https://code-plan.pony.codes/
  • Codex、OpenCode、Cherry Studio 等 OpenAI 兼容工具：使用 https://code-plan.pony.codes/v1

常用命令 ​

命令作用
cc-switch打开 TUI 界面
cc-switch provider list查看 provider 列表
cc-switch provider current查看当前 provider
cc-switch provider switch <id>切换 Claude provider
cc-switch --app codex provider list查看 Codex provider
cc-switch update更新 CC-Switch CLI

让 AI 助手操作 CC-Switch-CLI ​

如果你希望让 AI 助手帮你切换配置，可以把当前小马AI provider 名称和目标模型写清楚，例如：

text
请使用 cc-switch --app codex provider list 找到小马AI配置，然后切换到该 provider，并运行 codex 验证是否能正常响应。

常见问题 ​

切换 Provider 后没有生效 ​

先关闭当前 CLI 会话，重新打开终端，再运行目标 CLI。部分工具只在启动时读取环境变量和配置文件。

环境变量覆盖了配置 ​

如果系统环境变量里存在旧的 OPENAI_API_KEY、OPENAI_BASE_URL、ANTHROPIC_AUTH_TOKEN，可能覆盖 CC-Switch 写入的配置。排查时先清理旧变量，再重新启用 provider。

小马AI

Copyright © 2026 小马AI