安装手册

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

系统要求

一、安装 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，另一处直接生效，无需重复配置。

三、升级与卸载

CLI

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

VS Code 扩展

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

四、故障排查