karmen@local:~/koder $ tutorials[ 0.5.21 ]

KARMENLOOP / COMMAND LINE

KODER CLI / 使用教程

从这里开始使用 Koder CLI。

在终端里交代任务，连接你自己的模型，敏感操作先由你确认。

[ 下载安装 ][ 查看版本 ]

macOS / Linux / Windows

CURRENT / 0.5.21

安装后进入对话，出错时查看具体原因。

安装完成或启用常驻不等于已经进入对话。先运行 koder setup，再运行 koder；看到 koder > 后才输入任务。任务未完成时，用 /error 查看原因，用 /error copy 复制脱敏报告；复制不会自动上传。

[ 安装与首次启动 ][ 错误代码与报告 ][ 完整功能导航 ]

LEARN / KODER CLI

从第一个真实任务开始。

安装 CLI、配置模型、选择项目，再检查即将执行的操作。

[ 完整使用指南 ][ 1800 课目录 ]

CLI 内置 1,800 课中文课堂，运行 koder learn 进入；这里提供课程目录，原有英文课程继续保留。

快速开始

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

按仓库里的说明安装

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

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

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
```
运行 koder model presets 查看当前版本的预设。密钥通过 Setup 或 --key-env 配置，不要贴入任务对话。不可用的服务商会在 Setup 中禁用；凭据保存方式和提供商限制请查看完整指南，再运行：
```
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 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 CLI 0.5.21 的 review 帮助输出：用法、选项与示例。 — Koder CLI 0.5.21 · 正式程序帮助输出 · 由采集的终端字符渲染。

通用选项	作用
`-w` `--workspace`	工作区，默认当前目录
`-y` `--yes`	按执行许可自动处理修改和命令；敏感操作仍须有效许可，不代答问题或收集密码
`--json`	每行输出一个 JSON 事件，方便脚本读取
`--mode`	standard、code、minimal、plan、execute、report、enhance
`--lang`	这一次用中文或英文
`--no-color`	关闭颜色

KODER CLI / 使用教程

安装后进入对话，出错时查看具体原因。

从第一个真实任务开始。

按仓库里的说明安装

打开设置

连接一个模型

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

确认修改

跟着教程走