Appearance
系统准备
适用对象：准备配置 Claude Code、Codex、DeepSeek Harness、WorkBuddy、OpenCode 或 Pi，但不确定电脑环境是否满足要求的用户。
预计耗时：5-15 分钟。
先确认你的系统
不同系统的入口不一样，先按下面表格判断。
| 你的电脑 | 建议入口 |
|---|---|
| Windows，不熟悉命令行 | 先用 PowerShell，必要时再使用 WSL |
| Windows，已经会用 WSL | 优先在 WSL 里按 Linux 路线操作 |
| macOS | 使用系统自带终端或 iTerm2 |
| Linux | 使用当前发行版自带终端 |
小白建议
Windows 用户先确认目标工具实际运行在 PowerShell 对应的 Windows 用户环境，还是 WSL。两边的配置文件和已安装命令互不共享。
需要准备哪些本机工具
大多数 Agent 工具至少需要下面几类本机能力。
| 工具 | 用来做什么 | 怎么判断 |
|---|---|---|
| 终端 | 执行导入命令、启动命令行工具 | 能打开 PowerShell、Terminal 或 WSL |
| 浏览器 | 访问连接AI主站及工具官方安装页 | 能打开对应网站 |
| Node.js / npm | 部分 CLI 工具安装或运行需要 | 终端运行 node --version、npm --version |
| Git | 让 Agent 读写项目、查看变更 | 终端运行 git --version |
不是每个工具都强制需要 Node.js 或 Git。安装失败时，再按报错补装即可。
Windows 准备
方式 A：PowerShell
- 点击开始菜单。
- 搜索 PowerShell。
- 打开后运行：
powershell
node --version
npm --version
git --version如果提示找不到命令，说明对应工具还没安装或 PATH 没生效。
常见处理方式：
- 安装 Node.js LTS。
- 安装 Git for Windows。
- 关闭 PowerShell。
- 重新打开 PowerShell 再检查一次。
方式 B：WSL
如果你已经会使用 WSL，可以在 WSL 终端中运行：
bash
node --version
npm --version
git --versionWSL 中安装的软件和 Windows PowerShell 中安装的软件不是同一套。你在哪个终端使用 Codex CLI，就在哪个终端里检查和安装依赖。
macOS 准备
打开终端，运行：
bash
node --version
npm --version
git --version如果没有 Git，macOS 可能会提示安装 Command Line Tools。按系统提示安装后，重新打开终端再检查。
如果没有 Node.js，可以安装 Node.js LTS。已经使用 Homebrew 的用户，也可以按自己熟悉的方式安装。
Linux 准备
打开终端，运行：
bash
node --version
npm --version
git --version如果缺少工具，请用你的 Linux 发行版包管理器安装。不同发行版命令不同，常见方向是：
| 系统 | 常见包管理器 |
|---|---|
| Ubuntu / Debian | apt |
| Fedora | dnf |
| Arch Linux | pacman |
安装完成后，关闭终端并重新打开，再检查版本。
网络和代理准备
如果连接AI告诉你“需要代理”，请先确认代理已经能正常使用。
你可以这样判断：
- 浏览器能打开
https://lianjieai.top。 - Agent 工具中有代理设置时，按工具说明填写。
- 如果只有终端需要代理，先确认当前终端代理已经生效。
如果你在公司网络、校园网或公共 Wi-Fi 下遇到连接超时，优先换一个网络测试。
项目目录准备
第一次测试建议使用临时目录，不要直接在重要项目里让 Agent 修改文件。
Windows PowerShell：
powershell
mkdir lianjieai-agent-test
cd lianjieai-agent-testmacOS / Linux / WSL：
bash
mkdir lianjieai-agent-test
cd lianjieai-agent-test进入临时目录后，再打开你已配置的编程助手测试。
下一步
完成系统准备后：
- 继续看 准备接入信息，确认 Base URL、API Key、Model 和 Provider。
- 如果你想用命令行，继续看 安装 Codex CLI。
- 如果你想用图形界面，继续看 codex。
- 如果你想统一切换多个工具，继续看 使用 CC Switch。
完成检查
- 已知道自己应该使用 PowerShell、WSL、macOS 终端还是 Linux 终端。
- 已能打开终端。
- 已检查
node --version、npm --version、git --version。 - 已确认是否需要代理。
- 已准备好一个临时测试目录。