AI 编程工具安装教程

方式一：使用 Homebrew（推荐）

# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node@22

方式二：使用 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc
nvm install 22

验证安装

node -v  # 应显示 v22.x.x

方式一：一键安装（推荐）

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

方式二：npm 安装

npm install -g openclaw@latest

验证安装

openclaw --version

打开你的 OpenClaw 配置文件 ~/.openclaw/openclaw.json，将其中的 models 和 agents 字段替换为以下内容：

替换以下字段内容

"models": {
  "providers": {
    "aiclaudexyz": {
      "baseUrl": "https://api.aiclaude.xyz",
      "apiKey": "<YOUR_API_KEY>",
      "api": "anthropic-messages",
      "headers": {
        "User-Agent": "curl/8.0"
      },
      "models": [
        {
          "id": "claude-opus-4-6",
          "name": "Claude Opus 4.6",
          "reasoning": true,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 200000,
          "maxTokens": 128000
        }
      ]
    },
    "openaixyz": {
      "baseUrl": "https://api.aiclaude.xyz/v1",
      "apiKey": "<YOUR_API_KEY>",
      "api": "openai-completions",
      "headers": {
        "User-Agent": "curl/8.0"
      },
      "models": [
        {
          "id": "gpt-5.3-codex",
          "name": "GPT-5.3 Codex",
          "reasoning": true,
          "input": ["text", "image"],
          "cost": { "input": 1.75, "output": 14, "cacheRead": 0.175, "cacheWrite": 1.75 },
          "contextWindow": 400000,
          "maxTokens": 128000
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "aiclaudexyz/claude-opus-4-6",
      "fallbacks": ["openaixyz/gpt-5.3-codex"]
    },
    "models": {
      "aiclaudexyz/claude-opus-4-6": {},
      "openaixyz/gpt-5.3-codex": {}
    },
    "compaction": {
      "mode": "safeguard",
      "reserveTokensFloor": 20000,
      "maxHistoryShare": 0.7,
      "memoryFlush": { "enabled": true, "softThresholdTokens": 10000 }
    },
    "maxConcurrent": 4,
    "subagents": { "maxConcurrent": 8 }
  },
  "list": [{ "id": "main" }]
},

验证配置

# 检查配置是否正确
openclaw doctor

# 重启服务使配置生效
openclaw gateway restart

WhatsApp（扫码登录）

openclaw channels login

用 WhatsApp 扫描终端显示的二维码即可。

Telegram（Bot Token）

# 先从 @BotFather 获取 Bot Token
openclaw channels add --channel telegram --token "YOUR_BOT_TOKEN"

Discord

openclaw channels add --channel discord --token "YOUR_BOT_TOKEN"

常用命令

# 启动服务
openclaw gateway start

# 查看状态
openclaw gateway status

# 打开 Web 控制面板
openclaw dashboard

# 打开终端交互界面
openclaw tui

# 重启服务
openclaw gateway restart

# 停止服务
openclaw gateway stop

OpenClaw 提供 macOS 原生应用，支持菜单栏快捷操作和语音唤醒。

# 从源码构建
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build:macos

Ubuntu / Debian

# 使用 NodeSource 安装
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node -v

Fedora / RHEL / CentOS

sudo dnf install nodejs

Arch Linux

sudo pacman -S nodejs npm

通用方式：nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22

方式一：一键安装（推荐）

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

方式二：npm 安装

npm install -g openclaw@latest

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest

打开你的 OpenClaw 配置文件 ~/.openclaw/openclaw.json，将其中的 models 和 agents 字段替换为以下内容：

替换以下字段内容

"models": {
  "providers": {
    "aiclaudexyz": {
      "baseUrl": "https://api.aiclaude.xyz",
      "apiKey": "<YOUR_API_KEY>",
      "api": "anthropic-messages",
      "headers": {
        "User-Agent": "curl/8.0"
      },
      "models": [
        {
          "id": "claude-opus-4-6",
          "name": "Claude Opus 4.6",
          "reasoning": true,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 200000,
          "maxTokens": 128000
        }
      ]
    },
    "openaixyz": {
      "baseUrl": "https://api.aiclaude.xyz/v1",
      "apiKey": "<YOUR_API_KEY>",
      "api": "openai-completions",
      "headers": {
        "User-Agent": "curl/8.0"
      },
      "models": [
        {
          "id": "gpt-5.3-codex",
          "name": "GPT-5.3 Codex",
          "reasoning": true,
          "input": ["text", "image"],
          "cost": { "input": 1.75, "output": 14, "cacheRead": 0.175, "cacheWrite": 1.75 },
          "contextWindow": 400000,
          "maxTokens": 128000
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "aiclaudexyz/claude-opus-4-6",
      "fallbacks": ["openaixyz/gpt-5.3-codex"]
    },
    "models": {
      "aiclaudexyz/claude-opus-4-6": {},
      "openaixyz/gpt-5.3-codex": {}
    },
    "compaction": {
      "mode": "safeguard",
      "reserveTokensFloor": 20000,
      "maxHistoryShare": 0.7,
      "memoryFlush": { "enabled": true, "softThresholdTokens": 10000 }
    },
    "maxConcurrent": 4,
    "subagents": { "maxConcurrent": 8 }
  },
  "list": [{ "id": "main" }]
},

验证配置

# 检查配置是否正确
openclaw doctor

# 重启服务使配置生效
openclaw gateway restart

服务管理（systemd）

# 查看服务状态
systemctl --user status openclaw

# 重启服务
systemctl --user restart openclaw

# 查看日志
journalctl --user -u openclaw -f

WhatsApp（扫码登录）

openclaw channels login

用 WhatsApp 扫描终端显示的二维码即可。

Telegram（Bot Token）

# 先从 @BotFather 获取 Bot Token
openclaw channels add --channel telegram --token "YOUR_BOT_TOKEN"

Discord

openclaw channels add --channel discord --token "YOUR_BOT_TOKEN"

常用命令

# 启动服务
openclaw gateway start

# 查看状态
openclaw gateway status

# 健康检查
openclaw gateway health

# 打开 Web 控制台
openclaw dashboard

# 打开终端交互界面
openclaw tui

# 重启服务
openclaw gateway restart

# 停止服务
openclaw gateway stop

# 运行诊断
openclaw doctor

# 自动修复问题
openclaw doctor --fix

方式一：Homebrew（推荐）

# 先添加 tap
brew tap farion1231/ccswitch
# 然后安装
brew install --cask cc-switch

方式二：手动下载

或访问 GitHub Releases 页面下载最新版

1. 添加提供商

   点击「添加提供商」配置 API

   

   如需应用到claude code 插件，请勾选该选项：

   
2. 启用配置

   选择并启用你的提供商

   
3. 重启终端 - 新开终端窗口生效

Debian/Ubuntu

# 从 GitHub Releases 下载 .deb 包安装

Arch Linux（推荐）

paru -S cc-switch-bin

其他发行版

# 下载 AppImage 或 Flatpak
# Flatpak 安装：
flatpak install --user cc-switch.flatpak
flatpak run com.ccswitch.desktop

1. 添加提供商

   配置你的 API 提供商

   

   如需应用到claude code 插件，请勾选该选项：

   
2. 启用配置

   选择并启用提供商

   
3. 重启终端 - 新开终端窗口生效

方式一：curl（推荐）

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

方式二：Homebrew

brew install anomalyco/tap/opencode

安装 Node.js（npm 方式需要）

Opencode 需要 Node.js 18+ 版本。使用 Homebrew 安装：

brew install node@20

方式三：npm

npm i -g opencode-ai

在 ~/.config/opencode 目录创建 opencode.json 配置文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
        "anthropic": {
            "options": {
                "baseURL": "https://api.aiclaude.xyz/v1"
            },
			"models": {
        "claude-opus-4-5-20251101": { "name": "claude-opus-4-5-20251101", "thinking": true },
        "claude-sonnet-4-5-20250929": { "name": "claude-sonnet-4-5-20250929", "thinking": true },
        "claude-haiku-4-5-20251001": { "name": "claude-haiku-4-5-20251001", "thinking": true }
      }
        },
        "openai": {
            "options": {
                "baseURL": "https://api.aiclaude.xyz/v1"
            },
            "models": {
                "gpt-5.2": {
                    "options": {
                        "include": [
                            "reasoning.encrypted_content"
                        ],
                        "store": false,
                        "reasoningEffort": "xhigh",
                        "textVerbosity": "xhigh",
                        "reasoningSummary": "auto"
                    }
                },
                "gpt-5.2-codex": {
                    "options": {
                        "include": [
                            "reasoning.encrypted_content"
                        ],
                        "store": false,
                        "reasoningEffort": "xhigh",
                        "textVerbosity": "xhigh",
                        "reasoningSummary": "auto"
                    }
                }
            }
        },
    "google": {
      "npm": "@ai-sdk/google",
      "name": "google",
      "options": { "baseURL": "https://api.aiclaude.xyz/v1beta" },
      "models": {
        "gemini-3-pro-preview": { "name": "gemini-3-pro-preview", "thinking": true },
        "gemini-3-flash-preview": { "name": "gemini-3-flash-preview", "thinking": true },
        "gemini-2.5-flash-lite": { "name": "gemini-2.5-flash-lite", "thinking": true }
      }
    }
    },
  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "google/gemini-3-flash-preview",
  
  "mcp": {
    "context7": {
      "type": "local",
      "command": [
        "pnpx",
        "@upstash/context7-mcp"
      ],
      "enabled": true
    }
  }
}

opencode
> /connect

方式一：curl（推荐）

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

安装 Node.js（npm/bun 方式需要）

Opencode 需要 Node.js 18+ 版本。选择以下任一方式安装：

Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora/RHEL

sudo dnf install nodejs

Arch Linux

sudo pacman -S nodejs npm

方式二：npm

npm i -g opencode-ai

方式三：bun

bun add -g opencode-ai

方式四：Arch Linux（AUR）

paru -S opencode

在 ~/.config/opencode 目录创建 opencode.json 配置文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
        "anthropic": {
            "options": {
                "baseURL": "https://api.aiclaude.xyz/v1"
            },
			"models": {
        "claude-opus-4-5-20251101": { "name": "claude-opus-4-5-20251101", "thinking": true },
        "claude-sonnet-4-5-20250929": { "name": "claude-sonnet-4-5-20250929", "thinking": true },
        "claude-haiku-4-5-20251001": { "name": "claude-haiku-4-5-20251001", "thinking": true }
      }
        },
        "openai": {
            "options": {
                "baseURL": "https://api.aiclaude.xyz/v1"
            },
            "models": {
                "gpt-5.2": {
                    "options": {
                        "include": [
                            "reasoning.encrypted_content"
                        ],
                        "store": false,
                        "reasoningEffort": "xhigh",
                        "textVerbosity": "xhigh",
                        "reasoningSummary": "auto"
                    }
                },
                "gpt-5.2-codex": {
                    "options": {
                        "include": [
                            "reasoning.encrypted_content"
                        ],
                        "store": false,
                        "reasoningEffort": "xhigh",
                        "textVerbosity": "xhigh",
                        "reasoningSummary": "auto"
                    }
                }
            }
        },
    "google": {
      "npm": "@ai-sdk/google",
      "name": "google",
      "options": { "baseURL": "https://api.aiclaude.xyz/v1beta" },
      "models": {
        "gemini-3-pro-preview": { "name": "gemini-3-pro-preview", "thinking": true },
        "gemini-3-flash-preview": { "name": "gemini-3-flash-preview", "thinking": true },
        "gemini-2.5-flash-lite": { "name": "gemini-2.5-flash-lite", "thinking": true }
      }
    }
    },
  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "google/gemini-3-flash-preview",
  
  "mcp": {
    "context7": {
      "type": "local",
      "command": [
        "pnpx",
        "@upstash/context7-mcp"
      ],
      "enabled": true
    }
  }
}

opencode
> /connect

在 VS Code 或 Cursor 的扩展商店中搜索 Claude Code（由 Anthropic 官方发布），点击安装。

CC Switch 是一个开源桌面应用，可以一键配置 Claude Code 的 API 中转地址和密钥。

前往 GitHub Releases 下载对应平台的安装包：

• Windows：下载 .exe 或 .msi 安装包
• macOS：下载 .dmg 安装包
• Linux：下载 .AppImage 或 .deb

打开 CC Switch，添加一个新的 Provider：

• API Base URL 填写：https://api.aiclaude.xyz
• API Key 填写你在控制台获取的密钥
• 在设置中开启「应用到 Claude Code 插件」选项

配置完成后，CC Switch 会自动将中转地址写入 Claude Code 的配置中。

使用 API 中转时，需要跳过 Claude 官方的登录验证。通常 CC Switch 配置后即可自动跳过，如果仍然弹出登录页面，请按顺序尝试以下方法：

方法一：修改 config.json

创建或编辑 ~/.claude/config.json，写入以下内容后重启插件：

{
    "primaryApiKey": "aiclaudexyz"
}

方法二：禁用登录提示

在 VS Code / Cursor 设置中搜索 Claude Code，勾选 Disable Login Prompt 选项。

方法三：跳过初次安装引导

在 ~/.claude.json（与 .claude 文件夹同级）中添加以下字段：

{
    "hasCompletedOnboarding": true
}

在 VS Code 或 Cursor 的扩展商店中搜索 Claude Code（由 Anthropic 官方发布），点击安装。

CC Switch 是一个开源桌面应用，可以一键配置 Claude Code 的 API 中转地址和密钥。

前往 GitHub Releases 下载对应平台的安装包：

• Windows：下载 .exe 或 .msi 安装包
• macOS：下载 .dmg 安装包
• Linux：下载 .AppImage 或 .deb

打开 CC Switch，添加一个新的 Provider：

• API Base URL 填写：https://api.aiclaude.xyz
• API Key 填写你在控制台获取的密钥
• 在设置中开启「应用到 Claude Code 插件」选项

配置完成后，CC Switch 会自动将中转地址写入 Claude Code 的配置中。

使用 API 中转时，需要跳过 Claude 官方的登录验证。通常 CC Switch 配置后即可自动跳过，如果仍然弹出登录页面，请按顺序尝试以下方法：

方法一：修改 config.json

创建或编辑 ~/.claude/config.json，写入以下内容后重启插件：

{
    "primaryApiKey": "aiclaudexyz"
}

方法二：禁用登录提示

在 VS Code / Cursor 设置中搜索 Claude Code，勾选 Disable Login Prompt 选项。

方法三：跳过初次安装引导

在 ~/.claude.json（与 .claude 文件夹同级）中添加以下字段：

{
    "hasCompletedOnboarding": true
}