# Claude Code 桌面版与 IDE 扩展

> Claude Desktop、Claude Code 桌面入口与 Passion8 的配置边界,哪些能直连网关,哪些只是 MCP 工具桥接。

URL: https://docs.passion8.cc/docs/claude-code/desktop
Language: zh-CN
Publisher: Passion8

很多人说的 "Claude Desktop" 其实是几种不同入口。先分清入口,再配置,能少走很多弯路。

如果你要横向比较 CLI、VS Code、JetBrains、Desktop、Web、Slack、CI/CD、Code Review 和 Ultrareview 的入口边界,看 [平台与集成](https://docs.passion8.cc/docs/claude-code/platforms-integrations)。Desktop quickstart、Linux beta、scheduled tasks、Claude Code on the web、Remote Control、VS Code、JetBrains 和 Slack 的工作流细节见 [Desktop、Web 与 IDE 工作流](https://docs.passion8.cc/docs/claude-code/desktop-web-ide)。




不要把消费版 Claude Desktop 当成 Claude Code CLI 来配置。`ANTHROPIC_BASE_URL` 和 `~/.claude/settings.json` 是 Claude Code 侧的配置;普通 Claude Desktop 聊天流量不会因为你设置了它们就自动走 Passion8。




## 先选对入口

| 入口 | 是否适合接 Passion8 | 适合场景 |
| --- | --- | --- |
| Claude Code CLI | 推荐 | 终端开发、脚本、仓库内长期工作 |
| Claude Code IDE / VS Code 扩展 | 推荐 | 想在编辑器里用 Claude Code |
| Claude Code Desktop / Desktop 内 Code 入口 | 看组织配置 | 需要图形化管理 Code 会话 |
| Claude Desktop MCP 桥接 | 可选,但不是网关接入 | 想让 Claude Desktop 调用本机 Claude Code 工具 |
| 消费版 Claude Desktop 聊天 | 不作为 Passion8 接入方案 | 日常聊天、非本地开发任务 |

## 推荐方案:Claude Code CLI

如果你的目标是用 Passion8 调 Claude,优先用 Claude Code CLI。它最明确、最好排错。

```bash
export ANTHROPIC_BASE_URL="https://passion8.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的 Passion8 API Key"
claude -p "用一句话说明当前目录是什么"
```

长期使用建议写进 `~/.claude/settings.json`:

```json title="~/.claude/settings.json"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://passion8.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key"
  }
}
```




项目里可放 `.claude/settings.json` 共享团队规则,但不要写 Key。个人密钥放全局 `~/.claude/settings.json` 或本机环境变量。




## VS Code / IDE 扩展

IDE 扩展不总是继承 shell 环境变量。更稳的方式是在 IDE 设置里给 Claude Code 扩展写 `environmentVariables`:

```json title="VS Code settings.json"
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://passion8.cc" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的 Passion8 API Key" }
  ]
}
```

如果你的编辑器里能打开 Claude Code 终端,也可以先在终端里跑:

```bash
echo $ANTHROPIC_BASE_URL
claude doctor
```

确认它看到的是 `https://passion8.cc`。

## Claude Code Desktop / Desktop 内 Code 入口

官方文档对桌面端网关有一个关键边界:Desktop app 的网关路由来自组织或管理员分发的配置,不是用户自己在终端里加 `ANTHROPIC_BASE_URL` 就能生效。

实际建议:

- 你只是个人接入 Passion8:用 Claude Code CLI 或 IDE 扩展。
- 你的团队有统一分发配置:按团队管理员给的 Desktop gateway 配置走。
- 你不确定当前 Desktop 是否走网关:不要猜,用 CLI 的 `claude -p` 先跑通。




如果 Desktop 里还能正常用 Claude 官方账号,不代表它已经走了 Passion8。判断依据应该是 Passion8 控制台用量是否增加,以及 Claude Code 侧的 `claude doctor` / 请求结果是否正常。




## 消费版 Claude Desktop

消费版 Claude Desktop 是 Claude 账号客户端,不是一个可填写第三方 Anthropic 兼容 Base URL 的通用客户端。它可以接 MCP 工具,但 MCP 工具连接不等于把模型后端改成 Passion8。

如果你的目标是"让模型请求走 Passion8",请回到 Claude Code CLI / IDE 扩展。如果你的目标是"让 Claude Desktop 能调用本机工具",再看下一节 MCP 桥接。

## Claude Desktop MCP 桥接

这是另一个常见需求:你想在 Claude Desktop 聊天里调用本机 Claude Code 的能力。这可以用 MCP,但它解决的是"工具桥接",不是"把 Desktop 模型请求改走 Passion8"。

先确认 Claude Code 支持 MCP stdio server:

```bash
claude mcp serve
```

然后在 Claude Desktop 的 MCP 配置里加入:

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {
        "ANTHROPIC_BASE_URL": "https://passion8.cc",
        "ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key"
      }
    }
  }
}
```

重启 Claude Desktop 后,在 MCP / 工具列表里确认 `claude-code` 已连接。




这段 `env` 只影响被启动的 `claude mcp serve` 进程。Claude Desktop 自己生成回复的模型流量是否走 Passion8,取决于 Desktop app 的官方网关配置,不是这段 MCP 配置。




## 排错顺序







### 先测 CLI

```bash
claude -p "ping"
```

CLI 不通时,先看 [安装与配置](https://docs.passion8.cc/docs/claude-code/install) 和 [常见问题](https://docs.passion8.cc/docs/claude-code/troubleshooting)。






### 再测 IDE

确认 IDE 扩展是否读取到 `claudeCode.environmentVariables`,必要时重启编辑器。






### 最后测 Desktop

Desktop 不要靠猜。能看到 Passion8 控制台用量、组织网关配置明确生效,才算真的接入成功。






## 官方参考

- [Desktop application](https://code.claude.com/docs/en/desktop.md)
- [Desktop quickstart](https://code.claude.com/docs/en/desktop-quickstart.md)
- [VS Code](https://code.claude.com/docs/en/vs-code.md)

## 接着看



- [安装与配置](https://docs.passion8.cc/docs/claude-code/install): Claude Code CLI 的标准 Passion8 接入方式。
- [平台与集成](https://docs.passion8.cc/docs/claude-code/platforms-integrations): 比较 IDE、Desktop、Web、Slack、CI/CD、Code Review 和云端 review 的运行位置与 Passion8 边界。
- [成本与缓存](https://docs.passion8.cc/docs/claude-code/cost-saving): 把 Claude 用得更稳,减少重复 token。