一句话:Crush 官方支持自定义供应商——两条 crush provider add 命令(OpenAI 兼容 / Anthropic 兼容),即可接入 CodeGateway 的模型。
准备工作
在 CodeGateway 官网 注册账号(绑定支付方式后可获得起步试用额度,具体金额以注册/定价页实时展示为准),在 Dashboard 创建 API Key(sk-cg- 开头)。
Crush 兼容两种协议面,按你想用的模型选一条路径(见下文)。
1. 安装 Crush
brew install charmbracelet/tap/crush或 npm install -g @charmland/crush(Windows: winget install charmbracelet.crush)。
2a. 路径 A:OpenAI 兼容(DeepSeek / Kimi / GLM / Qwen)
crush provider add cg --type openai-compat \
--base-url "https://api.codegateway.dev/v1" \
--api-key "sk-cg-你的密钥"
crush model add cg/deepseek-v4-pro --context-window 262144--type openai-compat用于非 OpenAI 官方的 OpenAi 兼容端点(注意:代理 OpenAI 官方 API 才用--type openai)。模型 id 与 模型清单 一致;可用
--discover-models true自动发现模型。
2b. 路径 B:Anthropic 兼容(Claude / Gemini)
crush provider add cg-anthropic --type anthropic \
--base-url "https://api.codegateway.dev" \
--api-key "sk-cg-你的密钥" \
--extra-header "anthropic-version" "2023-06-01"
crush model add cg-anthropic/claude-sonnet-4-6 --context-window 200000消息协议下 Claude 系与 Gemini 系模型可用(如 claude-sonnet-4-6、gemini-3.8-flash)。--extra-header 携带 Anthropic 协议必需的版本头。
3. 验证
crush -p "只回复两个字:你好" --model cg/deepseek-v4-pro(若你的 Crush 版本参数名不同,直接启动 crush 后发送消息验证即可。)返回回复即接入成功。
可用模型建议
OpenAI 兼容路径:
deepseek-v4-pro、kimi-k2.7-code、glm-5.3。Anthropic 路径:
claude-sonnet-4-6、gemini-3.8-flash。
注意:GPT 系模型受上游地区政策限制;Claude / Gemini 不在 OpenAI 兼容路径下使用。
常见问题
Q:`openai` 和 `openai-compat` 有什么区别? openai 用于官方 OpenAI API(有协议细节差异);openai-compat 用于任何 OpenAI 兼容端点——CodeGateway 选 openai-compat。
Q:如何查看已添加的供应商? crush provider list / crush model list。
Q:模型没出现在列表里? 确认 crush model add 的 provider 前缀(如 cg/)与 provider add 的 id 一致;也可用 --discover-models true 自动拉取。
Q:想切换协议面怎么办? 两条路径各自是一个独立 provider(cg 与 cg-anthropic),按模型所属协议面选择即可,互不冲突。
Q:配置存在哪里? crushrc(bash 内置配置文件)与 JSON 配置,crush provider add 会自动写入。