czagent
快速入门
从下载安装到发出第一条消息，完整跑通一遍大约需要 10 分钟。
一、下载并安装
打开 GitHub Releases，按平台下载：
- Windows：
czagent Setup <版本>.exe（NSIS 安装包，可选安装目录），或同目录下的czagent <版本>.exe便携版，免安装单文件直接运行。 - macOS：
.dmg镜像，拖入「应用程序」即可。 - Linux：
.AppImage加执行权限直接运行；或sudo dpkg -i czagent_<版本>_amd64.deb安装。
二、首次启动
czagent 目前未做代码签名：Windows 首次运行会弹 SmartScreen 提示，点「更多信息 → 仍要运行」；macOS 提示无法验证开发者时，到「系统设置 → 隐私与安全性」手动放行。软件开源，安装包可自行从源码构建验证。
三、配置第一个模型
czagent 不内置任何模型 Key，需要你用自己平台账号申请（以 DeepSeek 为例，其他平台同理）：
- 申请 API Key在 DeepSeek 开放平台注册并创建一个 API Key，复制备用。
- 打开设置 → 模型侧栏底部齿轮进入设置页，切到「模型」标签。
- 添加对话模型点「添加模型」，接口实现选 DeepSeek（地址会预填），粘贴 Key 与模型名（如
deepseek-chat），保存。 - 设置能力绑定在「能力绑定」区把「对话」绑定到刚添加的模型。图像、视频、语音等多模态能力同理，用到哪个绑哪个。
Key 只保存在本机配置文件里，随对话数据一起留在本地，不会上传。除 DeepSeek 外，开箱即支持的还有硅基流动、Agnes、智谱 BigModel、通义千问、OpenRouter 以及任意 OpenAI 兼容服务。
四、新建会话，发出第一条消息
- 新建会话侧栏点「新建会话」，按需选择：
- 模式：对话（跟模型聊）或脚本（运行工作目录的 czagent.ts，进阶玩法见高级应用）
- 工作目录：智能体读写文件的边界，默认
~/czworkspace，做项目就选项目目录 - 模型：默认用绑定的对话模型，可临时切换
- 发送第一条消息输入框回车发送。回答流式输出；开启思考模式后，思考过程会内联在正文上方实时显示。
- 认识工具卡片当智能体要读文件、执行命令时，消息流会出现工具卡片：准备中 → 执行中 → 已完成 / 失败，参数可折叠查看，全程可见。
- 权限确认涉及工作目录外写入或危险命令时，会弹出权限卡，三选一：「允许本次」「允许本次及以后（写入规则）」「拒绝」。
五、下一步
- 日常对话技巧、附件理解、任务清单与 Plan→Build 工作流 → 基础应用
- 自定义 Agent、技能、MCP、脚本编排 → 高级应用
- 遇到问题先看 常见问题，或到 GitHub Issues 反馈。