开发者资源

Claude Code in VS Code & Cursor

在 VS Code 或 Cursor 中安装 Claude Code extension，并通过共享 settings 接入 RunAPI。

概览

Claude Code 官方 extension 可在 VS Code 和 Cursor 中运行。两款 editor 使用同一份 Claude Code user settings，因此本指南只需安装对应 extension，并在 ~/.claude/settings.json 中配置一次 RunAPI。

开始前准备

安装受支持版本的 VS Code 或 Cursor。当前 VS Code 最低版本请查看官方 extension 指南。
在身份验证指南中创建标准 API key。不要将密钥写入 workspace settings 或源码仓库。
从模型目录复制支持 Anthropic Messages 的 model identifier。

安装

安装官方 anthropic.claude-code extension：

VS Code： 打开 VS Code Marketplace 页面，或在 Extensions 中搜索 Claude Code。
Cursor： 打开 cursor:extension/anthropic.claude-code，或在 Extensions 中搜索 Claude Code。

extension 已包含 chat panel 所需的 runtime。只有需要在 integrated terminal 中运行 claude 时，才需要另外安装 standalone CLI。

配置 RunAPI

打开 ~/.claude/settings.json，添加共享的 user-level environment settings：

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

在 VS Code 或 Cursor settings 中搜索 Claude Code login，为此 custom endpoint 启用 Disable Login Prompt。User settings 会与 CLI 共享；VS Code extension settings 只控制 extension 行为。

不要把真实密钥写入 .claude/settings.json 或 editor workspace settings，因为这些文件可能被提交。

选择模型

将 YOUR_RUNAPI_MODEL_ID 替换为模型目录中的准确 identifier。在 Claude Code panel 中，/model 可切换当前模型，/status 可查看 active model。

验证

修改 extension 或 settings 后 reload editor window。
打开 Claude Code Spark panel。
运行 /status，确认 user settings 和模型。
发送 用一句话描述这个仓库。，确认收到正常响应。

排查问题

extension 无法安装： 确认 editor 版本符合官方要求。
没有 Spark icon： reload editor window，然后重启 editor。
仍出现登录提示： 在 Claude Code extension settings 中启用 Disable Login Prompt。
panel 没有继承 shell 变量： 使用 ~/.claude/settings.json，或从已配置的终端启动 editor。GUI application 通常不会继承终端环境。
CLI 可用但 panel 无响应： reload window，并用 standalone CLI 复现请求以查看更详细的诊断。
身份验证或模型选择失败： 在身份验证指南中检查密钥，并从模型目录复制准确 identifier。

下一步

协议行为请查看 LLM API 快速开始，请求字段请查看 Anthropic Messages API 参考。如需在 editor 中添加 RunAPI tools，请继续查看 MCP 概览。