gahorouter 文档

简体中文

English

简体中文

English

Appearance

Trae：gahorouter 快速上手指南 ​

⏱️ 5 分钟完成：从创建 API Key 到在 Trae 中使用 Claude Code 进行 AI 辅助开发

两条安装路径，按需任选一条 ​

对比项路径 A：CLI + 插件路径 B：仅插件（无需 CLI）
适合谁开发者、喜欢命令行不想装 CLI、只用图形界面
安装步骤多一步（装 CLI）少一步
功能差异CLI + 侧边栏都能用仅侧边栏
配置方式CC Switch 或环境变量CC Switch 或环境变量（相同）

前置准备 ​

在开始之前，请确保：

第 1 步：创建 API Key（两条路径相同） ​

1.1 登录 gahorouter 平台 ​

访问：https://console.gahorouter.com/keys，输入账号密码。

1.2 创建新的 API Key ​

  1. 进入 API 密钥 页面
  2. 点击 「创建密钥」 按钮
  3. 填写配置信息：
配置项说明
名称必填，API Key 名称（便于识别）
分组必填，根据套餐订阅权限选择合适分组
自定义密钥可选，用于自定义字符串作为 API 密钥
IP 限制可选，设置允许/禁止访问的 IP 白名单或黑名单
  1. 点击 「创建」 生成 API Key

1.3 保存 API Key ​

进入 API 密钥 页面，复制 Key（sk-xxxxxx），保存到记事本备用。

路径 A：CLI + 插件 ​

第 2A 步：安装 Claude CLI ​

Windows（PowerShell 运行）：

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

macOS（推荐 Homebrew；如未安装 Homebrew，先运行下方命令）：

bash
# 安装 Homebrew（已有可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Claude Code
brew install --cask claude-code

Linux：

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

验证安装：

plaintext
claude --version
# 显示 "Claude CLI v1.x.x" 即为成功

第 3A 步：配置 API（二选一） ​

根据使用习惯选择适合你的方式，两种方式效果完全相同。

✅ 方式 A：使用 CC Switch（推荐新手） ​

CC Switch 是 gahorouter 提供的可视化配置工具，支持一键导入、多环境切换，无需手动编辑配置文件。

3A.1 安装 CC Switch

前往 https://github.com/farion1231/cc-switch 下载对应系统版本：

  • Windows：下载 .exe 安装包，安装后运行
  • macOS：下载 .dmg 安装包，安装后运行

3A.2 一键导入配置

  1. 登录 gahorouter，进入 API 密钥 页面
  2. 找到目标 Key，点击 「导出 CCS」 按钮
  3. 弹出跳转提示，点击 「允许」
  4. 系统自动打开 CC Switch 应用并完成配置导入

💡 CC Switch 将配置保存至 ~/.gahorouter/config.json，支持多环境切换（开发 / 测试 / 生产）

3A.3 验证配置

打开终端，输入：

plaintext
claude

进入 Claude Code 交互页面后，输入「你好」，等待回复。

  • ✅ Claude 返回正常回复 → 配置成功
  • ❌ Authentication failed → 检查 API Key 是否正确导入
  • ❌ Cannot connect to API → 检查网络连接

✅ 方式 B：手动设置环境变量（推荐开发者） ​

通过环境变量手动配置，适合熟悉命令行的开发者，方便在 CI/CD、Docker、脚本等场景中复用。

macOS / Linux：

编辑 ~/.zshrc（zsh）或 ~/.bashrc（bash），在末尾添加：

bash
# gahorouter API 配置
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://console.gahorouter.com"

保存后执行：

bash
source ~/.zshrc # zsh 用户
# 或
source ~/.bashrc # bash 用户

Windows PowerShell：

powershell
# 永久设置（写入系统用户环境变量，重启终端后生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxxxxxxxxxxxxxxxxxxxxx", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://console.gahorouter.com", "User")

验证环境变量：

bash
echo $ANTHROPIC_API_KEY # macOS/Linux
echo $env:ANTHROPIC_API_KEY # Windows PowerShell

输出你的 Key 值即为成功。

验证连接：

plaintext
claude

进入交互页面后，输入「你好」，等待回复。

  • ✅ Claude 返回正常回复 → 配置成功
  • ❌ Authentication failed → 检查 Key 值是否粘贴完整，首尾无空格
  • ❌ Cannot connect to API → 检查 ANTHROPIC_BASE_URL 是否正确或网络连接

⚠️ 优先级说明： 环境变量优先级高于 CC Switch 配置。若同时设置，环境变量会覆盖 CC Switch 的值。

路径 B：仅插件（无需安装 CLI） ​

适合不想使用命令行的用户。跳过 CLI 安装，直接在 Trae 中安装插件即可使用图形化界面。

第 2B 步：在 Trae 中安装 Claude Code 插件 ​

  1. 打开 Trae，点击左侧活动栏的 扩展图标，或按 Ctrl+Shift+X
  2. 在搜索框中输入 「Claude Code」
  3. 找到 Claude Code for VS Code，点击 「安装」（Install）
  4. 安装完成后，左侧活动栏会出现 ⚡ Spark 图标

💡 如果侧边栏没有显示图标，可能被折叠。右键点击活动栏空白区域或 ··· 更多菜单，勾选 「claude code: open」 即可将图标显示出来。

第 3B 步：配置 API（二选一） ​

插件通过读取系统环境变量或 CC Switch 配置获取 API Key，配置方式与路径 A 完全相同，二选一即可。

✅ 方式 A：使用 CC Switch（推荐新手） ​

参照路径 A 中 「方式 A：使用 CC Switch」 的步骤操作，完全相同。

配置完成后，无需打开终端，直接去第 4B 步验证。

✅ 方式 B：手动设置环境变量（推荐开发者） ​

macOS / Linux：

编辑 ~/.zshrc（zsh）或 ~/.bashrc（bash），在末尾添加：

bash
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://console.gahorouter.com"

保存后执行：

bash
source ~/.zshrc # zsh 用户
# 或
source ~/.bashrc # bash 用户

Windows PowerShell：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-xxxxxxxxxxxxxxxxxxxxxx", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://console.gahorouter.com", "User")

⚠️ Windows 设置完系统环境变量后，必须完全关闭 Trae 再重新打开，插件才能读取到新变量。

第 4B 步：验证插件连接 ​

  1. 在 Trae 中点击左侧 ⚡ Spark 图标，打开 Claude Code 面板
  2. 在对话框中输入「你好」
  3. Claude 返回正常回复 → 配置成功

常见错误：

  • ❌ Authentication failed → 检查 ANTHROPIC_API_KEY 是否正确，重启 Trae 后重试
  • ❌ Cannot connect → 检查 ANTHROPIC_BASE_URL 是否为 https://console.gahorouter.com，注意不带 /v1

第 4 步：在 Trae 中使用（两条路径相同） ​

模式 1：Trae 终端集成（路径 A 专属） ​

直接在 Trae 内置终端中运行 Claude CLI，无需安装额外插件。

优势：

  • ✅ 支持完整 CLI 参数（--files、--model 等）
  • ✅ 适合开发者和命令行用户

使用步骤：

  1. 用 Trae 打开一个项目（菜单栏 文件 → 打开文件夹，或启动页点击 Open Project）
  2. 打开终端（菜单栏 终端 → 新建终端，或快捷键 Ctrl+`；macOS 为 Control+`）
  3. 在终端中输入 claude 并回车，进入 Claude Code 交互页面
  4. 首次使用需确认信任当前工作区，按提示操作即可
  5. 开始对话，例如：「请分析这个项目的结构」

模式 2：Claude Code for VS Code 插件（路径 A / B 均可用） ​

Trae 基于 VS Code 内核，完整兼容 VS Code 扩展，可直接安装 Claude Code 插件获得图形化侧边栏界面。

优势：

  • ✅ 图形化界面，操作直观
  • ✅ 侧边栏对话，无需切换终端
  • ✅ 支持代码高亮和语法着色
  • ✅ 适合不熟悉命令行的用户

使用步骤：

  1. 打开 Trae 扩展市场（左侧活动栏点击扩展图标，或快捷键 Ctrl+Shift+X）
  2. 在搜索框中输入「Claude Code」
  3. 找到 Claude Code for VS Code，点击 「安装」（Install）（路径 B 用户已在第 2B 步完成）
  4. 安装完成后，左侧活动栏会出现 ⚡ Spark 图标，点击打开 Claude Code 面板
  5. 在对话框中与 Claude 交互

💡 如果侧边栏没有显示图标，可能被折叠。右键点击活动栏空白区域或 ··· 更多菜单，勾选 「claude code: open」 即可将图标显示出来。

💡 路径 A 用户两种模式可同时使用，共享同一套 API 配置。

第 5 步：实战对话示例 ​

场景 1：理解陌生项目 ​

plaintext
👤 你：请帮我理解这个项目的整体架构

🤖 Claude：我来分析这个项目...
[自动读取项目目录结构]
这是一个基于 Express + MongoDB 的 REST API 项目...

场景 2：代码重构咨询 ​

bash
# 带文件启动（终端模式，路径 A）
claude chat --files "src/utils/emailSender.js"
plaintext
👤 你：这个文件的代码质量如何？有什么改进建议？

🤖 Claude：代码质量评估：⭐⭐⭐ (3/5)
✅ 做得好的地方：...
❌ 存在的问题：...
🔧 重构建议（优先级排序）：...

场景 3：Bug 调试 ​

plaintext
👤 你：运行报错了：TypeError: Cannot read properties of undefined

🤖 Claude：让我分析这个错误...
[定位到 src/api/user.js 第 42 行]
问题原因：user 对象未初始化就访问了属性...
修复方案：...

对话技巧 ​

技巧示例
提供文件上下文--files "src/auth/**/*.js"
分步骤拆解任务先理解 → 再设计 → 再生成代码
触发内置 Skill说「审查代码」/「写测试」/「报错了」

获取帮助 ​

如遇到问题：

  • 技术支持邮箱：gaho7777@163.com

相关链接 ​