AI Agent 下载与安装命令总结

2401_89382898

298人浏览 · 2026-06-01 19:33:30

2401_89382898 · 2026-06-01 19:33:30 发布

更新时间：2026-06-01
适用对象：想快速下载、安装、试用不同 AI Agent 的用户。
写作目标：打开这篇 Markdown 后，能直接看到“推荐安装方式”、所需环境、复制命令、启动方式、常见坑点。

0. 总览：最推荐安装方式

Agent	推荐方式	推荐理由	主要环境要求	启动命令
Claude Code	官方 Native Installer	官方推荐、跨平台、最省心	终端、网络、Claude/Anthropic 权限	`claude`
OpenCode	官方 install script	官方文档写明最简单	现代终端、网络、模型 provider/API Key	`opencode`
OpenAI Codex CLI	官方 standalone installer	官方文档推荐，避免手动选二进制	终端、网络、ChatGPT/OpenAI 权限	`codex`
Gemini CLI	npm stable	跨平台、稳定版、官方推荐之一	Node.js 20+、npm、Google/Gemini 权限	`gemini`
Hermes Agent	pip 或官方 git installer	pip 最简单；git installer 适合跟随 main	Python/pip 或 curl/bash、模型 provider	`hermes`
OpenClaw	官方 installer script	自动检测系统、自动处理 Node、启动 onboarding	Node 24 推荐或 Node 22.19+；脚本可自动处理	`openclaw`
Reasonix	`npx reasonix code`	不全局安装，试用最方便	Node、npx、DeepSeek API Key	`npx reasonix code`

1.

2.1 推荐先准备的工具

通用环境/
├── 终端/
│   ├── macOS: Terminal / iTerm2 / Ghostty / WezTerm
│   ├── Linux: GNOME Terminal / Konsole / WezTerm / Alacritty
│   └── Windows: Windows Terminal / PowerShell / Git Bash / WSL2
├── 网络/
│   └── 能访问对应官网、npm、GitHub、模型服务
├── Git/
│   └── 源码安装、GitHub Release、部分工具链会用到
├── Node.js/
│   ├── Gemini CLI: 建议 Node.js 20+
│   ├── OpenClaw: Node 24 推荐，Node 22.19+ 支持
│   ├── Reasonix: DeepSeek 文档要求 Node 20.10+；项目文档常见要求 Node 22+
│   └── OpenCode: npm/bun/pnpm/yarn 方式需要对应 JS 运行环境
├── Python/
│   └── Hermes pip 安装需要 Python 和 pip
└── API Key 或账号/
    ├── Claude Code: Claude / Anthropic 权限
    ├── Codex CLI: ChatGPT / OpenAI 权限
    ├── Gemini CLI: Google 账号或 Gemini API Key
    ├── Reasonix: DeepSeek API Key
    ├── OpenCode: LLM provider API Key 或 OpenCode Zen 等
    ├── Hermes: Nous Portal 或其他 provider / API Key
    └── OpenClaw: 模型 provider、账号或 API Key

2.2 安装完成后常用检查命令

node -v
npm -v
git --version
python --version
pip --version

如果命令安装成功但提示 command not found，通常是 PATH 没刷新。可以重新打开终端，或者执行：

source ~/.bashrc

如果使用 zsh：

source ~/.zshrc

Windows 用户建议关闭并重新打开 PowerShell / Windows Terminal。

3. Claude Code

Claude Code 是 Anthropic 的终端 AI 编程助手，可以在项目目录中读取、修改、运行代码。

3.1 方法目录树

claude-code/
├── 推荐/
│   └── 官方 Native Installer
├── 备用/
│   ├── Homebrew
│   ├── WinGet
│   └── npm
├── 高级/
│   ├── signed Linux repos
│   ├── desktop app
│   └── CI / IDE / Slack 集成
└── 启动命令/
    └── claude

3.2 推荐：官方 Native Installer

适合谁

适合人群/
├── 新手
├── macOS 用户
├── Linux 用户
├── WSL 用户
├── Windows PowerShell 用户
└── 想用官方默认安装方式的人

需要什么环境或配置

环境要求/
├── 必须/
│   ├── 终端或 PowerShell
│   ├── 网络连接
│   └── Claude 账号、Anthropic Console 权限或企业配置
├── Windows 建议/
│   ├── Windows Terminal
│   └── Git for Windows
└── 不强制提前安装/
    └── Node.js

macOS / Linux / WSL 安装命令

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell 安装命令

irm https://claude.ai/install.ps1 | iex

Windows CMD 安装命令

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

启动命令

claude

3.3 备用：Homebrew

需要什么环境

环境要求/
├── macOS 或 Linux
├── 已安装 Homebrew
├── 终端
└── Claude/Anthropic 权限

安装稳定版

brew install --cask claude-code

更新稳定版

brew upgrade claude-code

安装 latest 通道

brew install --cask claude-code@latest

更新 latest 通道

brew upgrade claude-code@latest

3.4 备用：WinGet

需要什么环境

环境要求/
├── Windows 10 / Windows 11
├── WinGet
├── PowerShell 或 Windows Terminal
└── Claude/Anthropic 权限

安装命令

winget install Anthropic.ClaudeCode

更新命令

winget upgrade Anthropic.ClaudeCode

3.5 备用：npm

需要什么环境

环境要求/
├── Node.js
├── npm
├── npm global bin 已加入 PATH
└── Claude/Anthropic 权限

安装命令

npm install -g @anthropic-ai/claude-code

启动命令

claude

注意事项

注意/
├── 现在更推荐 Native Installer
├── npm 方式适合已有 Node.js 环境的人
└── 如果 claude 命令找不到，检查 npm global bin 是否在 PATH 中

4. OpenCode

OpenCode 是开源 AI coding agent，可以在终端、桌面端、IDE 扩展中使用。

4.1 方法目录树

opencode/
├── 推荐/
│   └── 官方 install script
├── 备用/
│   ├── npm
│   ├── bun
│   ├── pnpm
│   ├── yarn
│   ├── Homebrew
│   ├── Chocolatey
│   ├── Scoop
│   ├── Arch Linux
│   └── Mise
├── 高级/
│   ├── Docker
│   ├── Nix
│   ├── GitHub Release binary
│   └── Desktop App
└── 启动命令/
    └── opencode

4.2 推荐：官方 install script

适合谁

适合人群/
├── 新手
├── macOS 用户
├── Linux 用户
├── WSL 用户
└── 想最快开始使用的人

需要什么环境或配置

环境要求/
├── macOS / Linux / WSL
├── curl
├── bash
├── 现代终端模拟器
├── 网络连接
└── 后续需要配置 LLM provider 或 API Key

安装命令

curl -fsSL https://opencode.ai/install | bash

启动命令

opencode

初始化项目

/init

4.3 备用：npm

需要什么环境

环境要求/
├── Node.js
├── npm
├── npm global bin 已加入 PATH
└── LLM provider/API Key

安装命令

npm install -g opencode-ai

更新命令

npm update -g opencode-ai

卸载命令

npm uninstall -g opencode-ai

4.4 备用：Bun

需要什么环境

环境要求/
├── Bun
├── Bun global bin 已加入 PATH
└── LLM provider/API Key

安装命令

bun install -g opencode-ai

或者：

bun add -g opencode-ai

注意事项

注意/
└── Windows 上 Bun 安装 OpenCode 的支持可能仍在变化中，Windows 用户优先用 WSL、npm、Scoop 或 Chocolatey

4.5 备用：pnpm

需要什么环境

环境要求/
├── Node.js
├── pnpm
├── pnpm global bin 已加入 PATH
└── LLM provider/API Key

安装命令

pnpm install -g opencode-ai

4.6 备用：Yarn

需要什么环境

环境要求/
├── Node.js
├── Yarn
├── Yarn global bin 已加入 PATH
└── LLM provider/API Key

安装命令

yarn global add opencode-ai

4.7 备用：Homebrew

需要什么环境

环境要求/
├── macOS 或 Linux
├── Homebrew
└── LLM provider/API Key

官方推荐 tap

brew install anomalyco/tap/opencode

Homebrew 官方 formula

brew install opencode

更新命令

brew upgrade opencode

注意事项

注意/
├── OpenCode tap 通常更新更及时
└── Homebrew 官方 formula 可能更新较慢

4.8 Windows：Chocolatey

需要什么环境

环境要求/
├── Windows
├── Chocolatey
├── PowerShell / CMD
└── LLM provider/API Key

安装命令

choco install opencode

更新命令

choco upgrade opencode

卸载命令

choco uninstall opencode

4.9 Windows：Scoop

需要什么环境

环境要求/
├── Windows
├── Scoop
├── PowerShell
└── LLM provider/API Key

安装命令

scoop install opencode

更新命令

scoop update opencode

卸载命令

scoop uninstall opencode

4.10 Arch Linux / AUR

需要什么环境

环境要求/
├── Arch Linux / Manjaro
├── pacman 或 paru
└── LLM provider/API Key

稳定版

sudo pacman -S opencode

AUR 最新版

paru -S opencode-bin

4.11 高级：Docker

需要什么环境

环境要求/
├── Docker
├── 网络连接
├── LLM provider/API Key
└── 可选：挂载项目目录

直接运行

docker run -it --rm ghcr.io/anomalyco/opencode

挂载当前项目目录

docker run -it --rm -v $(pwd):/workspace ghcr.io/anomalyco/opencode

4.12 高级：Mise

需要什么环境

环境要求/
├── mise
└── GitHub 网络访问

安装命令

mise use -g github:anomalyco/opencode

4.13 高级：Nix

需要什么环境

环境要求/
├── Nix
└── 网络连接

运行 nixpkgs 版本

nix run nixpkgs#opencode

运行 GitHub 最新开发版

nix run github:anomalyco/opencode

5. OpenAI Codex CLI

Codex CLI 是 OpenAI 的本地终端 coding agent，可以读取、修改、运行当前目录中的代码。

5.1 方法目录树

codex-cli/
├── 推荐/
│   └── 官方 standalone installer
├── 备用/
│   ├── npm
│   ├── Homebrew
│   └── GitHub Release binary
├── 高级/
│   ├── unattended install
│   ├── fixed version binary
│   └── source build
└── 启动命令/
    └── codex

5.2 推荐：官方 standalone installer

适合谁

适合人群/
├── 新手
├── macOS 用户
├── Linux 用户
├── Windows 用户
└── 不想手动选择二进制包的人

需要什么环境或配置

环境要求/
├── 终端或 PowerShell
├── 网络连接
├── ChatGPT 账号或 OpenAI API Key
└── 包含 Codex 权限的 ChatGPT 计划或 API 配置

macOS / Linux 安装命令

curl -fsSL https://chatgpt.com/codex/install.sh | sh

macOS / Linux 非交互安装

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

Windows PowerShell 安装命令

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

启动命令

codex

5.3 备用：npm

需要什么环境

环境要求/
├── Node.js
├── npm
├── npm global bin 已加入 PATH
└── ChatGPT/OpenAI 权限

安装命令

npm install -g @openai/codex

启动命令

codex

注意事项

注意/
├── 正确包名是 @openai/codex
├── 不要误装成 codex
└── 如果 codex 命令找不到，检查 npm global bin 是否在 PATH 中

5.4 备用：Homebrew

需要什么环境

环境要求/
├── macOS 或 Linux
├── Homebrew
└── ChatGPT/OpenAI 权限

安装命令

brew install --cask codex

启动命令

codex

5.5 高级：GitHub Release 二进制

适合谁

适合人群/
├── 想固定版本的人
├── 不想安装 npm/Homebrew 的人
├── 服务器用户
└── 离线或半离线部署场景

需要什么环境

环境要求/
├── 知道自己的系统和 CPU 架构
├── 会下载 GitHub Release
├── 会解压 tar.gz
├── 会把可执行文件加入 PATH
└── ChatGPT/OpenAI 权限

常见平台文件名

codex-release-assets/
├── macOS/
│   ├── Apple-Silicon-arm64/
│   │   └── codex-aarch64-apple-darwin.tar.gz
│   └── Intel-x86_64/
│       └── codex-x86_64-apple-darwin.tar.gz
├── Linux/
│   ├── x86_64/
│   │   └── codex-x86_64-unknown-linux-musl.tar.gz
│   └── arm64/
│       └── codex-aarch64-unknown-linux-musl.tar.gz
└── Windows/
    └── 查看 GitHub Release 中对应 Windows 构建

解压后处理示例

tar -xzf codex-x86_64-unknown-linux-musl.tar.gz
mv codex-x86_64-unknown-linux-musl codex
chmod +x codex
sudo mv codex /usr/local/bin/

验证命令

codex --version

6. Gemini CLI

Gemini CLI 是 Google 的开源终端 AI agent，可以通过 Gemini 模型在终端中辅助写代码、理解项目、执行任务。

6.1 方法目录树

gemini-cli/
├── 推荐/
│   └── npm stable
├── 备用/
│   ├── Homebrew
│   ├── MacPorts
│   ├── Anaconda / Miniconda
│   └── npx
├── 高级/
│   ├── preview channel
│   ├── nightly channel
│   ├── Docker / Podman sandbox
│   └── source build
└── 启动命令/
    └── gemini

6.2 推荐：npm 安装稳定版

适合谁

适合人群/
├── 大多数用户
├── Windows 用户
├── macOS 用户
├── Linux 用户
├── 已经安装 Node.js 的用户
└── 想使用 stable 稳定版的人

需要什么环境或配置

环境要求/
├── Node.js 20+
├── npm
├── Bash / Zsh / PowerShell
├── 网络连接
└── Google 账号或 Gemini API Key

安装命令

npm install -g @google/gemini-cli

等价于：

npm install -g @google/gemini-cli@latest

启动命令

gemini

6.3 备用：Homebrew

需要什么环境

环境要求/
├── macOS 或 Linux
├── Homebrew
└── Google 账号或 Gemini API Key

安装命令

brew install gemini-cli

启动命令

gemini

6.4 备用：MacPorts

需要什么环境

环境要求/
├── macOS
├── MacPorts
└── Google 账号或 Gemini API Key

安装命令

sudo port install gemini-cli

6.5 备用：Anaconda / Miniconda 隔离安装

适合谁

适合人群/
├── 学校或公司受限环境
├── 不想污染系统 Node.js 的人
├── Python/Conda 用户
└── 想要独立环境的人

需要什么环境

环境要求/
├── Anaconda 或 Miniconda
├── 终端
└── 网络连接

安装命令

conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

启动命令

gemini

6.6 备用：npx 临时运行

适合谁

适合人群/
├── 只想临时试用的人
├── 不想全局安装的人
├── 想先确认能不能运行的人
└── 已有 Node.js/npm 的用户

需要什么环境

环境要求/
├── Node.js
├── npm / npx
├── 网络连接
└── Google 账号或 Gemini API Key

临时运行命令

npx @google/gemini-cli

直接运行 GitHub 主分支

npx https://github.com/google-gemini/gemini-cli

注意事项

注意/
├── npx 适合临时试用
├── 长期使用建议 npm 或 Homebrew
└── 每次运行可能会拉取或检查包

6.7 高级：Preview / Nightly 版本

适合谁

适合人群/
├── 想体验新功能的人
├── 测试人员
├── 贡献者
└── 能接受 bug 的用户

Preview 版本

npm install -g @google/gemini-cli@preview

Nightly 版本

npm install -g @google/gemini-cli@nightly

版本通道说明

release-channels/
├── latest/
│   └── 稳定版，推荐普通用户
├── preview/
│   └── 预览版，功能更新更快
└── nightly/
    └── 每日构建，最不稳定，适合测试

6.8 高级：源码运行

需要什么环境

环境要求/
├── Git
├── Node.js
├── npm
└── 网络连接

源码运行命令

git clone https://github.com/google-gemini/gemini-cli.git
cd gemini-cli
npm install
npm run start

生产模式

npm run start:prod

链接本地包

npm link packages/cli
gemini

7. Hermes Agent

Hermes Agent 是 Nous Research 的 AI Agent，特点是可以作为长期运行的个人代理，支持 CLI、TUI、Gateway、Telegram、Discord、Slack 等通道。

7.1 方法目录树

hermes-agent/
├── 推荐/
│   ├── pip install hermes-agent
│   └── git installer install.sh
├── 备用/
│   ├── Windows WSL2
│   ├── Desktop App
│   └── Android Termux
├── 高级/
│   ├── provider config
│   ├── gateway setup
│   ├── skip-browser
│   └── source clone
└── 启动命令/
    ├── hermes
    └── hermes --tui

7.2 推荐：pip 安装

适合谁

适合人群/
├── 已经有 Python/pip 的用户
├── 想安装 tagged release 的用户
├── 不想跟随 main 分支的人
└── 希望安装方式更像普通 Python CLI 的用户

需要什么环境或配置

环境要求/
├── Python
├── pip
├── 网络连接
├── 模型 provider 或 API Key
└── Hermes 要求模型上下文至少 64K tokens，使用本地模型时要注意上下文长度

安装命令

pip install hermes-agent

安装后可选 postinstall

hermes postinstall

postinstall 作用

postinstall/
├── 可安装 Node.js
├── 可安装 browser 相关依赖
├── 可安装 ripgrep
├── 可安装 ffmpeg
└── 可运行 setup

启动命令

hermes

TUI 启动命令

hermes --tui

模型配置

hermes model

Nous Portal 快速配置

hermes setup --portal

7.3 推荐：git installer，跟随 main 分支

适合谁

适合人群/
├── 想使用最新 main 版本的人
├── Linux 用户
├── macOS 用户
├── WSL2 用户
├── Android Termux 用户
└── 想自动处理更多依赖的人

需要什么环境

环境要求/
├── Linux / macOS / WSL2 / Android Termux
├── curl
├── bash
├── 网络连接
└── 模型 provider 或 API Key

安装命令

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

刷新 shell

source ~/.bashrc

如果使用 zsh：

source ~/.zshrc

初始化或检查

hermes setup
hermes model
hermes doctor

启动命令

hermes

注意事项

注意/
├── git installer 跟随 main 分支，更新更快
├── 适合想尝鲜或服务器部署的人
└── 如果想要 tagged release，优先用 pip

7.4 Windows 建议：WSL2 后运行 install.sh

需要什么环境

环境要求/
├── Windows
├── WSL2
├── WSL 内的 Linux 终端
├── curl
├── bash
└── 模型 provider 或 API Key

安装流程

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup

7.5 Android / Termux

需要什么环境

环境要求/
├── Android
├── Termux
├── 网络连接
└── 模型 provider 或 API Key

安装命令

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

7.6 Provider 配置

Hermes 的关键不是只安装成功，还要配置可用模型。

常见配置入口

hermes model

常见 API Key 环境变量示例

export OPENROUTER_API_KEY="sk-or-..."
export DEEPSEEK_API_KEY="sk-..."
export GEMINI_API_KEY="..."
export GOOGLE_API_KEY="..."
export XAI_API_KEY="..."

Hermes 配置命令示例

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

配置文件位置

hermes-config/
├── ~/.hermes/.env
│   └── secrets、tokens、API Keys
└── ~/.hermes/config.yaml
    └── 非敏感配置

8. OpenClaw

OpenClaw 是一个个人 AI assistant，可以运行在自己的设备上，并通过 Telegram、Discord、Slack、WhatsApp、Signal、iMessage、Matrix、飞书、微信、QQ 等通道交互。

8.1 方法目录树

openclaw/
├── 推荐/
│   └── 官方 installer script
├── 备用/
│   ├── no-onboard
│   ├── local prefix installer
│   ├── npm
│   ├── pnpm
│   └── bun
├── 高级/
│   ├── source build
│   ├── daemon mode
│   ├── gateway status
│   └── server / VPS
└── 启动与配置/
    ├── openclaw onboard
    ├── openclaw onboard --install-daemon
    └── openclaw gateway status

8.2 推荐：官方 installer script

适合谁

适合人群/
├── 新手
├── macOS 用户
├── Linux 用户
├── Windows 用户
├── WSL2 用户
├── 想自动安装 Node 的人
└── 想直接进入 onboarding 的人

需要什么环境或配置

环境要求/
├── macOS / Linux / Windows / WSL2
├── Node 24 推荐，Node 22.19+ 支持
├── 官方 installer 可自动检测并安装 Node
├── 网络连接
├── 模型 provider、账号或 API Key
└── 如果从源码构建，才需要 pnpm

macOS / Linux / WSL2 安装命令

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell 安装命令

iwr -useb https://openclaw.ai/install.ps1 | iex

8.3 备用：安装但不进入 onboarding

适合谁

适合人群/
├── 想先安装、稍后配置的人
├── 脚本部署用户
├── 服务器用户
└── 自动化安装场景

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows PowerShell

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

8.4 备用：Local Prefix Installer

适合谁

适合人群/
├── 不想依赖系统 Node 的人
├── 不想污染全局环境的人
├── 想把 OpenClaw 和 Node 放在 ~/.openclaw 的人
└── 多用户服务器环境

需要什么环境

环境要求/
├── macOS / Linux / WSL2
├── curl
├── bash
└── 网络连接

安装命令

curl -fsSL https://openclaw.ai/install-cli.sh | bash

目录结构

openclaw-local-prefix/
├── ~/.openclaw/
│   ├── bin/
│   │   └── openclaw
│   ├── lib/
│   │   └── node_modules/openclaw
│   └── tools/
│       └── node/

8.5 备用：npm

需要什么环境

环境要求/
├── Node 24 推荐，Node 22.19+ 支持
├── npm
├── npm global bin 已加入 PATH
└── 模型 provider、账号或 API Key

安装并启动 daemon onboarding

npm install -g openclaw@latest
openclaw onboard --install-daemon

检查 Gateway 状态

openclaw gateway status

8.6 Daemon / Gateway 常用命令

前台调试模式

openclaw gateway stop
openclaw gateway --port 18789 --verbose

8.7 高级：源码安装

适合谁

适合人群/
├── 开发者
├── 想改源码的人
├── 想贡献代码的人
└── 想跟踪 main 分支的人

需要什么环境

环境要求/
├── Git
├── Node 24 或 Node 22.19+
├── pnpm
├── 终端
└── 网络连接

源码安装示例

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install

后续构建和启动命令建议以当前仓库 README 为准。

9. Reasonix

Reasonix 是面向 DeepSeek 的终端 AI coding agent，强调 DeepSeek API、prefix cache、长会话成本控制等能力。

重要版本说明：
Reasonix 0.x 是 TypeScript/npm 线，常见命令是 npx reasonix code 或 npm install -g reasonix。
Reasonix 1.x 是 Go rewrite，GitHub 默认分支已转向 main-v2；项目 README 提到 npm i -g reasonix 仍是安装入口，但 1.0.0 可能尚未上 npm，开发者可从源码构建。
普通用户试用时，优先按 DeepSeek 官方集成文档使用 npx reasonix code。

9.1 方法目录树

reasonix/
├── 推荐/
│   └── npx reasonix code
├── 备用/
│   └── npm install -g reasonix
├── 高级/
│   ├── dsnix alias
│   ├── source build
│   ├── desktop prerelease
│   └── Go rewrite main-v2
└── 启动命令/
    ├── npx reasonix code
    ├── reasonix code
    ├── reasonix chat
    └── reasonix run "task"

9.2 推荐：npx 不全局安装

适合谁

适合人群/
├── 新手
├── 只想试用的人
├── 不想全局安装的人
├── 想尽量使用最新 npm 包的人
└── 已经有 Node.js 的用户

需要什么环境或配置

环境要求/
├── Node.js
│   ├── DeepSeek 官方集成页要求 Node.js 20.10+
│   └── Reasonix 项目文档常见要求 Node.js 22+
├── npm / npx
├── macOS / Linux / Windows
├── Windows 用户建议 Git for Windows、PowerShell、Git Bash 或 Windows Terminal
├── DeepSeek API Key
└── 网络连接

进入项目目录

cd /path/to/my-project

启动命令

npx reasonix code

首次启动

first-run/
├── 粘贴 DeepSeek API Key
├── 配置会保存到 ~/.reasonix/config.json 或项目配置中
└── 进入 TUI 后可使用 /help 查看命令

9.3 备用：npm 全局安装

适合谁

适合人群/
├── 经常使用 Reasonix 的人
├── 想直接使用 reasonix 命令的人
├── 不想每次 npx 拉取的人
└── 已经熟悉 npm global 的用户

需要什么环境

环境要求/
├── Node.js
├── npm
├── npm global bin 已加入 PATH
├── DeepSeek API Key
└── 网络连接

安装命令

npm install -g reasonix

在指定项目中启动

reasonix code my-project

在当前目录启动

cd my-project
reasonix code

裸命令启动

reasonix

说明：项目文档中 reasonix 和 reasonix code 等价，默认进入当前目录的 code 模式。

9.4 备用：dsnix 短别名

需要什么环境

环境要求/
├── Node.js
├── npm / npx
└── DeepSeek API Key

全局安装 dsnix

npm install -g dsnix

npx 一次性运行 dsnix

npx dsnix@latest code

说明

说明/
├── dsnix 是 reasonix 的短别名
└── 全局安装 reasonix 通常也会提供 dsnix shim

9.5 DeepSeek API Key 配置

需要什么

配置要求/
├── DeepSeek 账号
├── DeepSeek API Key
└── API 余额或可用额度

推荐：首次启动按向导粘贴

npx reasonix code

环境变量方式

export DEEPSEEK_API_KEY="sk-..."

Windows PowerShell：

$env:DEEPSEEK_API_KEY="sk-..."

Reasonix 1.x / Go rewrite 配置示例

reasonix setup
export DEEPSEEK_API_KEY=sk-...
reasonix chat
reasonix run "implement the TODOs in main.go"

配置文件解析顺序示例

reasonix-config-resolution/
├── 命令行 flag
├── ./reasonix.toml
├── ~/.config/reasonix/config.toml
└── 内置默认值

9.6 高级：源码构建 Reasonix 1.x / Go rewrite

适合谁

适合人群/
├── 开发者
├── 想体验 main-v2 的人
├── 想构建单文件 Go binary 的人
└── 能接受当前文档和 npm 版本不完全同步的人

需要什么环境

环境要求/
├── Git
├── Go 工具链
├── make
├── DeepSeek API Key
└── 网络连接

构建命令

git clone https://github.com/esengine/DeepSeek-Reasonix.git
cd DeepSeek-Reasonix
make build

交叉编译

make cross

构建产物目录

reasonix-build-output/
├── bin/
│   └── reasonix
└── dist/
    ├── darwin-amd64/
    ├── darwin-arm64/
    ├── linux-amd64/
    ├── linux-arm64/
    ├── windows-amd64/
    └── windows-arm64/

10. 按系统快速选择

10.1 macOS 用户

macos-recommendation/
├── 最省心/
│   ├── Claude Code: 官方 installer
│   ├── Codex CLI: 官方 installer
│   ├── OpenCode: 官方 install script
│   └── OpenClaw: 官方 install script
├── Homebrew 管理/
│   ├── Claude Code: brew install --cask claude-code
│   ├── Codex CLI: brew install --cask codex
│   ├── Gemini CLI: brew install gemini-cli
│   └── OpenCode: brew install anomalyco/tap/opencode
└── npm 管理/
    ├── Gemini CLI: npm install -g @google/gemini-cli
    ├── OpenCode: npm install -g opencode-ai
    └── Reasonix: npm install -g reasonix

10.2 Windows 用户

windows-recommendation/
├── 推荐终端/
│   ├── Windows Terminal
│   ├── PowerShell
│   ├── Git Bash
│   └── WSL2
├── 推荐方式/
│   ├── Claude Code: irm https://claude.ai/install.ps1 | iex
│   ├── Codex CLI: powershell install.ps1
│   ├── OpenClaw: iwr -useb https://openclaw.ai/install.ps1 | iex
│   ├── Gemini CLI: npm install -g @google/gemini-cli
│   └── Reasonix: npx reasonix code
├── OpenCode/
│   ├── 推荐 WSL2
│   ├── choco install opencode
│   ├── scoop install opencode
│   └── npm install -g opencode-ai
└── 注意/
    ├── 很多 coding agent 在 WSL2 下更稳定
    └── Git for Windows 经常是必要依赖

10.3 Linux / VPS 用户

linux-vps-recommendation/
├── 官方脚本/
│   ├── Claude Code
│   ├── OpenCode
│   ├── Codex CLI
│   ├── Hermes
│   └── OpenClaw
├── npm/npx/
│   ├── Gemini CLI
│   ├── OpenCode
│   └── Reasonix
├── 适合长期运行/
│   ├── Hermes
│   ├── OpenClaw
│   └── Reasonix
└── 建议/
    ├── 使用 tmux
    ├── 使用 systemd
    ├── 使用 Docker
    └── 注意 API Key 权限和费用

11. 固定版本安装记录模板

11.1 npm 固定版本

npm install -g package-name@version

示例：

npm install -g @google/gemini-cli@latest
npm install -g @google/gemini-cli@preview
npm install -g @google/gemini-cli@nightly
npm install -g opencode-ai@latest
npm install -g @openai/codex@latest
npm install -g reasonix@latest

11.2 GitHub Release 固定版本

github-release-fixed-version/
├── 打开项目 GitHub Releases
├── 选择指定 tag
├── 下载对应系统和架构的二进制
├── 解压
├── chmod +x
└── 移动到 PATH 目录

11.3 Docker 固定版本

docker run -it --rm image-name:tag

示例：

docker run -it --rm ghcr.io/anomalyco/opencode:latest

12. 常见问题

12.1 安装成功但 command not found

possible-causes/
├── npm global bin 没有加入 PATH
├── 安装脚本修改了 shell 配置，但当前终端没刷新
├── Windows 没有重新打开 PowerShell
├── 使用了错误 shell
├── 安装失败但没有看到错误输出
└── 二进制没有 chmod +x

解决：

source ~/.bashrc

或：

source ~/.zshrc

检查 npm global bin：

npm bin -g

检查命令位置：

which claude
which opencode
which codex
which gemini
which hermes
which openclaw
which reasonix

Windows PowerShell：

Get-Command claude
Get-Command opencode
Get-Command codex
Get-Command gemini
Get-Command openclaw
Get-Command reasonix

12.2 Node.js 版本太旧

检查版本：

node -v
npm -v

建议：

node-version-suggestion/
├── Gemini CLI: Node.js 20+
├── OpenClaw: Node 24 推荐，Node 22.19+ 支持
├── Reasonix: Node 20.10+ 或 Node 22+，取决于具体版本线
└── 其他 npm 安装方式：优先使用当前 LTS 或更新版本

12.3 不知道自己是 arm64 还是 x86_64

macOS / Linux：

uname -m

输出解释：

architecture-map/
├── arm64 / aarch64
│   └── Apple Silicon / ARM64
└── x86_64 / amd64
    └── Intel / AMD 64-bit

Windows PowerShell：

$env:PROCESSOR_ARCHITECTURE

12.4 需要 API Key 吗

api-key-or-auth/
├── Claude Code/
│   └── 需要 Claude 账号、Anthropic Console 或企业云配置
├── Codex CLI/
│   └── 需要 ChatGPT 账号或 OpenAI API Key
├── Gemini CLI/
│   └── 需要 Google 账号或 Gemini API Key
├── Reasonix/
│   └── 需要 DeepSeek API Key
├── Hermes/
│   └── 需要 Nous Portal、API Key、OAuth 或本地模型 provider
├── OpenClaw/
│   └── 需要模型 provider、账号或 API Key
└── OpenCode/
    └── 需要 LLM provider API Key，或使用 OpenCode Zen 等方式

13. 最终建议

13.1 新手最快路线

new-user-fast-path/
├── Claude Code/
│   └── 用官方 Native Installer
├── OpenCode/
│   └── 用 curl install script
├── Codex CLI/
│   └── 用官方 standalone installer
├── Gemini CLI/
│   └── 用 npm install -g @google/gemini-cli
├── Hermes/
│   ├── 有 Python: pip install hermes-agent
│   └── 想跟随 main: install.sh
├── OpenClaw/
│   └── 用官方 installer script
└── Reasonix/
    └── 用 npx reasonix code

13.2 长期维护路线

long-term-maintenance/
├── macOS/
│   └── Homebrew
├── Windows/
│   ├── WinGet
│   ├── Scoop
│   └── Chocolatey
├── Node 工具/
│   └── npm global + 明确版本号
├── 服务器/
│   ├── Docker
│   ├── systemd
│   └── tmux
└── 固定版本/
    ├── npm package@version
    ├── GitHub Release tag
    └── Docker image tag

14. 参考来源

Claude Code Docs: https://code.claude.com/docs/en/quickstart
Claude Code Setup: https://code.claude.com/docs/en/setup
OpenCode Docs: https://opencode.ai/docs 或 https://open-code.ai/en/docs
OpenCode GitHub: https://github.com/anomalyco/opencode
OpenAI Codex CLI Docs: https://developers.openai.com/codex/cli
OpenAI Codex GitHub: https://github.com/openai/codex
Gemini CLI Docs: https://geminicli.com/docs/get-started/installation/
Gemini CLI GitHub: https://github.com/google-gemini/gemini-cli
Hermes Agent Docs: https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
Hermes Agent GitHub: https://github.com/NousResearch/hermes-agent
OpenClaw Docs: https://docs.openclaw.ai/install
OpenClaw GitHub: https://github.com/openclaw/openclaw
DeepSeek Reasonix Integration: https://api-docs.deepseek.com/quick_start/agent_integrations/reasonix
Reasonix GitHub: https://github.com/esengine/DeepSeek-Reasonix

亚马逊云科技技术品牌专区

更多推荐

open-code-review Codex 插件教程：对话式调用评审技能指南

本文是一份面向新手的 **open-code-review Codex 插件教程**，教你在 Codex 中通过对话式方式调用 open-code-review 的 AI 代码评审技能。open-code-review 是阿里巴巴开源的 AI 代码评审工具，采用"确定性流水线 + LLM Agent"混合架构，内置多语言评审规则（NPE、线程安全、XSS、SQL 注入等），可在 Codex 里用一

亚马逊云科技技术品牌专区

OBS Studio 完整指南：免费开源录屏与直播软件从零上手

想做一场像模像样的直播，或者把屏幕内容录成教程视频，但一想到商用软件的订阅费就有些犹豫？其实你不需要花一分钱。OBS Studio 是一款免费开源的直播与录屏软件，支持 Windows、macOS 和 Linux，采集、混音、编码、推流、录制，一条流水线全包了。## 先搞清楚 OBS Studio 是什么OBS Studio 是一个"场景化"的采集合成工具：你把摄像头、窗口、浏览器、图片、

亚马逊云科技技术品牌专区

如何用MediaCrawler爬取小红书抖音数据？7大平台爬虫从安装到实战完整指南

MediaCrawler 是一个支持小红书、抖音、快手、B站、微博、百度贴吧、知乎的开源自媒体数据采集工具。它能按关键词、按帖子、按创作者主页三种方式抓取笔记/视频内容、评论甚至二级评论，并把结果存成 JSON、CSV、Excel 或数据库。适合做市场调研、竞品监控、内容选题的运营人员，以及想要现成爬虫框架而不想从零写 JS 逆向的开发者。## 从一次"手动抄数据"说起想象这个场景：你负责

亚马逊云科技技术品牌专区

所有评论(0)

查看更多评论

2401_89382898

@2401_89382898

已为社区贡献5条内容

AI Agent 下载与安装命令总结

2401_89382898

0. 总览：最推荐安装方式

1.

2.1 推荐先准备的工具

2.2 安装完成后常用检查命令

3. Claude Code

3.1 方法目录树

3.2 推荐：官方 Native Installer

适合谁

需要什么环境或配置

macOS / Linux / WSL 安装命令

Windows PowerShell 安装命令

Windows CMD 安装命令

启动命令

推荐理由

3.3 备用：Homebrew

需要什么环境

安装稳定版

更新稳定版

安装 latest 通道

更新 latest 通道

3.4 备用：WinGet

需要什么环境

安装命令

更新命令

3.5 备用：npm

需要什么环境

安装命令

启动命令

注意事项

4. OpenCode

4.1 方法目录树

4.2 推荐：官方 install script

适合谁

需要什么环境或配置

安装命令

启动命令

推荐在项目目录中启动

初始化项目

推荐理由

4.3 备用：npm

需要什么环境

安装命令

更新命令

卸载命令

4.4 备用：Bun

需要什么环境

安装命令

注意事项

4.5 备用：pnpm

需要什么环境

安装命令

4.6 备用：Yarn

需要什么环境

安装命令

4.7 备用：Homebrew

需要什么环境

官方推荐 tap

Homebrew 官方 formula

更新命令

注意事项

4.8 Windows：Chocolatey

需要什么环境

安装命令

更新命令

卸载命令

4.9 Windows：Scoop

需要什么环境

安装命令

更新命令

卸载命令

4.10 Arch Linux / AUR

需要什么环境

稳定版

AUR 最新版

4.11 高级：Docker

需要什么环境

直接运行

挂载当前项目目录