gahorouter 文档

简体中文

English

简体中文

English

Appearance

Cursor：gahorouter 快速上手指南 ​

5 分钟完成从创建 API Key 到开始使用 Claude Code 进行 AI 辅助开发

📋 前置准备 ​

在开始之前，请确保：

  • 注册 gahorouter 账号：访问 https://console.gahorouter.com/keys，注册并订阅（有免费试用）。
  • 安装 Cursor：从 https://cursor.sh/ 下载最新版，安装后打开测试。
  • 安装 CC Switch：配置工具，从 https://github.com/farion1231/cc-switch 下载系统对应版本（Windows 用 .exe，macOS 用 .dmg），安装后运行。
  • 网络：需要有稳定的网络连接（本操作指南中，下载 Claude Code 时，需能够科学上网）。

1. 创建 API Key ​

1.1 登录 gahorouter 平台 ​

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

1.2 创建新的 API Key ​

进入 API 密钥 页面，点击 "创建密钥" 按钮，填写配置信息：

配置项说明
名称必填，API Key 名称（便于识别）
分组必填，根据套餐订阅权限选择合适分组
自定义密钥可选，用于自定义字符串作为 API 密钥
IP 限制可选，设置允许使用密钥的 IP 白名单、限制禁止访问的 IP 黑名单

点击 "创建" 生成 API Key。

1.3 查看 API Key 信息 ​

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

2. 安装和配置 Claude Code ​

2.1 安装 Claude CLI ​

Windows 安装：PowerShell 运行

powershell
# 使用 PowerShell 安装
irm https://claude.ai/install.ps1 | iex

macOS 安装：终端运行（推荐 Homebrew，先安装 Homebrew 如无：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）

bash
# 使用 Homebrew 安装（推荐）
brew install --cask claude-code

# 或使用 curl 安装
curl -fsSL https://claude.ai/install.sh | sh

Linux 安装：终端运行

bash
# 使用 curl 安装
curl -fsSL https://claude.ai/install.sh | sh

验证安装：输入 claude --version，见 "Claude CLI v1.x.x" 即成功

bash
# 检查安装是否成功
claude --version

2.2 配置 gahorouter API Key ​

安装完成后，有 2 种配置 Claude Code API 的方式：

方式 A：通过 ccswitch 工具（推荐新手） ​

ccswitch 是开源提供的配置管理工具，可以快速切换和管理多个 API 配置。

若未安装，前往官方下载 https://github.com/farion1231/cc-switch（根据操作系统安装相应版本）。

操作步骤如下：

  1. 登录 gahorouter，进入 API 密钥 页面。

  2. 点击导出 CCS。

  3. 点击允许跳转，打开 CC Switch 应用并自动导入步骤一的配置。

方式 B：通过环境变量（推荐开发者） ​

macOS/Linux：编辑 ~/.zshrc 或 ~/.bashrc

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

然后执行：

bash
source ~/.zshrc # 或 source ~/.bashrc

Windows PowerShell：

powershell
# 临时设置（当前会话）
$env:ANTHROPIC_API_KEY = "sk-gahorouter-xxxxxxxxxxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL = "https://console.gahorouter.com"

# 永久设置（系统环境变量）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-gahorouter-xxx", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://console.gahorouter.com", "User")

优先级说明：

  • 环境变量优先级 > ccswitch 配置
  • 如果两者都设置，环境变量会覆盖 ccswitch 的配置

2.3 验证配置 ​

在终端执行测试：

  1. 终端中输入 claude，打开 Claude Code 交互页面，并确认相信工作区。

  2. 输入"你好"，等待 Claude 回复。

预期结果：

  • ✅ Claude 返回友好的回复消息
  • ❌ 如果报错 Authentication failed：检查 API Key 是否正确
  • ❌ 如果报错 Cannot connect to API：检查 BASE_URL 是否正确或网络连接

3. 开始使用 Claude Code ​

3.1 使用方式说明 ​

gahorouter 支持两种使用方式：

方式 1：Cursor 终端集成（推荐） ​

直接在 Cursor 的集成终端中使用 Claude CLI 命令。

优势：

  • ✅ 无需安装额外插件
  • ✅ 配置简单，统一使用 ccswitch 管理
  • ✅ 支持完整的 CLI 功能（--files、--model 等参数）
  • ✅ 适合开发者和命令行用户

使用步骤：

  1. 点击【Open project】，使用 Cursor 打开一个项目。

  2. 打开终端 Terminal。

  3. 输入 claude 回车，打开 Claude Code CLI 交互页面。

  4. 与 Claude 对话 —— "请分析这个项目的结构"，可对目录下相关内容进行对话或交互。

方式 2：使用 Claude Code for VS Code 插件（适合不喜欢命令行的用户） ​

通过 Cursor 扩展提供图形化界面交互。

优势：

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

安装步骤：

  1. 打开 Cursor 扩展市场，搜索 Claude Code for VS Code。

  2. 点击 Install 安装插件。

  3. 安装后侧边栏会出现 icon，点击 Spark 图标打开 Claude Code 面板。

  4. 使用对话框，与 Claude 对话。

（如果没有 💥 快捷 icon，因为被折叠到更多里面了。右键【···】，勾选上 claude code:open，就能展示隐藏的功能的快捷键了）

💡 提示：两种方式可以同时使用，共享 ccswitch 配置。插件会自动读取 ccswitch 的当前配置。

4. Cursor 实战演练 ​

本章节将展示 Cursor 中使用 Claude Code 的真实场景，包括对话技巧和官方 Skill 的应用。

使用场景举例 ​

场景 1：理解陌生项目 ​

假设你刚接手一个项目，需要快速了解它。

bash
# 在 Cursor 终端中（Ctrl+`）
cd ~/projects/legacy-api

# 启动对话
claude chat

对话示例：

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

🤖 Claude：我来分析这个项目...

[Claude 会自动读取项目结构]

这里是回答

---

👤 你：认证流程是怎么实现的？

🤖 Claude：让我查看认证相关代码...

[分析 src/xxx.js 和 src/xxx.js]

这里是回答

场景 2：代码重构咨询 ​

bash
claude chat --files "src/utils/emailSender.js"

对话示例：

plaintext
👤 你：这个文件的代码质量如何？有什么改进建议？

🤖 Claude：我来分析 emailSender.js...

代码质量评估：⭐⭐⭐ (3/5)

✅ 做得好的地方：
1. 使用了 nodemailer 成熟库
2. 配置通过环境变量管理
3. 有基础的错误处理

❌ 存在的问题：
1. 缺少重试机制（发送失败无法重试）
2. 没有邮件队列（并发发送会阻塞）
3. 硬编码的邮件模板（难以维护）
4. 缺少日志记录
5. 测试覆盖率为 0

🔧 重构建议：

优先级 P0（必须修复）：
- 添加重试机制（使用 retry 库）
- 添加错误日志

优先级 P1（建议优化）：
- 引入邮件队列（Bull + Redis）
- 模板化邮件内容（使用 handlebars）

优先级 P2（长期改进）：
- 添加单元测试
- 性能监控（发送耗时、成功率）

需要我帮你重构吗？我可以生成改进后的代码。

场景 3：需求澄清 ​

plaintext
👤 你：我需要实现用户头像上传功能，帮我理清思路

🤖 Claude：[自动激活 Clarification Engine Skill]

让我帮你澄清需求...

核心问题：
1. 存储方式？
- 本地文件系统
- 云存储（AWS S3 / 阿里云 OSS）
- 数据库（不推荐）

2. 文件限制？
- 大小限制：建议 2MB
- 格式限制：jpg, png, webp
- 尺寸要求：是否需要裁剪/压缩

3. 安全考虑？
- 文件类型验证（防止上传恶意文件）
- 文件名处理（防止路径遍历）
- 访问控制（公开 or 私有）

4. 性能优化？
- 图片压缩
- CDN 加速
- 缩略图生成

请回答这些问题，我会给出完整方案。

对话技巧总结 ​

明确上下文

bash
# ✅ 好的提问
claude chat --files "src/auth/**/*.js" "分析认证模块的安全性"

# ❌ 差的提问
claude chat "代码有问题"

分步骤执行

plaintext
第 1 次对话：理解需求
第 2 次对话：设计方案
第 3 次对话：生成代码
第 4 次对话：代码审查

利用 Skill 自动激活

  • 说"审查代码" → 自动激活 Code Review
  • 说"写测试" → 自动激活 Test Generation
  • 说"报错了" → 自动激活 Debug Assistant

5. 监控使用情况 ​

5.1 查看 Token 消耗 ​

在 gahorouter 查看：

  1. 系统概览：进入仪表盘。

  2. API 累计用量：进入 API 密钥页面。

  3. 实时日志：进入使用记录页面。

获取帮助 ​

如遇到问题：

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