桌面版与 IDE 扩展

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

如果你要横向比较 CLI、VS Code、JetBrains、Desktop、Web、Slack、CI/CD、Code Review 和 Ultrareview 的入口边界,看 平台与集成。Desktop quickstart、Linux beta、scheduled tasks、Claude Code on the web、Remote Control、VS Code、JetBrains 和 Slack 的工作流细节见 Desktop、Web 与 IDE 工作流。

#先选对入口

#推荐方案:Claude Code CLI

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

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

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://passion8.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key"
  }
}

#VS Code / IDE 扩展

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

{
  "claude-code.environmentVariables": {
    "ANTHROPIC_BASE_URL": "https://passion8.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key"
  }
}

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

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 先跑通。

#消费版 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:

claude mcp serve

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

{
  "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 已连接。

#排错顺序

claude -p "ping"

#官方参考

• Desktop application
• Desktop quickstart
• VS Code

#接着看