安装与起步

安装 CrabCode TUI、修好 PATH、登录账号并跑第一个会话。

是什么

CrabCode TUI 是终端里的主入口。装好 crabcode 命令后，在项目目录里运行它，CrabCode 会把当前目录当作工作区，读代码、编辑文件、跑命令、管理会话，并在需要时向你请求确认。

公开安装入口主要有两类，具体程序目录按地区和平台不同：

路径	适合谁	程序目录
`/downloads` 页面	普通用户，按地区和平台复制命令	见下方平台说明
release `install.sh`	macOS / Linux 用户，想使用镜像优先、校验和 fail-closed 的安装脚本	`${CRABCODE_HOME:-$HOME/.crabcode}/bin`

下载页里：

macOS / Linux 国际区直链常见为 ~/.local/share/crabcode。
macOS / Linux 镜像脚本常见为 ~/.crabcode/bin。
Windows 国内镜像脚本安装到 %LOCALAPPDATA%\CrabCode，设置过 CRABCODE_HOME 时安装到 %CRABCODE_HOME%。
Windows 国际区直链安装到 %LOCALAPPDATA%\crabcode\crabcode-<version>-win-x64。

安装

推荐先到 /downloads 选择地区和平台，复制页面上的当前命令。下载页会跟随发布渠道读取最新稳定版本。

macOS / Linux 也可以直接使用镜像安装脚本：

bash

curl -fsSL https://updates.acosmi.com/crabcode/install.sh | sh
curl -fsSL https://updates.acosmi.com/crabcode/install.sh | sh

安装脚本会自动：

检测 OS 和 CPU 架构。
优先从镜像读取最新版，失败时兜底到 GitHub Releases。
下载对应 tarball 和 checksums-sha256.txt。
校验 SHA256，校验失败会拒绝安装。
安装 crabcode、内嵌运行时、App Server、cron daemon、memory orchestrator 和必要 runtime 文件。
把程序目录写入 shell PATH 提示中。

Windows 用户请使用 /downloads 里与你所在地区匹配的 PowerShell 安装块。国内镜像脚本会安装到 %LOCALAPPDATA%\CrabCode 或 %CRABCODE_HOME% 并写入这个目录；国际区直链会解压到 %LOCALAPPDATA%\crabcode\crabcode-<version>-win-x64 并写入版本化目录。

验证

打开新终端或新 PowerShell：

bash

crabcode --version
crabcode doctor
crabcode --version
crabcode doctor

doctor 会打印版本、平台、git / gh 是否可用、bootstrap 和运行时状态。

如果提示 crabcode: command not found 或 Windows 里找不到命令，先看安装、PATH 与卸载。

首次启动

bash

cd /your/project
crabcode
cd /your/project
crabcode

第一次运行会引导你登录 Acosmi 账号。登录后进入 TUI，你可以直接输入自然语言任务。

第一个会话

直接打字，例如：

shell

帮我把这个文件里所有的 console.log 删掉
帮我把这个文件里所有的 console.log 删掉

CrabCode 会说明准备做什么，触发写文件、执行命令、访问外部工具或越过权限边界时会请求确认。

常用 slash 命令：

命令	用途
`/help`	看所有 slash 命令
`/init`	在仓库根生成 `CRABCODE.md` 项目说明
`/memory`	维护跨会话记忆
`/clear`	清空当前会话上下文
`/model`	切换模型
`/doctor`	在 TUI 内运行诊断
`/release-notes`	查看当前版本更新说明
`/exit`	退出（也可以 Ctrl+D）

升级

重跑同一种安装方式即可。升级只替换程序文件，不会删除 ~/.crabcode 里的登录、配置、会话、记忆或插件。

bash

curl -fsSL https://updates.acosmi.com/crabcode/install.sh | sh
curl -fsSL https://updates.acosmi.com/crabcode/install.sh | sh

如果需要固定版本：

bash

curl -fsSL https://updates.acosmi.com/crabcode/install.sh | CRABCODE_VERSION=v1.2.3 sh
curl -fsSL https://updates.acosmi.com/crabcode/install.sh | CRABCODE_VERSION=v1.2.3 sh

也可以先运行：

bash

crabcode update
crabcode update

具体可用子命令以 crabcode --help 为准。/upgrade 是账号订阅升级，不是二进制升级。

卸载

没有单独的 crabcode uninstall TUI 子命令。卸载请按目标选择：

目标	做法
只卸载程序，保留登录/历史/记忆	删除实际程序目录，并移除 PATH 行
彻底清理本机数据	在卸载程序后，再删除 `~/.crabcode` 和 `~/.crabcode.json`

完整命令见安装、PATH 与卸载。

环境变量

变量	作用
`CRABCODE_HOME`	改安装脚本的 home base；程序默认落 `${CRABCODE_HOME}/bin`
`CRABCODE_CONFIG_DIR`	改配置目录真源，用于隔离账号、会话、记忆和设置
`CRABCODE_VERSION`	固定安装脚本要拉取的版本，如 `v1.2.3`
`CRABCODE_MAX_CONCURRENT_AGENTS`	subagent 并发上限，默认 3，超出会排队
`CRABCODE_DEBUG_LOGS_DIR`	改 debug 日志输出目录
`CRABCODE_DISABLE_CRON`	设为 `1` 时禁用 cron daemon
`HTTPS_PROXY` / `HTTP_PROXY` / `https_proxy` / `http_proxy`	标准代理变量，网络请求会读取这些变量

CRABCODE_CONFIG_DIR 不是 PATH 修复工具。如果命令打不开，优先确认程序目录是否加入 PATH。

常见问题

现象	处理
`crabcode: command not found`	看安装、PATH 与卸载，确认实际程序目录和 shell 配置
`crabcode --version` 还是旧版本	`command -v crabcode` 查看 PATH 里哪个目录排在前面，删除旧目录项
`doctor` 提示缺 `git` 或 `gh`	安装 Git / GitHub CLI，并重开终端
下载失败	换用镜像脚本，或设置 `CRABCODE_VERSION` 固定版本
SHA256 校验失败	不要强行跳过；删除半下载文件后重跑安装
想保留历史但卸载程序	只删程序目录，不删 `~/.crabcode`