主题
安装
一条命令装完。这页还列了三类最常见的失败，以及它们的原样报错文本—— 照着报错找对应小节就行，不用通读。
支持 macOS 与 Linux，arm64 与 x64。Windows 目前不支持（脚本会直接报错退出，不会装坏东西）。
发布服务器在团队内网，curl 需要在公司网络或 VPN 下执行；连不上的排查见失败三。
快速上手
bash
curl -fsSL http://121.196.144.227/releases/sid-code/install.sh | bash
sid-code --version # 确认装上了装完还不能用，还差一步
sid-code 不带模型。装完只是有了这个壳，还得告诉它去哪调模型： 配置 LLM Provider（三族协议各一份可直接粘的配置； 或者直接跑 sid-code 让 TUI 的分步引导问你要哪个）。
配好之后再启动。跳过这步直接启动，打第一句话就会报模型错误——那不是装坏了。
首次安装后命令找不到？
安装脚本会把 PATH 写进你的 shell 配置文件，但当前这个终端窗口读不到新配置。 重开一个终端，或按脚本最后提示的那行 source ~/.zshrc 执行一次。 详见下面的失败一。
它装了什么、装到哪
脚本全程非交互，不需要 sudo，所有东西都在你的家目录下：
| 路径 | 内容 |
|---|---|
~/.local/share/sid-code/versions/<版本号>/ | 二进制本体，按版本号分目录 |
~/.local/bin/sid-code | 软链接，指向当前版本 |
~/.sid-code/ | 你的配置、会话记录、日志 |
~/.zshrc（或 .bash_profile / .bashrc） | 追加一段 # >>> sid-code >>> 标记块，写 PATH 和 sc 别名 |
几条值得知道的性质：
- 只追加，不覆盖。 写 shell 配置时只在文件末尾追加带标记的块，不动你原有的任何内容； 你已经有同名
sc别名的话它尊重你的，不覆盖。 - 保留两个旧版本。 升级不删旧版，只保留最新 2 个，出问题可以手动切回去。
- 已有配置绝不动。
~/.sid-code/settings.json存在时脚本完全跳过配置写入—— 升级场景不会把你的 API Key 冲掉。 - 下载有校验。 sha256 不匹配就中止，且中止发生在切换软链接之前， 现有安装不受影响。校验通过后还会跑一次
--version冒烟测试，挡住"校验过了但架构不对"。
装完你会看到：
text
╔══════════════════════════════════════╗
║ 安装完成！v0.1.592
╚══════════════════════════════════════╝
现在可以运行：
sc # 启动（推荐，跳过权限确认）
sid-code # 启动（需逐条确认权限）
sid-code --version # 确认版本
sid-code update # 以后升级到最新版本sc 别名跳过了权限确认
安装脚本写的 sc 别名等价于 sid-code --dangerously-skip-permissions， 意思是它改文件、跑命令都不再问你。这对熟手顺手，但第一次用建议直接跑 sid-code， 把每一步确认看清楚（跑通第一个任务就是这么演示的）。 两种模式的边界见权限与人工确认。
指定版本安装
bash
# 锁定某个版本（回滚场景）
curl -fsSL http://121.196.144.227/releases/sid-code/install.sh | SID_CODE_VERSION=0.1.590 bash| 环境变量 | 作用 |
|---|---|
SID_CODE_VERSION | 锁定安装版本，默认读服务器 latest.txt |
SID_CONFIG_DIR | 配置目录，默认 ~/.sid-code |
RELEASE_BASE | 下载地址前缀，默认内置团队服务器 |
升级与卸载
bash
sid-code update # 升级到最新版（不动 ~/.sid-code/ 里的配置和会话）卸载没有专门命令，手工删三处即可：
bash
rm -rf ~/.local/share/sid-code # 二进制
rm -f ~/.local/bin/sid-code # 软链接
rm -rf ~/.sid-code # 配置与会话（想留着下次用就别删）再从 shell 配置文件里删掉 # >>> sid-code >>> 到 # <<< sid-code <<< 之间那段。
常见问题
失败一：command not found: sid-code
装完当场就报这个，是最高频的一个，而且几乎总是同一个原因： PATH 写进配置文件了，但当前窗口还没读到。
text
zsh: command not found: sid-code按顺序试：
bash
# 1. 先确认二进制真的装上了（这条能出版本号说明只是 PATH 问题）
~/.local/bin/sid-code --version
# 2. 让当前窗口读新配置（或者干脆重开一个终端）
source ~/.zshrc # zsh
source ~/.bash_profile # macOS + bash
source ~/.bashrc # Linux + bash
# 3. 确认 PATH 里有了
echo $PATH | tr ':' '\n' | grep '.local/bin'如果第 1 步就没有输出，那是下载或解压没成功，重跑一次安装命令。
如果第 3 步始终 grep 不到，说明脚本没找到该写哪个文件——它遇到两种情况会跳过写入 并打印 ⚠️ 提示：shell 不是 zsh/bash，或者目标配置文件不存在 （脚本刻意不替你创建新的 rc 文件，因为凭空创建 .bash_profile 会改变 你 shell 的加载行为）。这两种情况手动加两行：
bash
export PATH="$HOME/.local/bin:$PATH"
alias sc='sid-code --dangerously-skip-permissions'失败二：架构或系统不支持
text
❌ 不支持的架构: i386
❌ 不支持的操作系统: MINGW64_NT-10.0（目前仅支持 macOS / Linux）前者是 32 位机器，后者通常是在 Windows 的 Git Bash 里跑。 Windows 用户走 WSL2，在 WSL 里跑同一条 curl 命令即可。
值得单说一下 macOS：uname -m 在 Rosetta 下的 shell 里会返回 x86_64， 于是装的是 x64 版本——能跑，但比原生 arm64 慢。确认一下：
bash
uname -m # Apple Silicon 原生应该输出 arm64输出 x86_64 而你的机器是 M 系列芯片，说明当前终端跑在 Rosetta 下， 换一个原生终端重装。
失败三：下载失败，或权限不对
text
❌ 下载失败: http://121.196.144.227/releases/sid-code/0.1.592/sid-code-0.1.592-darwin-arm64.tar.gz看到这个大概率不是权限，而是连不上服务器（服务器在团队内网，需要公司网络或 VPN）。先单独试一下：
bash
curl -I http://121.196.144.227/releases/sid-code/latest.txt真正的权限问题长这样，通常是家目录下某个目录属主不对（历史上用过 sudo 装东西留下的）：
text
mkdir: /Users/you/.local/bin: Permission denied修：
bash
sudo chown -R "$(whoami)" ~/.local ~/.sid-codemacOS 上还有一类是 Gatekeeper 拦截：
text
"sid-code" cannot be opened because the developer cannot be verified.安装脚本已经对新装的目录做了 xattr -cr 去隔离，正常不会遇到。 真遇到就手动去一次：
bash
xattr -cr ~/.local/share/sid-code装完了但一跑就报模型错误
那不是安装问题，是还没配 provider（sid-code 不带模型）。往下走配置 LLM Provider—— 里面有个 base_url 的 /v1 坑，两族协议规则正好相反，是新手第一大卡点。
相关
- 配置 LLM Provider —— 装完的第一件事
- 跑通第一个任务 —— 配好之后走一遍完整流程
- CLI 参数与子命令 —— 全部参数速查
- 环境变量 —— 含
SID_CONFIG_DIR等