工具部署（从零开始）

最快的方式是一键脚本：一条命令完成安装 + 配置。想手动配置的，再看各工具下面的系统安装页。

一键配置命令（推荐）

先打开终端：

• macOS / Linux：打开「终端 / Terminal」（WSL、Git Bash 也用这一组命令）
• Windows：按 Win + X 打开「Windows PowerShell」或「终端」，不需要安装 Git Bash

工具	macOS / Linux	Windows PowerShell	说明
Claude Code	curl -fsSL https://docs.aizhan.space/sh/claudecode.sh | bash	irm https://docs.aizhan.space/sh/claudecode.ps1 | iex	支持 CLI 和 Claude 桌面版
Codex	curl -fsSL https://docs.aizhan.space/sh/codex.sh | bash	irm https://docs.aizhan.space/sh/codex.ps1 | iex	支持 CLI 和 Codex 桌面版 App
OpenClaw	curl -fsSL https://docs.aizhan.space/sh/openclaw.sh | bash	irm https://docs.aizhan.space/sh/openclaw.ps1 | iex	Claude + GPT 同时接入
Hermes Agent	curl -fsSL https://docs.aizhan.space/sh/hermes.sh | bash	irm https://docs.aizhan.space/sh/hermes.ps1 | iex	Claude + GPT 同时接入
OpenCode	curl -fsSL https://docs.aizhan.space/sh/opencode.sh | bash	irm https://docs.aizhan.space/sh/opencode.ps1 | iex	Claude + GPT 同时接入
Pi	curl -fsSL https://docs.aizhan.space/sh/pi.sh | bash	irm https://docs.aizhan.space/sh/pi.ps1 | iex	Claude + GPT 同时接入

两组命令不能混用

curl ... | bash 只能在 macOS / Linux / WSL / Git Bash 里执行；irm ... | iex 只能在 PowerShell 里执行。把 bash 命令粘贴到 PowerShell 会直接报错。

所有脚本的菜单都一样：1 安装、2 配置AI驿站、3 一键全部安装（第一次用直接选 3）。脚本只改它自己管理的配置项，你原有的其他配置会保留，改动前会自动备份。

统一的中转信息

• 服务名字：AI驿站
• 中转服务地址：https://api.aizhan.space（国内直连）/ https://api.aizhan.space（海外 CDN）
• 默认模型：Claude 用 claude-opus-5-5，GPT 用 gpt-6.1-sol，推理强度默认中档（medium）

很多工具会让你填 API Base URL，通常有两种写法：

• OpenAI / Codex 兼容接口必须带 /v1：https://api.aizhan.space/v1
• Anthropic / Claude 兼容接口一般不带 /v1：https://api.aizhan.space（OpenCode 例外，要带 /v1）

用一键脚本时不用记这些，脚本会自动写对。

关于 API Key 和令牌分组

• Claude 和 GPT 在官网 api.aizhan.space 是不同的令牌分组，需要分别创建 Key。OpenClaw、Hermes、OpenCode、Pi 的脚本会先后让你输入 Claude Key 和 GPT Key，只用其中一家也可以。
• 如果在第三方工具里用 Claude 时报错 Requests from the ... framework are not supported，说明这个 Key 所在分组只允许 Claude 官方客户端。请在允许第三方工具的分组下重新创建 Key，再运行脚本选「2) 配置」。

选哪个工具

• Claude Code：终端里直接改代码、跑命令、做审查；也可以配置 Claude 桌面版。
• Codex：OpenAI 官方终端编码代理，适合偏 OpenAI 工作流的人。
• OpenClaw：更偏网关和面板管理，适合想把 agent 跑成服务的人。
• Hermes Agent：终端代理，同时支持 Claude 和 GPT，通过 YAML 配置管理。
• OpenCode：开源 TUI，多 provider，配置自由度高。
• Pi：轻量的终端编码代理，Claude / GPT 随时切换。
• CC-Switch：图形化管理多个工具的配置，适合不想手改配置文件的人。

手动配置的阅读顺序

1. 先装 Node.js（多数工具需要）：安装 Node.js
2. 进入你要用的工具页，点你自己的系统（Windows / macOS / Linux）
3. 按文档把 Base URL 和 API Key 配好，然后用「验证命令」测试一下