安装

最新的自包含发行版可以安装在 Linux x64、Linux ARM64、macOS ARM64 或 Windows x64 上。安装器会下载匹配的标准发行资产 CrystalCode-<os>-<architecture>.zip，然后替换 ~/.crystal/binaries/code/ 中的完整发布内容。

在 Linux 或 macOS 上，运行：

curl --fail --location --show-error \
  https://crystalcode.ink/install.sh | sh

在 Windows PowerShell 中：

Invoke-RestMethod `
  -Uri https://crystalcode.ink/install.ps1 | Invoke-Expression

若要在运行安装器前检查它，请先下载到文件，再手动运行。

安装器不写入凭据。

在 Linux 和 macOS 上，安装器向所选的 zsh 或 bash 配置文件写入 # Crystal Code CLI (Installer) 块。该块把 CrystalCode 目录加入 PATH，并把 crystal 别名到 CrystalCode。在 Windows 上，它把该目录加入用户 PATH。

打开新终端。Linux 或 macOS 运行 crystal，Windows 运行 CrystalCode。

要求

推荐使用 Linux 和 macOS。在 Windows 上，请安装 Git for Windows，以便 Git Bash 在 PATH 中提供 bash。

所选提供商的 API 密钥，放在 ~/.crystal/credentials.json，或仅用于一次启动的进程环境变量中（见凭据）
用于交互式备用屏幕 UI 的 TTY。crystal run 不需要 TTY
PATH 中有 bash（在 Windows 上，存在 Git Bash 时会使用它）

从源码构建还需要：

.NET 10 或 .NET 11 SDK
位于 ../Crystal 的 Crystal 同级检出（相对于本仓库根目录）

把两个仓库克隆到同一个父目录：

git clone https://github.com/YELANDAOKONG/CrystalCode.git
git clone https://github.com/YELANDAOKONG/Crystal.git

所需的目录布局、构建、测试和本地安装步骤见从源码构建。

版本

crystal version 和 crystal --version 打印构建身份并退出。它们不会打开终端，也不会读取配置。

crystal plugins 和 crystal tools 列出、显示、启用或禁用一个目录。除非设置 --format text，否则它们打印 Spectre.Console 表格。它们不会打开会话，也不会写入 config.json。

crystal promptsets 和 crystal prompt-attachments 对 prompt.json 做同样的事。提示集仅限 Home：list、show、enable 和 disable 接受 --home 和 --format text。启用一个集会关闭其他集。提示附件还接受 --workspace 和 --source home|project。这两个命令都不会创建缺失的目录，也不会写入 config.json。

Crystal Code   3f2a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a
Crystal        1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d
SDK            10.0.201
Configuration  Debug

Runtime        .NET 10.0.4
OS             Ubuntu 24.04.2 LTS x64

行	含义
`Crystal Code`	本仓库的提交
`Crystal`	Crystal 库的提交
`SDK`	编译该可执行文件的 .NET SDK
`Configuration`	可执行文件上的 MSBuild 配置，通常是 `Debug` 或 `Release`
`Runtime`	承载此进程的共享框架
`OS`	操作系统描述加上架构

空行把构建和进程宿主分开。未记录的值省略该行。空的部分连同空行一起省略。上面的值都是示例。