Codewhale 是什么

Codewhale 是专门给 DeepSeek 系列大模型搭建的终端 Agent，可以实现和 Claude Code、Codex 一样的 Agent 效果。

注意：该 Agent 只能使用 DeepSeek 系列大模型。

使用流程

第一步：打开终端

Command + 空格 → 输入 “iterm” 打开终端（也可以使用 Mac 默认终端）。

第二步：更新 Codewhale

建议每次使用前，在默认路径下执行更新：

1
codewhale update

codewhale update 示例

看到 latest release: v0.x.xx 就是最新版本号。

第三步：进入项目目录

用终端进入你的项目文件夹，然后输入 codewhale 启动 Agent。

常用终端命令：

命令 作用 示例
ls 列出当前目录下的文件
cd 文件夹名 进入某个文件夹 cd AI_File（可按 Tab 自动补全）
mkdir 名字 创建新文件夹 mkdir my-project
cd .. 返回上一级目录

iTerm 快捷键：

快捷键 作用
Command + T 新增窗口
Command + D 当前窗口新增分页
Command + W 关闭当前分页
Command + ←/→ 左右切换窗口

进入 Agent 后的配置

切换模型

输入 /model 可以切换模型，建议选择 v4pro 模型 + max 推理等级：

model 选择

切换 Agent 模式

按 Tab 键切换模式：

模式 说明
Plan 只对话不执行，和网页版一样，但有上下文记忆
Agent AI 拥有执行能力，但每步会询问权限
Yolo 完全权限模式，推荐日常使用，不用反复确认

其他命令

  • /help — 打开斜杠命令帮助面板
  • 需要 MCP 服务或 Skills，直接和 AI 对话让它搜索安装即可

注意事项

关于 Codewhale 的局限性

Codewhale 是社区维护的开源项目，部分功能不如官方的 Claude Code、Codex。据传 DeepSeek 也在开发自己的桌面端 Agent，可以关注。

网络问题

如果遇到网络问题，两种解决办法：

  1. 切换代理节点
  2. 复制环境变量给 Codewhale，让它使用你的网络代理

快捷操作

操作 作用
Control + C 停止当前任务（输入补充内容后按此键，内容会加入思考）
Control + C + C 连续两次，退出 Agent

上下文管理

右上角显示当前 Session 的上下文用量，超过 60% 就不建议继续使用：

上下文用量

上下文超出时的建议：

  1. 使用压缩上下文的斜杠命令（会丢失一定精度）
  2. 告诉模型：”接下来要做 XXX，但我要新开一个 session 继续，你告诉我该发送什么到新 session”
  3. 搭建本地 Git（推荐可视化工具 Fork），方便跨 session 追踪进度
  4. 让模型每完成一步都记录到文档，下次新 session 读取即可恢复上下文