🔮 Claudish

Claude Code. 任意模型。

在 Claude Code 中使用你现有的 AI 订阅。 支持 Anthropic Max、Gemini Advanced、ChatGPT Plus/Codex、Kimi、GLM、OllamaCloud，以及通过 OpenRouter 接入的 580 多种模型，还支持本地模型以实现完全隐私保护。

官网 · 文档 · 报告 Bug

Claudish (Claude-ish) 是一个 CLI 工具，它通过代理本地与 Anthropic API 兼容的服务，让你能够使用任何 AI 模型来运行 Claude Code。

支持的提供商：

云端： OpenRouter (580+ 模型)、Google Gemini、OpenAI、MiniMax、Kimi、GLM、Z.AI、OllamaCloud、OpenCode Zen
本地： Ollama、LM Studio、vLLM、MLX
企业级： Vertex AI (Google Cloud)

使用你现有的 AI 订阅

停止为多个 AI 订阅付费。 Claudish 让你可以使用现有的订阅来享受 Claude Code 强大的界面：

你的订阅	命令
Anthropic Max	原生支持 (直接使用 `claude`)
Gemini Advanced	`claudish --model g@gemini-3-pro-preview`
ChatGPT Plus/Codex	`claudish --model oai@gpt-5.3` 或 `oai@gpt-5.3-codex`
Kimi	`claudish --model kimi@kimi-k2.5`
GLM	`claudish --model glm@GLM-4.7`
MiniMax	`claudish --model mm@minimax-m2.1`
OllamaCloud	`claudish --model oc@qwen3-next`
OpenCode Zen Go	`claudish --model zgo@glm-5`

100% 离线选项 — 你的代码永远不会离开你的机器：

claudish --model ollama@qwen3-coder:latest "your task"

自带 API Key (BYOK)

Claudish 是一个 BYOK (Bring Your Own Key) AI 编码助手：

✅ 使用你已有的 API Key
✅ 无额外订阅费用
✅ 完全的成本控制 — 按量付费
✅ 兼容任何提供商
✅ 会话过程中随时切换模型

功能特性

✅ 多提供商支持 - OpenRouter, Gemini, Vertex AI, OpenAI, OllamaCloud 及本地模型
✅ 全新路由语法 - 使用 provider@model[:concurrency] 进行明确路由（例如 google@gemini-2.0-flash）
✅ 原生自动检测 - 像 gpt-4o, gemini-2.0-flash, llama-3.1-70b 等模型会自动路由到其原生 API
✅ 直接 API 访问 - 支持 Google, OpenAI, MiniMax, Kimi, GLM, Z.AI, OllamaCloud, Poe 直接计费
✅ Vertex AI Model Garden - 访问 Google 及其合作伙伴模型 (MiniMax, Mistral, DeepSeek, Qwen, OpenAI OSS)
✅ 本地模型支持 - 通过 ollama@, lmstudio@ 语法及并发控制支持 Ollama, LM Studio, vLLM, MLX
✅ 跨平台 - 同时支持 Node.js 和 Bun (v1.3.0+)
✅ 通用兼容性 - 使用 npx 或 bunx 即可运行，无需安装
✅ 交互式设置 - 未提供 API Key 或模型时会进行提示（零配置！）
✅ 监控模式 - 代理至真实的 Anthropic API 并记录所有流量（用于调试）
✅ 协议合规 - 与 Claude Code 通信协议 1:1 兼容
✅ 无头模式 (Headless) - 为非交互式执行提供自动打印模式
✅ 静默模式 - 默认输出简洁（无日志污染）
✅ JSON 输出 - 提供结构化数据以供工具集成
✅ 实时流式传输 - 实时查看 Claude Code 的输出
✅ 并行运行 - 每个实例均获得独立的代理
✅ 自主模式 - 通过标志位绕过所有提示
✅ 上下文继承 - 在当前目录运行并使用相同的 .claude 设置
✅ Claude Code 标志透传 - 可按任意顺序转发任何 Claude Code 标志 (--agent, --effort, --permission-mode 等)
✅ 视觉代理 (Vision Proxy) - 非视觉模型会自动通过 Claude 获取图像描述，确保每个模型都能“看见”

安装

快速安装

# Shell 脚本 (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/MadAppGang/claudish/main/install.sh | bash

# Homebrew (macOS)
brew tap MadAppGang/tap && brew install claudish

# npm
npm install -g claudish

# Bun
bun install -g claudish

前置条件

Claude Code - 必须已安装 Claude CLI
至少拥有一个 API Key：
- OpenRouter API Key - 访问 100+ 模型（提供免费层级）
- Google Gemini API Key - 用于直接访问 Gemini
- OpenAI API Key - 用于直接访问 OpenAI
- OllamaCloud API Key - 用于云托管的 Ollama 模型 (oc/ 前缀)
- 或使用本地模型 (Ollama, LM Studio) - 无需 API Key

其他安装选项

使用方法请参考完整文档。