VS Code
在 VS Code 里通过 Cline、Codex 或 Claude Code 插件调用 TokenRoute。
需要中文界面的话,扩展商店搜 chinese,装「中文(简体)语言包」后重启。
装哪个插件
按 Ctrl+Shift+X(macOS 是 Cmd+Shift+X)打开扩展面板:
| 插件 | 适合 |
|---|---|
| Cline | 手填 Base URL 和模型名,最灵活,跨平台一致 |
| Codex | 使用 Codex 共享配置;仍需在插件中验证调用 |
| Claude Code | 想在 IDE 里用 Claude 系列模型 |
三个插件用同一个 API Key,不必分别申请。
配置 Cline
装好后进插件面板,点右上角设置:
| 字段 | 填什么 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.smartwan.com/v1 |
| OpenAI Compatible API Key | 你的 API Key |
| Model ID | 手填模型名 |
常用模型:
deepseek-v4-pro
claude-sonnet-5
gpt-5.5
kimi-k2.6
grok-4.6
点 Done 保存。
配置 Codex 插件
Codex CLI 与 IDE 插件共用配置层。按 Codex CLI 页在用户级 ~/.codex/config.toml 配置 model_provider、model 和 model_providers.tokenroute,并设置其 env_key 指向的 TOKENROUTE_API_KEY。
在插件右上角齿轮中选择 Codex Settings → Open config.toml 可打开配置。不要用一组未关联 Provider 的 OPENAI_* 变量替代完整配置。修改环境变量后,完全退出 VS Code,再从已设置变量的终端启动,使新进程读取变量。
上述共享配置方式依据官方配置文档;TokenRoute 的最小调用验证是在 CLI 中完成,IDE 中仍需按本页末尾步骤发起一条对话确认。
配置 Claude Code 插件
先参考 Claude Code 的配置说明。下面是 Bash 环境变量示例;IDE 是否已读到配置,以插件中的实际调用为准:
export ANTHROPIC_AUTH_TOKEN="sk-你的Token"
export ANTHROPIC_BASE_URL=https://api.smartwan.com
Cline 走 OpenAI 兼容协议,Base URL 带 /v1;
Claude Code 走 Anthropic 协议,Base URL 不带 /v1。
填反了会报 404。
环境变量怎么设
| 系统 | 当前终端生效 | 持久生效 |
|---|---|---|
| Windows | PowerShell:$env:变量名="值" | 系统环境变量设置,或直接用插件设置项 |
| macOS | export 变量名="值" | 写入 ~/.zshrc |
| Linux | export 变量名="值" | 写入 ~/.bashrc 或 ~/.zshrc |
改完环境变量要重启 VS Code 才能读到。
验证
在插件聊天框发一条消息,能正常返回即接入成功。
遇到问题
| 现象 | 处理 |
|---|---|
| Cline 报 404 | Base URL 要带 /v1;Claude Code 插件则不带 |
| 认证失败 | Key 是否完整、以 sk- 开头;环境变量改完有没有重启 VS Code |
| 模型不存在 | Model ID 要和模型列表完全一致,大小写敏感 |
| 插件读不到环境变量 | 从终端敲 code . 启动,让 VS Code 继承当前 shell 的变量 |
更多见常见问题。