KARMENKoder
EN 下载

Koder · 终端

一条命令装好，
在终端里用 Koder。

Koder CLI 和 Koder TUI 各是一条命令，不需要邀请码。安装写在项目仓库里。CLI 用一句话交代任务，也能放进脚本和 CI；TUI 是占满一屏的终端界面。两个共用同一份模型和语言设置，修改展示差异；CLI 默认智能判断低风险操作，敏感操作可选择始终允许。SDK 0.1.1 在项目仓库里，给 TypeScript、JavaScript 和 Python 调用。

安装 Koder CLI 安装 Koder TUI

CLI 0.4.0-preview.22 · TUI 0.1.0 · Mac、Linux、Windows 10 和 11

CLI、TUI 和 SDK

三样都不在电脑安装包里，也不需要电脑版。电脑版窗口底部另有自己的终端（⌘J / Ctrl+J），那是普通终端。

Koder CLI

命令是 koder。直接输入 koder 进入对话；koder run 交代一件事，koder ask 只读提问，koder review 审查改动，koder fix 修到检查通过。管道、脚本和 CI 里也能用。快速开始

Koder TUI

命令是 koder-tui。上面是状态栏，中间是对话，右边是侧栏，底下是输入框。改文件先弹出差异，y 接受，n 或 Esc 拒绝。看 TUI

Koder SDK

0.1.0。给你自己的 TypeScript、JavaScript 或 Python 程序调用这台电脑上的 Koder。内核不在仓库里。许可证是 MIT。github.com/KarmenLoop/koder-sdk

第一次输入 koder 打开的设置菜单：光标在语言上，模型一项标着还没配置，下面还有配色、开屏、编辑器、互动教程和体检第一次输入 koder 打开的设置菜单：光标在语言上，模型一项标着还没配置，下面还有配色、开屏、编辑器、互动教程和体检 koder-tui 打开后：顶栏是版本、工作区、模型和模式，左边是折光体和欢迎说明，右边侧栏是会话、用量、已写入和工具，底部是输入框和状态栏koder-tui 打开后：顶栏是版本、工作区、模型和模式，左边是折光体和欢迎说明，右边侧栏是会话、用量、已写入和工具，底部是输入框和状态栏

1 / 2

界面截图：左边是第一次输入 koder 打开的设置菜单，模型一项标着还没配置。右边是 koder-tui 打开后的整屏界面。都是 Koder CLI 0.2.0 和 Koder TUI 0.1.0 在终端里的真实画面，截图时还没有配置模型。

安装 Koder CLI

不需要邀请码。安装命令、脚本会写入的位置、以及它会下载什么，都在项目仓库里。

github.com/KarmenLoop/koder-cli

当前公开安装包是 0.4.0-preview.22。下面的普通安装命令使用 GitHub 上这一版的脚本，不走只收录稳定版的 /releases/latest。先阅读 软件许可、授权与数据说明和 安装包里的法律说明，以及版权、许可与国际用户说明。

macOS、Linux、WSL

打开「终端」，把命令粘贴到这个窗口。管道安装从控制终端读取答案。出现提示后输入 accept 并回车同意；输入 decline、直接回车，或按 Ctrl+C 取消。没有交互、也没有同意时，安装会退出。这不是接口或网络错误。

curl -fsSL https://raw.githubusercontent.com/KarmenLoop/koder-cli/main/install/koder-cli.sh | bash

Windows PowerShell

打开 Windows PowerShell，把命令粘贴到这个窗口。0.4.0-preview.22 会询问同意，并保护被重定向的输入。输入 accept 并回车同意；空回车或无法识别的输入会重新询问，前后空格会被去除。输入 decline 或按 Ctrl+C 取消。同意后会显示当前检查或下载阶段；下载默认上限 100000000 秒，保留进度与取消，默认使用官网同包镜像。Windows 用户真机仍待验收。详细步骤见 GitHub 安装教程。

$ErrorActionPreference='Stop'; $ProgressPreference='SilentlyContinue'; [Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; $u='https://karmenloop.com/install/koder-cli.ps1'; Write-Host ('Koder: loading installer from '+([Uri]$u).Host+'...'); $limit=100000000; if($env:KODER_DOWNLOAD_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 100000000){$limit=$v}else{throw 'KODER_DOWNLOAD_TIMEOUT_SECONDS must be 1..100000000'}}; $connect=30; if($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 3600){$connect=$v}else{throw 'KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS must be 1..3600'}}; $bootstrapLimit=[Math]::Min($limit,$connect); $client=New-Object Net.WebClient; $client.Encoding=[Text.Encoding]::UTF8; $clock=[Diagnostics.Stopwatch]::StartNew(); $next=5; try{$task=$client.DownloadStringTaskAsync([Uri]$u); $wait=([IAsyncResult]$task).AsyncWaitHandle; while(-not $wait.WaitOne(200)){if($clock.Elapsed.TotalSeconds -ge $bootstrapLimit){if($limit -le $connect){throw ('Installer download timed out after '+$limit+'s')}; throw ('Installer bootstrap stalled after '+$connect+'s')}; if($clock.Elapsed.TotalSeconds -ge $next){Write-Host ('Still loading installer: '+[int]$clock.Elapsed.TotalSeconds+'s elapsed. Ctrl+C cancels.'); $next+=5}}; $script=$task.GetAwaiter().GetResult()}finally{$client.CancelAsync(); $client.Dispose()}; Invoke-Expression $script

Windows CMD

打开命令提示符，完整粘贴下面一行并回车。命令会立即显示下载来源，并每五秒报告进度；阅读许可后输入 accept。同意方式与 PowerShell 相同。

powershell -NoProfile -ExecutionPolicy Bypass -Command "$ErrorActionPreference='Stop'; $ProgressPreference='SilentlyContinue'; [Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; $u='https://karmenloop.com/install/koder-cli.ps1'; Write-Host ('Koder: loading installer from '+([Uri]$u).Host+'...'); $limit=100000000; if($env:KODER_DOWNLOAD_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 100000000){$limit=$v}else{throw 'KODER_DOWNLOAD_TIMEOUT_SECONDS must be 1..100000000'}}; $connect=30; if($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 3600){$connect=$v}else{throw 'KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS must be 1..3600'}}; $bootstrapLimit=[Math]::Min($limit,$connect); $client=New-Object Net.WebClient; $client.Encoding=[Text.Encoding]::UTF8; $clock=[Diagnostics.Stopwatch]::StartNew(); $next=5; try{$task=$client.DownloadStringTaskAsync([Uri]$u); $wait=([IAsyncResult]$task).AsyncWaitHandle; while(-not $wait.WaitOne(200)){if($clock.Elapsed.TotalSeconds -ge $bootstrapLimit){if($limit -le $connect){throw ('Installer download timed out after '+$limit+'s')}; throw ('Installer bootstrap stalled after '+$connect+'s')}; if($clock.Elapsed.TotalSeconds -ge $next){Write-Host ('Still loading installer: '+[int]$clock.Elapsed.TotalSeconds+'s elapsed. Ctrl+C cancels.'); $next+=5}}; $script=$task.GetAwaiter().GetResult()}finally{$client.CancelAsync(); $client.Dispose()}; Invoke-Expression $script"

接受许可不会授权管理员、全盘访问、上传、习惯学习、记忆同步、应用访问、收发消息或付费调用。KARMENLOOP 官方团队，所在地中国上海，邮箱 info@karmenloop.com。

已经阅读并同意的自动部署

只有已经读过许可并有权同意的人，才在单独的部署里设置 KODER_EULA_ACCEPT=1。它不能代替上面的普通安装，也不能替没有读过许可的人预先填写。用完后清掉这个变量。

curl -fsSL https://raw.githubusercontent.com/KarmenLoop/koder-cli/main/install/koder-cli.sh | KODER_EULA_ACCEPT=1 bash
$env:KODER_EULA_ACCEPT = "1"
$ErrorActionPreference='Stop'; $ProgressPreference='SilentlyContinue'; [Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; $u='https://karmenloop.com/install/koder-cli.ps1'; Write-Host ('Koder: loading installer from '+([Uri]$u).Host+'...'); $limit=100000000; if($env:KODER_DOWNLOAD_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 100000000){$limit=$v}else{throw 'KODER_DOWNLOAD_TIMEOUT_SECONDS must be 1..100000000'}}; $connect=30; if($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 3600){$connect=$v}else{throw 'KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS must be 1..3600'}}; $bootstrapLimit=[Math]::Min($limit,$connect); $client=New-Object Net.WebClient; $client.Encoding=[Text.Encoding]::UTF8; $clock=[Diagnostics.Stopwatch]::StartNew(); $next=5; try{$task=$client.DownloadStringTaskAsync([Uri]$u); $wait=([IAsyncResult]$task).AsyncWaitHandle; while(-not $wait.WaitOne(200)){if($clock.Elapsed.TotalSeconds -ge $bootstrapLimit){if($limit -le $connect){throw ('Installer download timed out after '+$limit+'s')}; throw ('Installer bootstrap stalled after '+$connect+'s')}; if($clock.Elapsed.TotalSeconds -ge $next){Write-Host ('Still loading installer: '+[int]$clock.Elapsed.TotalSeconds+'s elapsed. Ctrl+C cancels.'); $next+=5}}; $script=$task.GetAwaiter().GetResult()}finally{$client.CancelAsync(); $client.Dispose()}; Invoke-Expression $script
Remove-Item Env:KODER_EULA_ACCEPT
set "KODER_EULA_ACCEPT=1"
powershell -NoProfile -ExecutionPolicy Bypass -Command "$ErrorActionPreference='Stop'; $ProgressPreference='SilentlyContinue'; [Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; $u='https://karmenloop.com/install/koder-cli.ps1'; Write-Host ('Koder: loading installer from '+([Uri]$u).Host+'...'); $limit=100000000; if($env:KODER_DOWNLOAD_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 100000000){$limit=$v}else{throw 'KODER_DOWNLOAD_TIMEOUT_SECONDS must be 1..100000000'}}; $connect=30; if($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS){$v=0; if([int]::TryParse($env:KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS,[ref]$v) -and $v -ge 1 -and $v -le 3600){$connect=$v}else{throw 'KODER_DOWNLOAD_CONNECT_TIMEOUT_SECONDS must be 1..3600'}}; $bootstrapLimit=[Math]::Min($limit,$connect); $client=New-Object Net.WebClient; $client.Encoding=[Text.Encoding]::UTF8; $clock=[Diagnostics.Stopwatch]::StartNew(); $next=5; try{$task=$client.DownloadStringTaskAsync([Uri]$u); $wait=([IAsyncResult]$task).AsyncWaitHandle; while(-not $wait.WaitOne(200)){if($clock.Elapsed.TotalSeconds -ge $bootstrapLimit){if($limit -le $connect){throw ('Installer download timed out after '+$limit+'s')}; throw ('Installer bootstrap stalled after '+$connect+'s')}; if($clock.Elapsed.TotalSeconds -ge $next){Write-Host ('Still loading installer: '+[int]$clock.Elapsed.TotalSeconds+'s elapsed. Ctrl+C cancels.'); $next+=5}}; $script=$task.GetAwaiter().GetResult()}finally{$client.CancelAsync(); $client.Dispose()}; Invoke-Expression $script"
set "KODER_EULA_ACCEPT="

快速开始

从打开终端到第一处修改，六步。每一段命令右边都有复制。

  1. 按仓库里的说明安装

    安装命令和每一步写在 项目仓库。装好后输入 koder。

  2. 打开设置

    安装结束会进入设置。用方向键或鼠标选择语言、模型和配色，改完自动保存。之后随时可以再打开，或只切换语言：

    koder setup
    koder lang en

  3. 连接一个模型

    Koder 不含模型。你自己选服务、取得密钥，并和那家服务商结算。下面以 OpenAI 为例，先把密钥放进环境变量，再让 Koder 读这个变量：

    export OPENAI_API_KEY="你的密钥"
    koder model set --preset chatgpt --key-env OPENAI_API_KEY

    Windows 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

  4. 进入项目文件夹，开始对话

    cd 你的项目文件夹
koder

    直接输入要做的事，回车。/help 看命令，/setup 打开设置，/lang en 切英文，/exit 或 Ctrl+D 退出。默认在当前工作区操作；主目录或其他目录访问需在 koder permissions 中另行授权，系统权限仍由操作系统控制。

    第一次输入 koder 打开的设置菜单：光标在语言上，模型一项标着还没配置，下面还有配色、开屏、编辑器、互动教程和体检第一次输入 koder 打开的设置菜单：光标在语言上，模型一项标着还没配置，下面还有配色、开屏、编辑器、互动教程和体检
    界面截图：第一次输入 koder 打开的设置菜单。模型一项标着还没配置，方向键或鼠标可以选择。

  5. 确认修改

    也可以不进对话，一句话交代：

    koder run "npm test 没过，修一下 cart.mjs 里的 total()"

    默认智能判断会处理普通项目修改和低风险命令。要逐项确认，先运行 koder permissions execution ask；这时会展示红绿差异，输入 y 接受，其他答案拒绝。敏感操作仍需实际许可。

    koder run 修 cart.mjs：先给出修改前后的对比，红色是删掉的行，绿色是新增的行，然后问接受这个修改，输入 y 接受koder run 修 cart.mjs：先给出修改前后的对比，红色是删掉的行，绿色是新增的行，然后问接受这个修改，输入 y 接受
    界面截图：koder run 修 cart.mjs，停在“接受这个修改？”。截图时接的是本机一个按脚本回复的测试接口，不是真实模型。

  6. 跟着教程走

    终端里是 30 课互动教程，进度会记住。--print 只印文字。--os 换成 powershell、cmd、mac 或 linux 的讲法。第 16 课是安装和更新。

    koder learn
    koder learn 3
    koder 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-gate

koder ci init

写入 .github/workflows/koder.yml。PR 打开或更新时审查并评论；在 PR 里评论 /koder review、/koder fix 等会触发对应动作，修改类指令只接受仓库成员。

koder ci init

koder update · koder uninstall

更新到最新版；卸载 Koder CLI，加 --purge 同时删除配置。

koder update
koder help review 的输出：用法、审查时收集哪些上下文、全部选项和三个例子koder help review 的输出：用法、审查时收集哪些上下文、全部选项和三个例子
界面截图：koder help review 列出用法、全部选项和例子。
通用选项作用
-w --workspace工作区，默认当前目录
-y --yes按执行许可自动处理修改和命令；敏感操作仍须有效许可，不代答问题或收集密码
--json每行输出一个 JSON 事件，方便脚本读取
--modestandard、code、minimal、plan、execute、report、enhance
--lang这一次用中文或英文
--no-color关闭颜色

Koder TUI 0.1.0

占满一屏的终端界面

  • 顶栏是版本、工作区、模型和模式。中间是对话，底下是输入框和状态栏。
  • 右边侧栏是会话、用量、已写入和工具。终端宽 110 列以上才显示，/sidebar 可以收起。
  • 改文件先弹出差异窗口：y 接受，n 或 Esc 拒绝。命令也先问。
  • /yes 只自动确认修改和命令；要你选择的问题照样会问，密码从不替你填。
  • 和 koder 共用模型和语言设置。
koder-tui 打开后：顶栏是版本、工作区、模型和模式，左边是折光体和欢迎说明，右边侧栏是会话、用量、已写入和工具，底部是输入框和状态栏koder-tui 打开后：顶栏是版本、工作区、模型和模式，左边是折光体和欢迎说明，右边侧栏是会话、用量、已写入和工具，底部是输入框和状态栏
界面截图：koder-tui 打开后的整屏界面，还没有配置模型。

安装 Koder TUI

不在电脑安装包里，也不需要邀请码。安装命令、脚本和会下载的内容，与 CLI 写在同一个仓库里。

TUI 0.1.0 使用独立安装包和五步 /learn，不能把 CLI 0.4.0-preview.22 的新功能当成 TUI 已升级。下面仍为已发布 TUI 的安装步骤。

Mac

  1. 第一步。按 ⌘ 空格，输入“终端”，按回车，打开终端。
  2. 第二步。在终端里按 ⌘V，粘贴下面这一行，再按回车。它会自己安装。 
    curl -fsSL https://karmenloop.com/install/koder-tui.sh | bash
  3. 第三步。等屏幕上写出安装完成。新开一个终端，输入 koder-tui，再按回车。

Ubuntu

  1. 第一步。按 Ctrl+Alt+T，或在应用里打开“终端”。
  2. 第二步。Ubuntu 里粘贴是 Ctrl+Shift+V。粘贴下面这一行，按回车。如果提示没有 curl，先输入 sudo apt install curl，回车，输入登录密码（输入时画面不显示字符），装完后再粘贴下面这一行。 
    curl -fsSL https://karmenloop.com/install/koder-tui.sh | bash
  3. 第三步。等屏幕上写出安装完成。新开一个终端，输入 koder-tui，再按回车。

其他 Linux

  1. 第一步。打开系统里的终端。
  2. 第二步。粘贴下面这一行再按回车。Ctrl+V 没反应时改用 Ctrl+Shift+V。如果提示没有 curl，先用你平时装软件的办法装上 curl，再做这一步。 
    curl -fsSL https://karmenloop.com/install/koder-tui.sh | bash
  3. 第三步。等屏幕上写出安装完成。新开一个终端，输入 koder-tui，再按回车。

Windows 10 和 Windows 11 · PowerShell

  1. 第一步。打开开始菜单，输入 PowerShell，打开 Windows PowerShell。普通窗口即可，不必用管理员。
  2. 第二步。用鼠标点一下窗口里面。按 Ctrl+V 粘贴下面这一行；没反应就在窗口里点右键再粘贴。然后按回车。 
    irm https://karmenloop.com/install/koder-tui.ps1 | iex
  3. 第三步。等它写出安装完成。关掉窗口，再按第一步打开一个新的 PowerShell，输入 koder-tui，按回车。

Windows 10 和 Windows 11 · cmd

  1. 第一步。打开开始菜单，输入 cmd，打开命令提示符。
  2. 第二步。点一下黑色窗口里面。按 Ctrl+V 粘贴下面这一行；没反应就点右键粘贴。然后按回车。 
    curl -fsSL -o "%TEMP%\koder-tui.cmd" https://karmenloop.com/install/koder-tui.cmd && call "%TEMP%\koder-tui.cmd"
  3. 第三步。等它跑完。新开一个命令提示符，输入 koder-tui，按回车。

Windows XP

  1. 第一步。停在这里。Windows XP 不能运行这条命令，打开终端去粘贴也不会装上。

TUI 快速开始

五步。软件里输入 /learn 还有五步教程。

  1. 按仓库里的说明安装

    安装命令在 项目仓库的 TUI 一节。装好后输入 koder-tui。

  2. 连接模型

    TUI 读 koder setup 写好的模型。已经配过，就不用再配。没装 CLI 的话，先按上面装好，打开 koder setup，或运行 koder model set。也可以在打开 TUI 之前设置这三个环境变量：

    export KODER_MODEL="型号名"
export KODER_BASE_URL="兼容接口地址"
export KODER_API_KEY="你的密钥"

  3. 进入项目文件夹，打开 TUI

    cd 你的项目文件夹
koder-tui

    直接输入任务，Enter 发送，Ctrl+J 换行。不想看开屏动画，加 --no-splash。

  4. 输入 / 打开命令

    输入 / 会弹出命令面板，继续输入会筛选，Tab 补全。

    koder-tui 里输入 /m：弹出斜杠命令面板，列出 /mode 切换工作模式和 /model 查看当前模型配置koder-tui 里输入 /m：弹出斜杠命令面板，列出 /mode 切换工作模式和 /model 查看当前模型配置
    界面截图：输入 /m 后，面板里剩下 /mode 和 /model。

  5. 确认修改

    Koder 要改文件时弹出差异窗口。y 接受，n 或 Esc 拒绝，↑↓ 滚动。Esc 也能中断正在进行的这一轮，已经接受的修改会保留。

    koder-tui 里的修改确认：准备修改 cart.mjs 的窗口里，红色是删掉的行，绿色是新增的行，底部写着 y 接受、n 拒绝、Esc 拒绝koder-tui 里的修改确认：准备修改 cart.mjs 的窗口里，红色是删掉的行，绿色是新增的行，底部写着 y 接受、n 拒绝、Esc 拒绝
    界面截图：准备修改 cart.mjs 的差异窗口，状态栏写着等你确认。截图时接的是本机一个按脚本回复的测试接口，顶栏的模型名 scripted 就是它，不是真实模型。
斜杠命令作用
/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补全斜杠命令

Koder SDK 0.1.1 · 公开源码

TypeScript、JavaScript 和 Python 都能调用这台电脑上的 Koder。JavaScript 包需要 Node.js 22.13 或更高，Python 包需要 Python 3.9 或更高。内核 KARMEN LOOP 不在这个仓库里。许可证是 MIT。安装和调用写在项目仓库里：github.com/KarmenLoop/koder-sdk。公开接口的申请仍在开发者页。不经过 SDK 时，还有两种现成的接法：

  • koder run --yes --json：每行输出一个 JSON 事件，依次有 assistant、pause、decision、tool_result 和最后的 result。脚本默认也采用智能判断；未获许可的敏感操作拒绝执行，--approval ask 可切回逐项确认。
  • 退出码：0 是完成，1 是中断或任务出错，2 是没能运行，比如模型连不上或参数不对。
  • koder acp：通过 ACP 协议在标准输入输出上提供 Koder。Zed、Neovim、Emacs 用它在编辑器里对话、看差异、批准修改，koder editor 显示配置写法。
koder run --yes --json "补上 README 的安装说明"
koder editor zed
koder run --yes --json 的输出：每行一个事件，依次是 assistant、pause、decision、tool_result、assistant 和 resultkoder run --yes --json 的输出：每行一个事件，依次是 assistant、pause、decision、tool_result、assistant 和 result
界面截图：koder run --yes --json 的输出，一行一个事件。截图时接的是本机一个按脚本回复的测试接口，不是真实模型。

常见问题

需要邀请码吗？

不需要。CLI 和 TUI 都直接安装。只有电脑安装包下载时要邀请码。

需要管理员或 sudo 吗？

不需要。安装细节在 项目仓库。

密钥存在哪里？

模型设置在 ~/.koder-cli/provider.json，权限 600，只有你自己能读。用 --key-env 时文件里只有变量名，密钥留在你的环境变量里。

Windows XP 能用吗？

不能。Windows XP 不能运行这些命令。Windows 需要 10 或 11。

和电脑版 Koder 是什么关系？

互相独立。电脑版是一扇窗口，见 Koder IDE；CLI 和 TUI 只在终端里，不用装电脑版。

彩蛋结束，马上回到当前终端

preview.22 精简了独立彩蛋结束后的进程等待。完整播放仍是六秒，任意键可跳过；对话里的设置和彩蛋会回到同一个输入提示。

preview.21：记忆权限有问题，对话也能继续

修复 MEMORY_ACCESS_ISOLATION_UNVERIFIED 导致每次对话都中断的问题。无法验证记忆目录时，保留旧记录并暂停历史读写、个性化与同步，当前任务用临时内存会话继续；不偷偷换目录。关闭或手动更新后临时对话不恢复，自动安装会等待。

输入 /memory diagnose 或 koder memory diagnose --json 查看目录与建议。Windows 已私有的继承权限可安全固定，已有访问规则不增加；存在其他用户权限或目录无法验证时继续保护旧记忆。切换账号会清除临时上下文，执行授权仍单独检查。

preview.20：任务不中断，菜单就地打开

在当前 koder › 输入框里输入 /menu、菜单 或 koder setup，直接打开设置。彩蛋用 /celebrate、彩蛋菜单 或 koder celebrate；自主学习状态用 /growth status。不用另外开命令窗口。

Esc 退出设置，回车跳过彩蛋菜单，任意键跳过动画；返回后继续输入任务。也修复了普通任务包含“官网”时误弹品牌介绍的问题：重绘、开发、修改网站等请求继续进入任务引擎。

preview.19：内置自研自主学习 Skill

KARMEN LOOP 的 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 策略。授权恢复与排错说明。

已知 Bug：以下接口暂时无法使用

MiMo Token Plan、Kimi API、Kimi Code、DeepSeek、阿里云 Token Plan、火山 Coding Plan 和火山方舟按量 API 暂不支持。设置里置灰；已有配置保留，但不能启用、测试或执行。不要反复更换密钥，也不会自动切换其他服务或备用引擎。

Koder 直接适配 Chat Completions、Messages 和 Responses。型号目录于 2026 年 10 月 20 日核对，已补入 GPT-6.1 Sol、Claude Sonnet 5.5、Gemini 4 Argon、MiniMax-M3.1-Flash、Mistral Large 4 等任务型号，移除停服及不适用入口。用 koder model test --tools 验证自己的账号；本地协议测试不代表账号权限已通过。koder model refresh 可读取当前账号的最新型号，保留所选模型和密钥。

0.4.0-preview.22：原生接入与智能审批

保留流式响应、工具调用和旧会话恢复的修复。MiMo 按量 API 与 Token Plan 是独立产品；Token Plan 当前禁用。恢复旧会话后只说“你好”不会自动重做旧任务，明确要求继续仍可使用历史。协议回放不代表真实账号验收，用户故障机器仍未验证。

同意后立即显示 Windows 与 Node.js 检查阶段。现有 Node 检测最多等待 5 秒；下载每 5 秒显示进度，默认下载上限 100000000 秒，Ctrl+C 可取消。默认使用官网同包镜像，无法连接时尝试 GitHub 或 Node.js 官方源，校验不匹配仍会停止。许可正文和校验值保持不变。

preview.7/8 用户可运行 koder update。preview.6 及更早版本遇到许可摘要不同而停止时，请运行本页的普通安装命令，阅读后明确输入 accept；KODER_EULA_ACCEPT 不会绕过旧更新器的摘要检查。覆盖安装保留配置、记忆和渠道绑定，不必卸载或重新配置。

preview.6 起启动的会话可在安全节点自动接回工作区、会话、待处理输入与渠道绑定；正在等待批准或执行中的任务会延迟切换，不重放已完成操作。从 preview.5 及更早版本过来时，先正常结束旧会话并重新打开一次。

学习、当天状态、自我进化和主动服务四项默认关闭。共享空间需要兼容 Core、账号和明确关联：群成员能使用关联私聊记忆，群回复对群内可见。模型密钥和电脑授权不作为记忆同步。

应用、Gamma 和 MCP 需真实凭据或授权；连接成功要再核实际工具，外部写入遵守本机审批设置与已有应用授权。Windows 真机、真实渠道及多设备仍待验收。完整操作见双语四终端 30 课。

SDK 完整入门

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 地区辅助默认关闭并分别确认。中文与英文祝福来自 KARMEN LOOP 团队。

音乐默认在本机生成；浏览器拦截自动播放时可点播放，不绕过限制、不反复开窗。手动语言与主动开启的本机常用语言计数优先，IP 仅作弱提示。koder celebrate auto off 和 koder celebrate music off 可分别关闭。

教程已扩展为 30 课，新增套餐、MiMo 工具续答、隐私、反馈与庆祝章节。查看完整教程。

接口状态与智能审批

Kimi 与 DeepSeek 当前暂不可用。保留的底层协议测试与恢复代码不代表这些入口已经恢复；重新开放前需要单独验收。

默认智能判断：低风险检查与普通项目修改自动执行；敏感操作可本次允许、始终允许或全面开放。koder permissions execution status 查看；koder permissions execution full --confirm FULL 保存本项目全面开放；加 --scope profile 明确设置全部项目；koder permissions execution reset 撤销全部执行设置。全面开放可运行代码、改删文件和操作已授权应用，不代填密码或取得系统权限。许可仅保存在本机，不作为记忆同步。

接入与排障教程

个人使用与公司授权

明确采用 Koder-EULA-1.1 的 CLI 新发行版允许免费个人非商业使用。商用、有偿客户工作及组织内部部署须另获书面授权；个人许可不包含二次开发或修改自有实现代码。第三方与旧版本原有许可不变。

KARMEN LOOP 本地任务内核串起计划、权限核对、工具执行与结果记录。官网只介绍公开能力，不公开私有开发源码。

公司授权服务＋专用私有仓库：info@karmenloop.com。人数、部署、仓库内容、维护、支持及开发权以另行书面协议为准；洽询入口不会自动创建仓库或授予商业权利。

喜欢 Koder？欢迎自愿为项目点一颗 Star，直接跳过也不影响使用。

本机私有合集可按需检索技能与模板，默认不向模型开放；明确授权后，只发送选中的片段。原始合集不随官网或公共安装包分发，不自动运行其中脚本。详见 私有资料库说明；商业授权说明运行 koder business。

官方加密工作流资料库可按需查询，不预装整库。首次开放 1,004 份许可明确的 Koder 整理版技能；必要版权声明随片段保留。检索词与资源编号会发送到官方服务，请勿填入私人数据；设置 KODER_REMOTE_RESOURCES=0 可关闭。了解远程资料与隐私。