VS Code 图形化操作教程

适合不想频繁切换终端窗口的用户：您可以直接在 VS Code 编辑器中打开项目、配置 TopRouter API 环境，并运行您的 AI 客户端。

---

1. 打开项目

1. 安装并打开 VS Code。
2. 菜单栏选择 File > Open Folder... (打开文件夹) 并选择您的代码项目目录。
3. 打开内置终端：选择 Terminal > New Terminal (或按下快捷键 Ctrl+``` / Cmd+```)。

---

2. 在内置终端设置 TopRouter 环境变量

在 VS Code 内置终端中设置客户端所需的 API Key 和 Base URL。

macOS / Linux (zsh 或 bash)

export OPENAI_BASE_URL="https://toprouter.cc"
export OPENAI_API_KEY="您的_toprouter_api_key"
export OPENAI_MODEL="openai/gpt-5.5"

Windows (PowerShell)

$env:OPENAI_BASE_URL="https://toprouter.cc"
$env:OPENAI_API_KEY="您的_toprouter_api_key"
$env:OPENAI_MODEL="openai/gpt-5.5"

---

3. 运行客户端

由于终端当前处于您项目的根目录下，启动的 AI 助手将能够直接扫描、理解和修改项目中的文件。您可以直接运行命令：

# 启动 Codex
codex --model openai/gpt-5.5

# 或者启动 Claude Code
claude

AI 助手修改的所有文件都会在 VS Code 的源代码管理面板中高亮显示，您可以在图形界面中直观地审阅改动。

---

4. 安全开发习惯

• 禁止将 API Key 写入代码：千万不要将 API Key 硬编码在代码文件或提交到公开的代码仓库中。
• 配置 .gitignore：确保包含敏感配置的文件（如 .env）已添加至 .gitignore 中。
• 独立密钥：多人协作开发时，团队中的每个人都应在 TopRouter 创建并使用各自的 API Key，避免共享密钥。