主题
快速开始
5 分钟内跑通你的第一次请求。
第 1 步：获取 API Key
进入 Shuro 控制台 → 注册（需完成邮箱验证）/登录 → 「令牌」 → 「添加新令牌」。
复制生成的令牌字符串，下文统称 <您的 API Key>。
第 2 步：选客户端
| 你要做什么 | 推荐客户端 |
|---|---|
| 终端里写代码 / agentic 编程 | Claude Code ⭐ 主流 |
| 用 GPT-5 写代码 | Codex CLI |
| 多 Provider 切换 / 一键测试 | CC Switch |
| IDE 内编辑（VS Code / JetBrains） | Cursor / Cline |
| 通用对话 GUI | OpenCode |
不确定选哪个？看 选择客户端 决策树。
第 3 步：配置 + 验证
下面以 Claude Code 为例，5 分钟跑通：
bash
# 1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
# 2. 配置环境变量
export ANTHROPIC_BASE_URL="https://shuro.vip"
export ANTHROPIC_AUTH_TOKEN="<您的 API Key>"
# 3. 验证
claude -p "Reply with one word: pong"powershell
# 1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# 2. 配置环境变量（永久）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://shuro.vip","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<您的 API Key>","User")
# 关闭 PowerShell 重开
# 3. 验证
claude -p "Reply with one word: pong"fish
# 1. 安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
fish_add_path ~/.local/bin
# 2. 配置环境变量（持久化）
set -Ux ANTHROPIC_BASE_URL "https://shuro.vip"
set -Ux ANTHROPIC_AUTH_TOKEN "<您的 API Key>"
# 3. 验证
claude -p "Reply with one word: pong"看到 pong 即配置成功。
第 4 步：日常使用
bash
# 进入项目目录
cd ~/your-project
# 交互模式（推荐）
claude
# 一次性命令
claude -p "把 main.py 重构成模块化结构"
# 指定模型
claude --model claude-opus-4-7常见首次启动问题
| 现象 | 解决 | 详细 |
|---|---|---|
command not found: claude | PATH 没加好 | Claude Code 安装 |
Invalid token 401 | Token 写错或失效 | 401 排查 |
| 一直 retry / propagating | 上游慢或模型选错 | retry 死循环 |
| install.sh 显示 ✅ 但 claude 命令找不到 | 安装阶段下载失败 | 安装下载失败 |