概览

Crystal Code 是面向本地仓库的编码 TUI。终端是唯一的操作者界面。它流式运行模型与工具循环，带 Plan 和 Work、审批、压缩，操作者数据在 ~/.crystal。

crystal run 不打开终端，运行一项任务。任何会询问操作者的操作都会被拒绝。

Crystal Code 使用 Crystal 库。它不修改 Crystal，也不替代 Crystal。

它能做什么

在你希望代理检查或修改的工作区中：

• 流式输出带工具调用的回合，并在回合进行时把后续请求入队。
• 在限流、服务器错误、超时、网络故障和不完整流上重试失败的模型轮次。
• 用 /model 切换提供商和模型。
• Plan 只读取。Work 可以编辑、写入和运行 shell。
• 手动审批副作用，或由审查模型、策略放行。
• 用量接近所选窗口时压缩上下文。
• 在 ~/.crystal 保存配置、权限和会话。
• 调用 DeepSeek、OpenAI 兼容的 Chat Completions、OpenAI Responses 和 Anthropic Messages，包括你添加的端点。

内置工具和提供商适配器注册在同一张进程内插件表上。工具集放在 ~/.crystal/tools 和 <workspace>/.crystal/tools。插件放在 ~/.crystal/plugins 和 <workspace>/.crystal/plugins。

尚未实现

当前构建没有：MCP 服务器、操作系统沙箱、父/子代理、音频和视频输入、非文本模型输出、在 TUI 中编辑提供商定义，以及从提供商拉取模型列表。

内置协议是 DeepSeek、OpenAI 兼容 Chat Completions、OpenAI Responses、Anthropic Messages、Gemini 和 Ollama。插件可以再加一种协议。模型和提供商支持时，可以使用图像输入。