CURRENT RELEASE / TERMINAL OUTPUT
KODER CLI 0.5.21 / 帮助
KODER CLI / 0.5.21
任务未完成时，提供可反馈的错误报告。
0.5.21 提供报告编号、具体错误码、已知原因或明确的未知原因、执行状态和下一步。本地报告遵循 Setup 遥测开关；网站任务在 8K 上下文预算下也保留设计读取和预览工具。
安装之后
开始第一个任务、连接模型，或查找常用命令。
快速开始
快速开始
从打开终端到第一处修改，六步。每一段命令右边都有复制。
-
按仓库里的说明安装
安装命令和每一步写在 项目仓库。装好后输入 koder。
-
打开设置
安装结束会进入设置。用方向键或鼠标选择语言、模型和配色，改完自动保存。之后随时可以再打开，或只切换语言：
koder setupkoder lang en -
连接一个模型
Koder 不含模型。你自己选服务、取得密钥，并和那家服务商结算。下面以 OpenAI 为例，先把密钥放进环境变量，再让 Koder 读这个变量：
export OPENAI_API_KEY="你的密钥"koder model set --preset chatgpt --key-env OPENAI_API_KEYWindows PowerShell 里第一行改成：
$env:OPENAI_API_KEY="你的密钥"用本机的 Ollama：
koder model set --preset local --model qwen3:8b一共 36 个预设，koder model presets 列出全部。设置存在 ~/.koder-cli/provider.json，权限 600。用 --key-env 时文件里只记变量名；直接粘贴的密钥是明文保存的。灰色入口暂不可用。配好可用服务后检查一遍：
koder doctor -
进入项目文件夹，开始对话
cd 你的项目文件夹 koder直接输入要做的事，回车。/help 看命令，/setup 打开设置，/lang en 切英文，/exit 或 Ctrl+D 退出。默认在当前工作区操作；主目录或其他目录访问需在 koder permissions 中另行授权，系统权限仍由操作系统控制。
Koder CLI 0.5.21 · 正式程序帮助输出节选 · 由采集的终端字符渲染。 -
确认修改
也可以不进对话，一句话交代：
koder run "npm test 没过，修一下 cart.mjs 里的 total()"默认智能判断会处理普通项目修改和低风险命令。要逐项确认，先运行 koder permissions execution ask；这时会展示红绿差异，输入 y 接受，其他答案拒绝。敏感操作仍需实际许可。
历史版本受控演示。终端输出：koder run 修 cart.mjs，停在“接受这个修改？”。截图时接的是本机一个按脚本回复的测试接口，不是真实模型。 -
跟着教程走
终端里是 1800 课互动教程，进度会记住。--print 只印文字。--os 换成 powershell、cmd、mac 或 linux 的讲法。第 16 课是安装和更新。
koder learnkoder learn 3koder learn --print --os powershell
常用命令
常用命令
每个命令都有自己的说明，koder help 加命令名就能看。
koder ask
只读提问：只能列目录、读文件和搜索，不改文件、不跑命令。
koder ask "登录流程从哪个文件开始？"koder run
执行一个任务，可改文件、跑命令，按智能判断和已保存的许可执行；敏感操作需要有效许可。管道输入会作为附加材料交给 Koder。
npm test 2>&1 | koder run "根据这段失败输出修好测试"koder review
收集改动、仓库结构、AGENTS.md 这类规则文件和最近的提交，给出每条问题的文件、行号、级别和修改建议。
koder review --base origin/main --format markdown --out review.md koder fix
运行检查，失败就把输出交给 Koder 修，修完再查，直到通过或用完次数，默认 3 次。
koder fix --check "npm test"koder test
先读现有的测试，沿用同样的目录和写法，再给改动或指定文件补测试。
koder test src/price.js --check "npm test" koder flow
用一个 JSON 流程文件把几步串起来：shell、run、ask、review、fix、test，可以加条件，只读步骤可以并行。
koder flow init pr-gatekoder ci init
写入 .github/workflows/koder.yml。PR 打开或更新时审查并评论；在 PR 里评论 /koder review、/koder fix 等会触发对应动作，修改类指令只接受仓库成员。
koder ci initkoder update · koder uninstall
更新到最新版；卸载 Koder CLI，加 --purge 同时删除配置。
koder update
| 通用选项 | 作用 |
|---|---|
| -w --workspace | 工作区，默认当前目录 |
| -y --yes | 按执行许可自动处理修改和命令；敏感操作仍须有效许可，不代答问题或收集密码 |
| --json | 每行输出一个 JSON 事件，方便脚本读取 |
| --mode | standard、code、minimal、plan、execute、report、enhance |
| --lang | 这一次用中文或英文 |
| --no-color | 关闭颜色 |
TUI / 0.3.1
终端里的独立工作台。
Koder TUI 的 Windows 和 Mac 发行信息集中在官方 GitHub Releases，版本与 CLI 分别发布。
早期 TUI 命令参考（0.1.0）
Koder TUI 0.1.0
占满一屏的终端界面
- 顶栏是版本、工作区、模型和模式。中间是对话，底下是输入框和状态栏。
- 右边侧栏是会话、用量、已写入和工具。终端宽 110 列以上才显示，/sidebar 可以收起。
- 改文件先弹出差异窗口：y 接受，n 或 Esc 拒绝。命令也先问。
- /yes 只自动确认修改和命令；要你选择的问题照样会问，密码从不替你填。
- 和 koder 共用模型和语言设置。
TUI 快速开始
五步。软件里输入 /learn 还有五步教程。
-
按仓库里的说明安装
安装命令在 项目仓库的 TUI 一节。装好后输入 koder-tui。
-
连接模型
TUI 读 koder setup 写好的模型。已经配过，就不用再配。没装 CLI 的话，先按上面装好，打开 koder setup，或运行 koder model set。也可以在打开 TUI 之前设置这三个环境变量：
export KODER_MODEL="型号名" export KODER_BASE_URL="兼容接口地址" export KODER_API_KEY="你的密钥" -
进入项目文件夹，打开 TUI
cd 你的项目文件夹 koder-tui直接输入任务，Enter 发送，Ctrl+J 换行。不想看开屏动画，加 --no-splash。
-
输入 / 打开命令
输入 / 会弹出命令面板，继续输入会筛选，Tab 补全。
历史版本受控演示。终端输出：输入 /m 后，面板里剩下 /mode 和 /model。 截于 0.1.0。 -
确认修改
Koder 要改文件时弹出差异窗口。y 接受，n 或 Esc 拒绝，↑↓ 滚动。Esc 也能中断正在进行的这一轮，已经接受的修改会保留。
历史版本受控演示。终端输出：准备修改 cart.mjs 的差异窗口，状态栏写着等你确认。截图时接的是本机一个按脚本回复的测试接口，顶栏的模型名 scripted 就是它，不是真实模型。 截于 0.1.0。
| 斜杠命令 | 作用 |
|---|---|
| /help | 查看全部命令与按键 |
| /learn | 五步上手教程 |
| /lang | 切换语言：/lang zh 或 /lang en |
| /mode | 切换工作模式 |
| /yes | 开关自动确认（只管文件与命令） |
| /new | 开始新会话 |
| /clear | 清空屏幕记录 |
| /model | 查看当前模型配置 |
| /sidebar | 显示或隐藏侧栏 |
| /banner | 重播折光体开屏 |
| /exit | 退出 Koder TUI |
| 按键 | 作用 |
|---|---|
| Enter | 发送 |
| Ctrl+J Alt+Enter | 换行 |
| ↑ ↓ | 上一条 / 下一条输入 |
| PgUp PgDn | 翻看记录（Ctrl+↑↓ 逐行） |
| Esc | 中断当前这一轮 |
| Ctrl+C | 中断；空闲时连按两次退出 |
| Ctrl+D | 输入为空时退出 |
| Ctrl+L | 重绘屏幕 |
| Tab | 补全斜杠命令 |
JSON 输出与编辑器集成
CLI / SCRIPTING
JSON 输出与编辑器集成
koder run --yes --json "补上 README 的安装说明"koder editor zed常见问题
Koder CLI 0.4.18
Koder CLI 0.4.18
相关资料
1 / 2
相关资料
CLI 原生套餐：别把密钥带错门
CLI 原生套餐：别把密钥带错门
阿里云 Token Plan 和火山 Coding Plan 当前已置灰、暂时无法使用。阿里云 Coding Plan 保留独立入口，仍需验证自己的账号。普通 API 与套餐通道不混用，不会为了兜底而切换计费地址。默认使用原生 Koder，内部备用引擎默认关闭并置灰。
- 阿里云 Token Plan（暂不可用，地址仅供辨认旧配置）：
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，对应当前 Token Plan 的 sk-sp- 密钥。 - 阿里云 Coding Plan：
https://coding.dashscope.aliyuncs.com/v1，对应 Coding Plan 密钥；不是 Token Plan。 - 火山 Coding Plan（暂不可用）：
https://ark.cn-beijing.volces.com/api/coding/v3，可选ark-code-latest跟随控制台。
套餐型号和额度以账户控制台为准。配置后可明确运行 koder model test --tools 检查工具续答，该检查会请求 API 并可能计费。完整接入说明。
新功能可选，隐私全文随包带走
新功能可选，隐私全文随包带走
输入 koder privacy consumer 查看完整 CLI 消费者隐私条款，koder privacy statement 查看隐私声明。官网原始消费者全文也完整保留，并明确区分桌面与 CLI 的行为。
完整 CLI 消费者隐私条款 · CLI 隐私声明 · Full English terms · 原文来源与校验摘要
明确说“我要反馈”或运行 koder feedback，可取得 info@karmenloop.com 和空白模板；不会自动发送邮件、日志或聊天。
正事之外，留六秒钟给快乐
正事之外，留六秒钟给快乐
koder celebrate 提供代码雨、礼花、烟花、圣诞、万圣节、国庆、跨年与生日彩蛋。动画约六秒，任意键立即跳过；菜单回车可退出，脚本与 JSON 不播放动画。
已收录节日按本机日期显示一次祝福，自动动画可单独开启；可添加自己的年度纪念日。生日只保存明确选择的月日，音乐与 IP 地区辅助默认关闭并分别确认。中文与英文祝福来自 KARMENLOOP 团队。
音乐默认在本机生成；浏览器拦截自动播放时可点播放，不绕过限制、不反复开窗。手动语言与主动开启的本机常用语言计数优先，IP 仅作弱提示。koder celebrate auto off 和 koder celebrate music off 可分别关闭。
教程已扩展为 1800 课，包含任务执行、编程、撰写、办公与开发者案例。查看完整教程。
接口状态与智能审批
接口状态与智能审批
Kimi 与 DeepSeek 当前暂不可用。保留的底层协议测试与恢复代码不代表这些入口已经恢复；重新开放前需要单独验收。
默认智能判断：低风险检查与普通项目修改自动执行；敏感操作可本次允许、始终允许或全面开放。koder permissions execution status 查看；koder permissions execution full --confirm FULL 保存本项目全面开放；加 --scope profile 明确设置全部项目；koder permissions execution reset 撤销全部执行设置。全面开放可运行代码、改删文件和操作已授权应用，不代填密码或取得系统权限。许可仅保存在本机，不作为记忆同步。
个人使用与公司授权
个人使用与公司授权
明确采用 Koder-EULA-1.1 的 CLI 新发行版允许免费个人非商业使用。商用、有偿客户工作及组织内部部署须另获书面授权；个人许可不包含二次开发或修改自有实现代码。第三方与旧版本原有许可不变。
KARMENLOOP 本地任务内核串起计划、权限核对、工具执行与结果记录。官网只介绍公开能力，不公开私有开发源码。
公司授权服务＋专用私有仓库：info@karmenloop.com。人数、部署、仓库内容、维护、支持及开发权以另行书面协议为准；洽询入口不会自动创建仓库或授予商业权利。
喜欢 Koder？欢迎自愿为项目点一颗 Star，直接跳过也不影响使用。
本机私有合集可按需检索技能与模板，默认不向模型开放；明确授权后，只发送选中的片段。原始合集不随官网或公共安装包分发，不自动运行其中脚本。详见 私有资料库说明；商业授权说明运行 koder business。
官方加密工作流资料库可按需查询，不预装整库。首次开放 1,004 份许可明确的 Koder 整理版技能；必要版权声明随片段保留。检索词与资源编号会发送到官方服务，请勿填入私人数据；设置 KODER_REMOTE_RESOURCES=0 可关闭。了解远程资料与隐私。
系统要求与版本
系统要求与版本
| 产品 | 版本与系统 | 安装 |
|---|---|---|
| Koder desktop | macOS 0.4.56 · Apple silicon · macOS 13+ / Windows 0.4.56 · 64-bit Windows 10 / 11 | [ RELEASES ] |
| Koder CLI / TUI | 0.4.18 / 0.1.0 · macOS / Linux / Windows 10 / 11 | 安装说明 · 不需要邀请码 |
CLI 0.4.18 发行详情
Koder CLI 0.4.18 正式发行：Windows 与 macOS 的终端助手
0.4.18 已提供 Windows 与 macOS 安装器。MCP 工具调用默认等待提高到 3 分钟；修复重启后邮件提醒积压、GitHub Skill 短名称调用与 Setup 开关。保留不限工具轮次、取消、费用预算和 1800 课课堂；Windows 实机与真实账号由 beta 专员继续核对。
原有功能完整保留。真实模型质量评分及最终安装包的 Windows 客户端验收仍待完成，具体范围见更新说明。
进入项目目录运行 koder，或使用 koder ask、koder run 与 koder review。多个终端任务可分别命名，如 koder chat --session website 与 koder chat --session tests。对话和审批各自保存，同一项目文件仍需要协调。
下载与安装
进入官方 GitHub Releases 查看当前版本、平台说明与许可要求。
更新与教程
先运行 koder update --check，再运行 koder update，最后用 koder --version 核对 0.4.18。若旧更新器提示许可变化，请运行普通安装器并明确接受所展示的条款。配置、历史与渠道绑定保持原有内容。
GitHub 正式发行与校验值 · 0.4.18 发布说明 · 完整中文教程 · 全部 1800 课
正式发行标识本次分发渠道。Windows 原生验收仍保留明确范围：PowerShell 5.1 冷启动、Windows 用户设备完整安装更新、中文输入与 GUI 操作仍分别验收。真实模型调用取决于你配置的服务与账号。
配置一次，权限仍由你掌握
Windows x64 已内置 Windows-MCP 0.8.8 与 Python 3.14.8，在 Setup 配置、测试并启用即可，无需再装系统 Python；macOS 使用原有电脑驱动。安装超时会保留结果不明的回执供诊断，避免盲目重复安装。
在 Setup 绑定 163 等邮箱，原生发送前仍核对最终收件人和正文。后台监控另行授权：已激活且运行的宿主默认每 30 秒轮询，安静时段和每日上限仍生效，睡眠或网络可能延迟提醒。Headroom 默认开，可在 Setup → Skills 关闭。
本版 Windows 用户系统冷安装、MCP 图形操作、真实邮箱与模型质量仍待验证。
Windows-MCP · 邮箱完整教程 · Headroom · 安装恢复
从 0.4.4 或更早版本升级：若提示更新清单无效，请用官网当前安装器覆盖升级一次。旧更新器限制包小于 100 MB，0.4.5 及后续版本将有界上限提高到 512 MiB；配置和历史独立保留。升级说明。
早期版本记录
彩蛋结束，马上回到当前终端
preview.22 精简了独立彩蛋结束后的进程等待。完整播放仍是六秒，任意键可跳过；对话里的设置和彩蛋会回到同一个输入提示。
preview.21：记忆权限有问题，对话也能继续
修复 MEMORY_ACCESS_ISOLATION_UNVERIFIED 导致每次对话都中断的问题。无法验证记忆目录时，保留旧记录并暂停历史读写、个性化与同步，当前任务用临时内存会话继续；不偷偷换目录。关闭或手动更新后临时对话不恢复，自动安装会等待。
输入 /memory diagnose 或 koder memory diagnose --json 查看目录与建议。Windows 已私有的继承权限可安全固定，已有访问规则不增加；存在其他用户权限或目录无法验证时继续保护旧记忆。切换账号会清除临时上下文，执行授权仍单独检查。
preview.19：内置自研自主学习 Skill
KARMENLOOP 的 personal-agent-growth 0.3.2 随 CLI 安装。遇到跨步骤、补课、复盘和任务接续时，可通过现有技能工具按需读取方法与配套资料，不用再下载技能包。
koder growth status 查看内置版本，koder growth show 阅读方法；koder growth off 关闭、koder growth on 开启下次会话调用。任务记录只写获准工作区；不代开后台服务、画像学习、同步或执行权限。定时接续仍须有实际可用且单独授权的宿主后端。
使用说明与宿主条件。八份原始方法文件保留完整许可和声明。合成模型工具链检查、真实模型选用与用户实机验收分别记录。
preview.18：授权能落地，更新有回音
修复执行许可记录损坏后，只显示“准备运行命令”却无法继续确认的问题。合法的 UTF-8 BOM 记录可以直接读取；损坏记录先由你重新选择，仅本次允许、始终允许或本项目全面开放。保存新许可前备份旧记录，不自动沿用损坏的授权。
彩蛋改为有效的终端 RGB 颜色输出，保留约六秒播放、任意键跳过和减少动态效果设置。Windows 的启动、微信更新交接与动画按原时间限制做了重复验收；历史失败保留在发行报告中。测试安装脚本采用正式安装器的参数传递方式，避免重定向输入造成的假等待。
后台安装失败现在会明确提示，当前对话仍可继续。安装版每六小时最多检查一次更新，待任务、排队输入和草稿处理完才切换；协议变化仍需阅读。/update auto off 关闭，/update auto on 开启。preview.16 及更早版本先运行一次 koder update。
“全面开放”管理 Koder 的执行审批，不等于 Windows 管理员权限；无需为修复本次许可记录报错而修改全机 PowerShell 策略。授权恢复与排错说明。
0.4.0-preview.30 Beta：多窗口会话与退出恢复热修复
本版在完整 preview.29 基础上修复会话占用：旧版进程只持有回合锁时，新默认任务也会先获得独立会话；监督进程断开后，自己的工作进程会取消待处理请求并释放占用。进程编号被系统重复使用时，不再把本进程的旧记录误认成仍在运行的任务。
忙碌提示不再断言一定存在另一个可见窗口。明确命名且正在使用的会话仍受保护，不会被抢占；不会按记录年龄强制解锁，也不会删除历史或终止其他任务。
在两个或三个窗口分别开始
每个终端运行一个命令：koder chat --session website、koder chat --session slides、koder chat --session tests。也可直接运行 koder：同项目默认会话已被占用时会自动分配独立名称，并显示恢复方法。
对话、任务记忆、审批与取消分别处理；同一项目文件仍由任务共享，需要分开产物时请选择不同项目目录。出现占用提示时，请保留会话名，正常结束已完成的旧任务，或改用独立名称；不要删除记忆目录，也不要批量结束 Node 进程。完整多窗口教程。
更新与完整教程
先运行 koder update --check，再运行 koder update，最后用 koder --version 核对版本。原有配置、历史、模型路由、Skills、权限和教程保持可用。
GITHUB · [ RELEASES ] · [ RELEASES ] · 本版完整说明 · 完整中文教程 · Complete English guide · 全部 1800 课与 8 份终端教程。
Windows Server 2025 与 Windows 11 ARM64 隔离环境已通过三任务 CLI 入口检查，使用本机合成响应，不涉及付费模型。该结果不等于 PowerShell 5.1 冷启动、Windows 10/11 用户客户端完整安装更新、GUI 焦点、中文输入或 UAC 全部通过；真实模型账号仍按各自范围验收。下方保留 preview.29 的既有能力及当时记录。
0.4.0-preview.29 Beta：多个窗口，各自完成任务
打开两个或三个终端窗口，可分别处理网站、幻灯片和测试。同项目默认会话已在使用时，新窗口自动获得独立会话名；也可分别运行 koder chat --session website、koder chat --session slides、koder chat --session tests。各会话的对话、任务记忆、审批、取消和恢复分别处理，不抢占正在使用的明确命名会话。
会话隔离不会复制项目文件。两个任务写同一路径仍需协调；要分开产物，请使用不同项目文件夹。明确保存的共享记忆、模型配置和全局设置保持原有范围。完整多窗口教程。
先填入，再编辑发送
空输入框按 / 打开上下文建议、保存的模板与命令。方向键和翻页键浏览，Tab 填入；明确移动选择后，回车也只填入草稿。编辑后再次回车才发送，Esc 关闭。选择不提交任务，完整斜杠命令与粘贴保持原有行为。输入与撰写教程。
接口诊断与撰写证据
MiniMax 官方接口的 HTTP 422 + 1026/1027 明确显示内容审核拦截，普通参数、鉴权、额度与网络错误分别说明。不自动换主机、重发、改写历史或重放已完成工具。分类与排查。
长度优先检查本轮实际交付文件；版本材料、运行版本与真实新增证据分别记录。没有新增证据时可明确说明“不是本版新增”，不能用验收条款或标签代替证据。指定前稿压缩保留路径与 SHA，长对话投影保留早期任务与约束。真实模型写作评分未重测，不宣称达到特定分数。
保留任务执行、爬虫与逆向工作流
已有任务上下文、工具发现、结果回传与恢复检查继续使用。有界爬虫限制主机、页面数和内容量；自研逆向按批准的文件范围读取证据。不扫描整机、不新增执行权限、不宣称替代所有第三方工具。任务执行与恢复 · 爬虫与逆向教程。
完整安装与验收范围
GITHUB · [ RELEASES ] · [ RELEASES ] · 完整中文教程 · Complete English guide · 全部 1800 课。中英文各有 PowerShell、CMD、macOS 和 Linux 四套文字版。
候选已记录 377 项本机回归、精确包三进程会话检查及隔离 Mac 安装。Windows PS5 冷启动、Windows 10/11 用户客户端、本版完整安装更新、中文输入和原生多窗口仍待验收；真实服务商与写作评分未据此认证。已有 preview.28 的 Windows Server 2025 Windows-MCP 和 Mac Code Graph 限定实测保留，不转为本版全部组合通过。既有实测 · 发布详情。
0.4.0-preview.28 Beta：Windows-MCP 与项目代码图谱
在当前终端运行 /setup，进入应用与 MCP，即可配置 Windows-MCP 和 CodeGraphContext；也可运行 koder mcp presets 查看预设。预设默认关闭，先检查、测试，再由用户启用。Windows-MCP 仅限本机 Windows 10/11，需要单独安装上游程序与 Python 3.14；不会自动提权。
Code Graph 按项目隔离运行目录与索引数据库。模型先发现实际工具，查询调用关系与影响范围，再核对源文件；缺少或过期的索引会退回源码搜索，不会自动扫描整台电脑。图谱与桌面操作沿用原有审批。
Windows-MCP 与 Code Graph 完整教程 · English integration guide。以下质量检查功能继续保留。
面向技术决策者的中文约 800 字介绍会检查 720–880 个汉字并显示实测字数；发版文案可以先读取工作区的版本材料，存在两条对应事实时要求两个真实行标记；压缩对比稿记录上一稿哈希，检查新增数字与部分技术名词。
新增 koder project check，无需模型即可检查 README、测试或 verify 入口、Docker 文件与静态网页基本结构。相关新建任务缺项返回退出码 3，保留已写文件；结构检查不会执行项目脚本，也不等于测试通过或设计评分。三分钟首稿与至少 15 个生成器测试是交付目标，不冒充已测结果。
模型预设按实际目录区分可选与暂不可用数量；可选不等于本人账号已验收。MiMo Token Plan、Kimi API/Code、DeepSeek、阿里云 Token Plan、火山 Coding Plan 和方舟 API 继续置灰，不会静默切换服务或计费路线。
完整教程与安装文件
完整中文教程 · Complete English guide · 质量检查详解 · [ RELEASES ] · [ RELEASES ]
中英文共 8 套 PowerShell、CMD、macOS、Linux 文字教程，30 课；完整参考覆盖 49 个命令。保留原来的 12 道盲测题目，本轮 87 项程序契约及 33 项应用、安装与更新回归通过。发布后已补独立 Windows Server 2025 上的 Windows-MCP PowerShell、快照、点击输入与公开包 Agent 续答，以及 Mac 独占环境的真实图谱和 Koder 调用；Windows 10/11 用户实机与其他组合仍未验收。查看本轮组合、依赖和验证边界。Beta 不代表全部真实账号或 Windows 真机已验收。