---
title: Claude Code in VS Code & Cursor | RunAPI
description: 在 VS Code 或 Cursor 中安装 Claude Code extension，并通过共享 settings 接入 RunAPI。
url: https://runapi.ai/zh-CN/docs/resources/tool-integrations/claude-code-vscode-cursor.md
canonical: https://runapi.ai/zh-CN/docs/resources/tool-integrations/claude-code-vscode-cursor
locale: zh-CN
---

> HTML version: https://runapi.ai/zh-CN/docs/resources/tool-integrations/claude-code-vscode-cursor
> Site index for agents: https://runapi.ai/llms.txt

# Claude Code in VS Code & Cursor

## 概览

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

## 开始前准备

* 安装受支持版本的 VS Code 或 Cursor。当前 VS Code 最低版本请查看[官方 extension 指南][1]。
* 在[身份验证指南](https://runapi.ai/zh-CN/docs/guides/authentication)中创建标准 API key。不要将密钥写入
  workspace settings 或源码仓库。
* 从[模型目录](https://runapi.ai/zh-CN/models)复制支持 Anthropic Messages 的 model identifier。



[1]: https://code.claude.com/docs/en/vs-code

## 安装

安装官方 `anthropic.claude-code` extension：

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



[1]: https://marketplace.visualstudio.com/items?itemName=anthropic.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` 替换为[模型目录](https://runapi.ai/zh-CN/models)中的准确 identifier。在
Claude Code panel 中，`/model` 可切换当前模型，`/status` 可查看 active model。

## 验证

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

## 排查问题

* **extension 无法安装：** 确认 editor 版本符合[官方要求][1]。
* **没有 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 复现请求以查看更详细的诊断。
* **身份验证或模型选择失败：**
  在[身份验证指南](https://runapi.ai/zh-CN/docs/guides/authentication)中检查密钥，并从[模型目录](https://runapi.ai/zh-CN/models)复制准确
  identifier。



[1]: https://code.claude.com/docs/en/vs-code#fix-common-issues

## 下一步

协议行为请查看 [LLM API 快速开始](https://runapi.ai/zh-CN/docs/guides/llm-api/quickstart)，请求字段请查看
[Anthropic Messages API 参考](https://runapi.ai/zh-CN/docs/api/anthropic/messages)。如需在
editor 中添加 RunAPI tools，请继续查看 [MCP 概览](https://runapi.ai/zh-CN/docs/resources/mcp)。

---

## More from RunAPI

- [Home](https://runapi.ai/.md)
- [模型](https://runapi.ai/zh-CN/models.md)
- [AI 视频 API 对比](https://runapi.ai/zh-CN/ai-video-api-comparison.md)
- [OpenClaw 集成](https://runapi.ai/zh-CN/openclaw.md)
- [OpenClaw 最佳 API](https://runapi.ai/zh-CN/best-api-for-openclaw.md)
- [OpenClaw 图片生成](https://runapi.ai/zh-CN/openclaw-image-generation.md)
- [Hermes 智能体集成](https://runapi.ai/zh-CN/hermes-agent.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [Claude API 定价](https://runapi.ai/zh-CN/claude-api-pricing.md)
- [ChatGPT API 定价](https://runapi.ai/zh-CN/chatgpt-api-pricing.md)
- [OpenAI API 定价](https://runapi.ai/zh-CN/openai-api-pricing.md)
- [Gemini API 定价](https://runapi.ai/zh-CN/gemini-api-pricing.md)
- [Claude Code 定价](https://runapi.ai/zh-CN/claude-code-pricing.md)
- [Claude Code API](https://runapi.ai/zh-CN/claude-code-api.md)
- [Claude Code 对比 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Claude Max 对比 API](https://runapi.ai/zh-CN/claude-max-vs-api.md)
- [Requesty 替代方案](https://runapi.ai/zh-CN/requesty-alternative.md)
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [Skills](https://runapi.ai/zh-CN/skills.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [反馈](https://runapi.ai/)
- [联系](mailto:support@runapi.ai)
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "TechArticle",
    "headline": "Claude Code in VS Code & Cursor",
    "description": "在 VS Code 或 Cursor 中安装 Claude Code extension，并通过共享 settings 接入 RunAPI。",
    "url": "https://runapi.ai/zh-CN/docs/resources/tool-integrations/claude-code-vscode-cursor",
    "mainEntityOfPage": "https://runapi.ai/zh-CN/docs/resources/tool-integrations/claude-code-vscode-cursor"
  }
]
```