Passion8Docs
Claude Code

配置教程

在 macOS 和 Windows 上用手动配置或 CC-Switch 配置 Claude Code 接入 Passion8。

安装完成后,需要把 Claude Code 指向 Passion8。本文提供两种方式:推荐用 CC-Switch 图形化配置,或手动配置环境变量。新手建议直接用 CC-Switch。

Claude Code 的 Passion8 Base URL 是 https://passion8.cc,不带 /v1。Token 使用 ANTHROPIC_AUTH_TOKEN,填你的 Passion8 API Key。

#配置前准备

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

claude --version

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

你需要准备两项信息:

项目值
Base URLhttps://passion8.cc
Token 变量ANTHROPIC_AUTH_TOKEN

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

#用 CC-Switch 配置(推荐)

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

1

安装并打开 CC-Switch

如果还没安装,先从 CC-Switch Releases 下载对应系统版本。打开后在应用列表里选择 Claude Code。

2

添加应用专属配置

添加 Claude Code 的应用专属配置,固定填写:

字段值
名称Passion8 Claude Code
端点/Base URLhttps://passion8.cc
API Keysk-你的 Passion8 API Key
环境变量ANTHROPIC_AUTH_TOKEN
3

保存并测试

保存并应用配置,然后重启 Claude Code。在 macOS 终端或 Windows PowerShell 里测试:

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

能正常返回一句话,就说明 CC-Switch 已经把 Claude Code 切到 Passion8。

上面这套配置适用于 Claude Code CLI 和 IDE 插件(插件复用 CLI 的 ~/.claude/settings.json)。Claude Desktop 桌面端不吃这套配置,它在 CC-Switch 里是另一个独立入口,需要单独再配一次,见下一节。

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

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

1

切到 Claude Desktop 入口

在 CC-Switch 左侧应用切换器里选择 Claude Desktop(右下角带显示器小标的那个)。如果没看到,去「设置 → 通用 → 应用可见性」确认它没被隐藏。

2

添加供应商(或一键导入)

如果你刚才已经在 Claude Code 里配好了 Passion8,直接点 「将 Claude Code 中已有的供应商导入」 最省事。

也可以点右上角 + 手动添加,固定填写:

字段值
名称Passion8 Claude Desktop
接口地址/Base URLhttps://passion8.cc
API Keysk-你的 Passion8 API Key

保持「需要模型映射」关闭(Passion8 走直连模式)。

3

启用并重启

在供应商卡片上点「启用」,然后完全退出并重新打开 Claude Desktop。

Claude Desktop 不像 Claude Code 那样热重载配置。每次切换供应商后,都必须彻底退出再重开,新配置才会生效。

#手动配置

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

#1. 创建配置目录

推荐把配置写进用户级 ~/.claude/settings.json,避免把 Key 放进项目仓库:

mkdir -p ~/.claude

#2. 写入 settings.json

编辑 ~/.claude/settings.json:

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

#3. 测试

保存后重新打开终端,进入项目目录测试:

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

#也可以用环境变量

写进 ~/.zshrc 后对新开的终端生效:

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

直接用 echo 写入真实 Key 可能留下 shell 历史。介意的话,用编辑器手动打开 ~/.zshrc 或 ~/.claude/settings.json 后粘贴。

#进阶配置模板

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

这份模板不是新手默认配置。bypassPermissions 和 skipDangerousModePermissionPrompt 会减少确认弹窗,但也会放大误操作风险。只建议在你完全信任的本地项目、可回滚 Git 仓库、容器或一次性 VM 里使用。

~/.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": "max",
    "DISABLE_AUTOUPDATER": "1",
    "DISABLE_BUG_COMMAND": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "DISABLE_ERROR_REPORTING": "1",
    "DISABLE_TELEMETRY": "1",
    "ENABLE_TOOL_SEARCH": "true",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8[1M]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5[1M]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "claude-fable-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-haiku-4-5-20251001",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  },
  "attribution": {
    "commit": "",
    "pr": ""
  },
  "includeCoAuthoredBy": false,
  "model": "sonnet[1m]",
  "permissions": {
    "defaultMode": "bypassPermissions"
  },
  "skipDangerousModePermissionPrompt": true
}

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

可选:请求 1 小时 Prompt Cache TTL
{
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}

#关键字段解释

字段作用建议
ANTHROPIC_BASE_URL把 Claude Code 请求发到 Passion8固定写 https://passion8.cc,不要带 /v1
ANTHROPIC_AUTH_TOKENPassion8 API Key必填,不要留空,不要提交到仓库
ENABLE_PROMPT_CACHING_1H可选:请求 1 小时 Prompt Cache TTL默认不要写,未配置时 API/provider 走 5 分钟;大上下文、长间隔连续工作时再开
ENABLE_TOOL_SEARCH尝试延迟加载工具定义,减少工具上下文占用MCP 工具多时可开;如果工具异常,先关掉排查
CLAUDE_CODE_EFFORT_LEVEL默认思考强度max 更强也更慢、更贵;日常可改回 medium
ANTHROPIC_DEFAULT_*_MODEL固定不同模型档位的默认模型以 Passion8 模型广场实际可用 ID 为准
ANTHROPIC_MODEL / model默认启动模型确认后台有对应模型再固定
permissions.defaultMode = bypassPermissions跳过大多数工具权限确认高风险,只用于可信项目、容器、VM 或可回滚环境
skipDangerousModePermissionPrompt不再显示危险模式确认提示仅在你明确接受风险时开启

#关于 1 小时缓存

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

1 小时缓存通常不能跨账号、跨模型或跨上游上下文复用。高峰期或上游账号 5h 限额打满时,新创建的缓存可能失效。如果介意成本波动和重复缓存创建成本,保持默认 5 分钟即可。

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

#检查是否生效

测试命令能正常返回内容,说明 Claude Code 已经通过 Passion8 发起请求:

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

如果失败,优先检查:

检查项正确值或做法
Base URLhttps://passion8.cc
Token 变量使用 ANTHROPIC_AUTH_TOKEN
Token 内容填 Passion8 API Key,不要带多余空格
终端修改环境变量后要新开终端
项目配置不要把个人 Key 写进可提交的 .claude/settings.json

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

#相关页面

安装 Claude Code安装 CLI、桌面端和官方 IDE 插件。配置调试与 .claude 目录排查配置来源、settings 合并、Hooks、MCP、Skills、权限和本地数据。
上一页安装教程下一页工作原理与扩展地图

Support / 支持

Need help? / 需要帮助？

接入、计费与模型异常可邮件联系；服务可用性以状态页为准。For setup, billing, or model issues, email us. Check the status page for uptime.

Support Emailsupport@passion8.ccService Statusstatus.passion8.cc

也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right