MadAppGang/claudish

🔮 Claudish – Claude Code 的通用代理

是什么

• 一个命令行界面（CLI），可让您使用任何您有访问权限的 LLM（云端、本地或企业级）运行 Claude Code（Anthropic 的编程助手）。它通过启动一个模拟 Anthropic API 的本地服务器，然后将请求转发到您指定的提供者来工作。

为何重要

• 您可以保持单一工作流（Claude Code 强大的提示语言、基于文件的指令、子代理委派），同时在 Anthropic、OpenAI、Google Gemini、Ollama、OpenRouter 以及数十家其他供应商的模型之间切换。这避免了维护多个 CLI 工具或支付多个订阅费用的麻烦。

核心功能

• 多提供者路由 – 支持 provider@model[:concurrency] 语法（例如 g@gemini-3-pro-preview、ollama@qwen3-coder:latest）。支持云 API、本地服务器和 Vertex AI 等企业服务。
• BYOK（自带密钥） – 无额外费用；只需设置相应的环境变量，或让交互式提示收集您的 API 密钥即可。
• 完全兼容 Claude Code – 所有 Claude Code 标志（--agent、--effort、--permission-mode 等）均原样传递，因此现有 Claude Code 脚本可继续运行。
• 离线模式 – 可完全在本地模型（Ollama、LM Studio、vLLM、MLX）上运行，确保您的代码不会离开机器。
• 视觉代理 – 非视觉模型会自动从 Claude 获取图像描述，使每个模型都具备“视觉”能力。
• 开发者友好性 – 支持交互式设置、模型自动检测、工具集成的 JSON 输出、成本追踪，以及用于调试的 monitor 模式（记录流量）。
• 跨平台支持 – 支持 Node.js 或 Bun，可通过 npx/bunx 直接运行，无需全局安装。

安装

# 快速一行命令（Linux/macOS）
curl -fsSL https://raw.githubusercontent.com/MadAppGang/claudish/main/install.sh | bash

# Homebrew（macOS）
brew tap MadAppGang/tap && brew install claudish

# npm / Bun
npm install -g claudish   # 或  bun install -g claudish

您也可以不安装直接运行：

npx claudish@latest --model openrouter@anthropic/claude-3.5-sonnet "refactor this function"

典型工作流

1. 配置 API 密钥 – 设置 OPENROUTER_API_KEY、GEMINI_API_KEY、OPENAI_API_KEY 等，或让 claudish login 为支持的提供者处理 OAuth。
2. 选择模型 – 可让交互式选择器自动选择，或显式指定：

   claudish --model g@gemini-3-pro-preview "write a unit test"
   claudish --model ollama@qwen3-coder:latest "implement login flow"
   

3. 运行 Claude Code – 您通常传递给 claude 的任何标志，均可在 claudish 后使用。
4. （可选）在代理中使用 – 该工具提供 AI 代理指南（claudish --help-ai），并推荐使用基于文件的模式，以避免污染 LLM 的上下文窗口。

配置

• 当前目录中的 .env 文件会自动加载环境变量。
• 默认模型、代理端口、并发限制和遥测等设置可通过 CLAUDISH_* 变量或自定义配置文件（--config <file>）覆盖。

许可证

• MIT（参见 LICENSE）。

了解更多

• 官方网站： https://claudish.com
• 完整文档： https://github.com/MadAppGang/claudish/blob/main/docs/index.md
• 问题追踪（用于报告错误和功能请求）： https://github.com/MadAppGang/claudish/issues