Codewhale 是开源的终端编程助手，能读取项目、编辑文件、运行命令并自检。它内置 40 多个 provider 路由，并支持任意 OpenAI 兼容端点，原生以 DeepSeek 为默认模型。适合在终端里做多步重构、调试和长任务的工程师。
网关 base_url（国内站）https://api.shinloo.com/v1填到各工具的
base_url / OPENAI_BASE_URL / apiBase 之类设置里。OpenAI 线路填 /v1；Anthropic / Gemini 线路填网关根 https://api.shinloo.com。OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsOpenAI 线路的客户端用这个地址（
GET /v1/models 可查你的 Key 可用模型）。推荐模型（国内站已开通）deepseek-v4-prodeepseek-v4.1-flashqwen3.8-max以上为本站公示的模型名，实际可用清单以你的 Key 调
GET /v1/models 返回为准。省事版 — 一键接入
脚本从 Codewhale 的官方来源安装，把网关配置写进工具自己的配置文件
（写之前先备份原文件），再发一次真请求验证。会提示你粘贴网关 Key（也可用 --key 传入）；
--uninstall 只还原它写进去的内容。
curl -fsSL https://api.shinloo.com/agents/codewhale/setup | bash
1 · 安装
从 Codewhale 自己的官方来源安装。
curl -fsSL https://codewhale.net/install.sh | sh # macOS/Linux；Windows: winget install HunterBown.CodeWhale；也可 npm install -g codewhale
2 · 配置 — 指向国内站网关
网关 base URL https://api.shinloo.com/v1；Key 在 控制台创建。
1) 新建 ~/.codewhale/config.toml（或用 CODEWHALE_CONFIG_PATH、--config 指定路径）。 2) 选内置的 OpenAI 兼容 provider 并指向我们的网关： provider = "openai" default_text_model = "<model-id>" [providers.openai] api_key = "YOUR_API_KEY" base_url = "https://api.shinloo.com/v1" 3) 也可先存 key：codewhale auth set --provider openai --api-key "YOUR_API_KEY"，再编辑 [providers.openai].base_url。 4) 重启后模型客户端生效；用 /model 选模型，TUI 里 /provider（或 F3）也支持直接粘贴 Base URL + key 的方式接入。
3 · 验证
发一次请求，能返回就说明走的是国内站网关。
codewhale exec "reply with OK"
4 · 常见坑
- 端点必须写在 [providers.openai] 表里，不要用旧式顶层 base_url，否则 OpenAI 兼容路由读不到。
- 若网关只接受
/chat/completions而非/v1/chat/completions，在 [providers.openai] 加 path_suffix = "/chat/completions"。 config.toml的 base URL 改完需重启模型客户端才生效。- 非 localhost 的 http:// 网关需以
DEEPSEEK_ALLOW_INSECURE_HTTP=1 启动；https 不受影响。
工具侧步骤的官方来源： github.com/codewhale-hq/Codewhale github.com/codewhale-hq/Codewhale/blob/main/docs/CONFIGURATI github.com/codewhale-hq/Codewhale/blob/main/docs/PROVIDERS.m github.com/codewhale-hq/Codewhale/blob/main/config.example.t