Claude Code 配置教程

安装完成后，用 Passion8 地址、API Key 和已开放的 Claude 模型 ID 将 Claude Code 接入本站；本地 API Key 接入无需 Anthropic 账号或 OAuth 登录。本文提供两种方式:推荐用 CC-Switch 图形化配置,或手动配置环境变量。新手建议直接用 CC-Switch。

#配置前准备

先确认本机已经能运行 Claude Code:

claude --version

如果还没安装,先看 安装 Claude Code。

你需要准备下面的接入信息：

完成配置后只有一个判断标准:测试命令能正常返回内容。如果返回认证错误,先检查 Token;如果返回连接错误,先检查 Base URL 是否误写了 /v1。

#用 CC-Switch 配置(推荐)

CC-Switch 用图形界面管理 Claude Code 配置,不用手写 JSON,是最省事的接入方式。macOS 和 Windows 填写字段一致。

claude -p "用一句话确认连接正常"

#也接入 Claude Desktop 桌面端(可选)

Claude Code 和 Claude Desktop 是两个不同的应用:Claude Code 用 ~/.claude/settings.json,Claude Desktop 用自己的配置。在 CC-Switch 里它们是两个独立入口——应用切换器里分别显示为「Claude」和「Claude Desktop」,后者图标右下角有一个小显示器标区分。所以桌面端要单独再配一次(内容和上面基本相同)。

#手动配置

如果你不想装 CC-Switch,或希望直接控制环境变量和 settings.json,可以手动配置。

mkdir -p ~/.claude

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

claude -p "用一句话确认连接正常"

echo 'export ANTHROPIC_BASE_URL="https://passion8.cc"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的 Passion8 API Key"' >> ~/.zshrc
source ~/.zshrc

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

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

claude -p "用一句话确认连接正常"

setx ANTHROPIC_BASE_URL "https://passion8.cc"
setx ANTHROPIC_AUTH_TOKEN "sk-你的 Passion8 API Key"

#进阶配置模板

以下模型 ID 按 2026-10-11 官方模型目录核对：Sonnet 5.5、Opus 5.5、Fable 5.1、Haiku 5.5。官方提供不等于你的 Passion8 Key 已开放；复制前对照本站模型列表，不可用的档位应删除或改成你实际有权限的 ID。模板只保留 ANTHROPIC_MODEL 作为默认模型来源，不再同时写冲突的顶层 model。未验证的 [1M] 后缀不放入默认模板。

上面的最小配置用于基础接入。如果你已经熟悉 Claude Code 权限、缓存和模型切换,可以在 ~/.claude/settings.json 里使用下面这份进阶模板。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key",
    "ANTHROPIC_BASE_URL": "https://passion8.cc",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "auto",
    "DISABLE_AUTOUPDATER": "1",
    "DISABLE_BUG_COMMAND": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "DISABLE_ERROR_REPORTING": "1",
    "DISABLE_TELEMETRY": "1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-haiku-5-5",
    "ANTHROPIC_MODEL": "claude-opus-5-5"
  },
  "attribution": {
    "commit": "",
    "pr": ""
  },
  "permissions": {
    "defaultMode": "bypassPermissions"
  },
  "skipDangerousModePermissionPrompt": true
}

默认不写 ENABLE_PROMPT_CACHING_1H 时,Claude Code 在 API/provider 场景会走 5 分钟 Prompt Cache TTL。只有你确认同一套大上下文会在 5 分钟后、1 小时内反复复用时,再单独加下面这一项:

{
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}

#关键字段解释

#关于 1 小时缓存

ENABLE_PROMPT_CACHING_1H=1 不是默认推荐项。它适合反复加载同一套大上下文,并且两轮请求经常相隔 5 分钟以上、1 小时以内的场景。未配置时保持 5 分钟缓存,写入成本更低,也更适合作为默认配置。

更多缓存细节见 Prompt 缓存,权限风险见 权限与模式。

#检查是否生效

先运行测试请求，并用 /status 与 Passion8 调用记录核对实际路由：

claude -p "用一句话说明当前项目是什么"

如果失败,优先检查:

如果 claude 命令、PATH、代理、TLS 或登录异常,看 安装与登录排错。如果报鉴权失败、模型不存在或运行中 API 错误,看 常见问题 与 错误参考。

#接入常见问题

#需要 Anthropic 账号或 Claude 订阅吗？

本机 Claude Code 使用本文的 Passion8 API Key 配置即可接入，无需 Anthropic OAuth 或 Claude 订阅。云端托管入口不由这份本地配置自动开通。

#为什么 Claude Code 地址不带 /v1？

本文使用 Anthropic 兼容入口，ANTHROPIC_BASE_URL 填 https://passion8.cc。不要照抄 Codex 的 https://passion8.cc/v1；不同客户端的协议和地址要求不同。

#如何选择模型，或在同一编辑器里切换四家模型？

使用 Passion8 控制台向你的令牌开放的精确模型 ID，在进阶模板的 ANTHROPIC_MODEL 中指定。要使用 Claude 官方面板，看 VS Code 扩展教程；要在一个扩展里切换 Claude、GPT、Gemini 和 Grok，看 Cline 多模型配置。

#相关页面

#本次字段核对

核对日期：2026-10-11。官方模型目录、环境变量、配置字段。仅核对文档，不代表对 Passion8 各模型完成实际调用测试。