AI Agent 安装与配置教程

AISwitcher 当前聚焦三个 coding agent：Claude Code、Codex CLI、OpenCode。本文介绍它们的安装方式以及 aisw 的安装。

1. 安装 AISwitcher

git clone <repo> && cd innate-aiswitcher
task build:full   # 构建前端 + Go 单体二进制
task install      # 安装到 ~/.local/bin

task build 只构建 Go 二进制（嵌入上次的前端产物快照）；task build:full 会先重新构建 Web 前端。

# 方式 1: npm（推荐）
npm install -g @anthropic-ai/claude-code

# 方式 2: Homebrew (macOS)
brew install --cask claude-code

# 验证
claude --version

npm install -g @openai/codex

# 验证
codex --version

# 官方安装脚本（macOS / Linux）
curl -fsSL https://opencode.ai/install | bash

# 或 npm
npm install -g opencode-ai

# 验证
opencode --version

以 GLM（Volcengine Ark）为例，一条命令即可让三个 Agent 同时可用：

aisw provider from-preset glm --api-key sk-xxx
# 或从环境变量读取 key
aisw provider from-preset glm --api-key-env GLM_API_KEY

新增模型与 GLM-5.2 共享同一把 key，无需重复配置：

aisw provider model add glm glm-5.3

aisw start claude glm                # CLI 启动
aisw start claude glm --model glm-5.3
aisw web                             # 打开 Web 应用（含浏览器终端）

Web 页面的 Terminal 标签可开多个本地终端，Launch agent 一键运行 aisw start <agent> <provider>。

aisw test provider glm               # 连通性测试
aisw start codex glm --dry-run       # 只打印启动计划