安装手册

从零开始：安装、配置、验证、升级

系统要求

一、安装 CLI

前置条件：Node.js 24 或更高版本（CLI 使用 node:sqlite 等内置模块）。没有的话先去 nodejs.org 安装。

1. 检查 Node.js 版本

node --version   # 需要 v24 或更高

如果版本过低，先从 nodejs.org 安装最新的 LTS 或 Current 版本。

2. 全局安装

npm install -g thincoder

Windows 上如果提示权限错误，用管理员身份的终端重试；macOS / Linux 上如果 npm 全局目录无写权限，可先配置用户级 npm 目录（npm config set prefix ~/.npm-global 并把对应 bin 目录加入 PATH），或用 sudo 安装。

3. 验证安装

thincoder -v        # 打印版本号
thincoder --help    # 打印命令说明

4. 首次启动配置

直接运行 thincoder，首次启动会进入设置向导：用方向键选择提供商（内置 18 个预设），输入 API Key，可选配置嵌入服务 Key。配置写入 ~/.thincoder/config.json。

5. 开始使用

thincoder                      # 进入交互式 TUI
thincoder chat "解释这个项目"   # 一次性对话（带工具）
thincoder acp                  # ACP 服务器（供 Zed / JetBrains / Paseo 接入）

二、安装 VS Code 扩展

扩展已上架 VS Code 市场（搜索 ThinCoder 安装）；也支持 .vsix 文件侧载。

1. 获取 .vsix

从 下载页面 或 Gitee 仓库（Releases 或仓库文件）获取 .vsix 文件。

2. 安装

code --install-extension 你下载的.vsix文件路径

或者在 VS Code 扩展面板（Ctrl+Shift+X）右上角 … 菜单 → 从 VSIX 安装…，选择文件即可。

3. 配置 API Key

按 Ctrl+Alt+T（macOS：Cmd+Alt+T）打开面板，点击右下角齿轮 ⚙ 进入设置，在对应的提供商旁点击 Add Key。

注意：CLI、VS Code 扩展与桌面版共用 ~/.thincoder/config.json——在任一处配好 API Key，其余两端直接生效，无需重复配置。

三、安装桌面版

桌面版面向 Windows 10 / 11（x64），安装包从 下载页面 获取（约 108 MB）。

1. 安装

双击 ThinCoder-Setup-<版本>.exe 安装即可——按用户安装，不需要管理员权限。

2. 配置 API Key

桌面版与 CLI、VS Code 扩展共用 ~/.thincoder/config.json——任一端配好即三端生效。首次启动后也可在设置面（菜单 设置 → 设置…）添加。

3. 开始使用

启动后用菜单 文件 → 打开项目… 选择项目目录，会话以标签页多开。界面与完整操作见 桌面版指南。

四、升级与卸载

CLI

thincoder upgrade      # 更新到最新版本
npm uninstall -g thincoder   # 卸载

VS Code 扩展

扩展市场会自动检查更新；也可在扩展面板手动更新。卸载在扩展面板点击卸载即可。

桌面版

启动后自动检查更新并后台静默下载；下载完成后可在菜单 帮助 → 检查更新 一键重启安装，或什么都不做——下次退出应用时自动完成。手动兜底 = 下载新版覆盖安装（配置与会话不丢）。卸载在 Windows「设置 → 应用」中完成。

五、故障排查