阅读提示
数据来源说明：本文所有数据基于 2026年6月28号0点公开可查的官方文档和社区实测。价格、版本、功能可能随产品更新而变化，请以各工具和平台的官网最新信息为准。

层级

包含工具

关键决策

执行层

Claude Code、Codex

选择更适合当前任务的 Agent：Claude Code 偏长程项目协作，Codex 偏 OpenAI 生态、Profiles 和 Remote。

治理层

CC Switch

统一维护供应商配置、MCP、Skills、Prompts、会话和用量，减少手工改环境变量的错误。

供给层

AnyRouter、TeamoRouter、官方 API

根据成本、稳定性、隐私、合规和 SLA 选择 API 来源。

关键原则
不要把“能用”误认为“适合生产”。AnyRouter 的优势是免费和易试用；TeamoRouter 的优势是稳定、成本和团队治理；官方 API 的优势是合规边界和官方责任链。

工具

类型

定位

价格

适合人群

Claude Code

AI 编程 Agent

Anthropic 旗舰 Agent

官方价 / 通过网关

任何用户

Codex

AI 编程 Agent

OpenAI 开源 Rust Agent

官方价 / 通过网关

任何用户

CC Switch

管理工具

7 个 CLI 统一管理

开源（MIT）

所有用户

AnyRouter

免费 API 网关

公益 · Linux.do/教育邮箱

完全免费

学生 / 个人 / 试用

TeamoRouter

付费 API 网关

企业级 Agentic 网关

10%-40% 官方价

团队 / 重度 / 商用

用户类型

推荐组合

月成本估算

核心优势

学生 / 个人学习

Claude Code + AnyRouter

$0

零成本用上顶级模型

个人开发者

全套 + TeamoRouter + CC Switch

$10-$50

稳定便宜、多模型对比

创业团队

全套 + TeamoRouter + CC Switch

$100-$500

团队协作、成本可控

企业

全套 + CC Switch（官方 API）

按 SLA 计费

高可用、合规保障

用户类型

推荐组合

月成本估算

核心优势

学生 / 个人学习

Claude Code + AnyRouter

$0

零成本用上顶级模型

个人开发者

全套 + TeamoRouter + CC Switch

$10-$50

稳定便宜、多模型对比

创业团队

全套 + TeamoRouter + CC Switch

$100-$500

团队协作、成本可控

企业

全套 + CC Switch（官方 API）

按 SLA 计费

高可用、合规保障

用途

链接

官网

https://claude.com/product/claude-code

中文文档

https://code.claude.com/docs/zh-CN/

Changelog

https://code.claude.com/docs/en/changelog

What's New 周报

https://code.claude.com/docs/en/whats-new

Console（API Key）

https://console.anthropic.com/

GitHub

https://github.com/anthropics/claude-code

Discord 「Anthropic 官方运营的 Discord 社区」

https://discord.gg/anthropic

VS Code 插件

https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

JetBrains 插件

https://plugins.jetbrains.com/plugin/27310-claude-code

Claude Fable 5 介绍

「因不抗力原因，现有claude-fable-5网址无法直接显示，故显示父级网址简介」

https://www.anthropic.com/news/claude-fable-5

环境变量文档

https://code.claude.com/docs/zh-CN/env-vars

变化项

详情

API Rate Limits 大幅提高

Sonnet 与 Haiku 在各 usage tier 限速已匹配 Opus

Usage Tiers 合并

从原 5 档合并为 Start / Build / Scale 三档

负面影响

0 负面影响，大多数组织自动升到更高 tier

Opus 4.7 fast mode 弃用

7 月 24 日移除，全部迁移到 Opus 4.8

版本

日期

关键新功能

2.1.195

6-26

CLAUDE_CODE_DISABLE_MOUSE_CLICKS、hook matchers 精确匹配、背景守护 Socket 修复

2.1.193

6-25

autoMode.classifyAllShell 全 Bash 走分类器、OTel assistant_response 事件

2.1.191

6-24

/rewind 支持恢复 /clear 前对话、流式响应 CPU 降低 37%

2.1.187

6-23

sandbox.credentials 阻止沙箱读凭据、组织模型限制

2.1.185

6-22

claude mcp login/logout 命令行鉴权 MCP

# macOS / Linux（推荐，支持自动更新）

curl -fsSL https://claude.ai/install.sh | sh

# Windows PowerShell

irm https://claude.ai/install.ps1 | iex

# Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# npm

npm install -g @anthropic-ai/claude-code

# 国内加速镜像

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# WinGet

winget install Anthropic.ClaudeCode

claude --version         # 当前应为 2.1.195

claude doctor            # 运行环境诊断

claude update            # 升级到最新版本

/release-notes           # 会话内版本选择器

方案

适用人群

难度

✅ CC Switch 一键切换（最推荐）

所有用户

⭐ 最易

✅ AnyRouter 公益免费

学生 / 个人学习

⭐ 最易

✅ TeamoRouter 付费高质量

重度用户 / 商业团队

⭐⭐ 易

手动环境变量配置

极客用户

⭐⭐⭐

# macOS / Linux

export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

export ANTHROPIC_BASE_URL="https://你的中转地址"

# Windows PowerShell

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","sk-你的Key","User")

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://你的中转地址","User")

{

  "env": {

    "ANTHROPIC_BASE_URL": "https://api.teamorouter.com",

    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",

    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",

    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",

    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",

    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"

  }

}

模式

命令

适用场景

交互模式

claude

日常开发、REPL 对话

单次执行

claude -p "任务描述"

脚本调用、CI/CD 流水线

恢复会话

claude -c 或 claude --resume

继续上次中断的工作

# ═══════════════════════════════════════════

# 基础命令

# ═══════════════════════════════════════════

claude                                  # 交互模式启动

claude "你的问题"                       # 带提示词启动

claude -p "查询内容"                    # 单次执行（非交互）

# ═══════════════════════════════════════════

# 会话管理

# ═══════════════════════════════════════════

claude -c                               # 继续上次对话

claude -c -p "追加需求"                 # 继续对话 + 单次执行

claude --resume                         # 选择历史会话恢复

claude /rewind                          # 回退到检查点

# ═══════════════════════════════════════════

# 模型与目录

# ═══════════════════════════════════════════

claude --model opus                     # 指定 Opus 模型

claude --model claude-fable-5           # 使用 Fable 5 旗舰模型

claude --add-dir ./other-project        # 添加额外工作目录

claude -C /path/to/project              # 指定项目目录

claude --cd /tmp/test                   # 切换工作目录（v2.1.178+）

# ═══════════════════════════════════════════

# 调试与诊断

# ═══════════════════════════════════════════

claude --debug                          # 调试模式

claude --verbose                        # 显示详细执行步骤

claude doctor                           # 环境诊断工具

claude update                           # 升级版本

# ═══════════════════════════════════════════

# 权限与安全

# ═══════════════════════════════════════════

claude --dangerously-skip-permissions   # 跳过所有权限确认（⚠️ 慎用）

claude --safe-mode                      # 禁用所有自定义配置

claude --permission-mode plan           # Plan Mode（只读模式）

claude --print                          # print 模式（适合管道）

# ═══════════════════════════════════════════

# 鉴权与 MCP

# ═══════════════════════════════════════════

claude mcp login <server>               # 命令行鉴权 MCP（v2.1.185+）

claude mcp logout <server>              # 登出 MCP

# ═══════════════════════════════════════════

# 团队协作与高级功能

# ═══════════════════════════════════════════

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude  # 启用 Agent Teams

claude --output-format stream-json      # 流式 JSON 输出

claude --json-schema schema.json        # 结构化输出

claude --thinking                       # 启用深度思考模式

claude --fallback-model sonnet          # 设置 fallback 模型

命令

说明

使用频率

/init

自动生成 CLAUDE.md 项目说明文件

首次必用

/clear

清空当前上下文

切换任务时

/compact

压缩历史记录节省 Token

上下文快满时

/cost

查看 Token 消耗统计

监控成本

/btw <问题>

侧边提问不污染上下文（← → 浏览历史）

极常用

/rewind

回退操作 / 可恢复 /clear 前的对话

撤销操作

/resume

恢复历史会话

继续工作

/model

切换模型 / 调整思考深度

复杂任务

/mcp

管理 MCP 服务

进阶使用

/plugin

管理插件

进阶使用

/release-notes

版本选择器

升级前查看

/status

查看当前状态 / base URL

验证配置

/config

全局配置管理

调整设置

/memory

编辑记忆文件

调试使用

/permissions

配置权限白名单

一次配置

✅ 应该包含

❌ 应该排除

Claude 无法猜测的 Bash 命令

Claude 可通过读代码弄清楚的内容

与默认值不同的代码风格

标准语言约定

测试指令和首选测试运行器

详细的 API 文档（改为提供链接）

仓库礼仪（分支命名、PR 约定）

经常变化的信息

特定项目的架构决策

长篇解释或教程

开发者环境怪癖

不证自明的实践

常见陷阱或非显而易见的行为

逐个文件描述代码库

# CLAUDE.md

## 项目概述

[一句话描述项目用途]

## 技术栈

- [主要技术栈列表]

## 常用命令

- `npm run dev`: 启动开发服务器

- `npm test`: 运行测试

- `npm run build`: 打包构建

## 代码规范

- TypeScript strict mode

- ESLint + Prettier

- 单个函数不超过 50 行

## Git 规范

- conventional commits: feat/fix/docs/style/refactor/test/chore

- 分支命名: feature/xxx, fix/xxx

## 重要约定

- 所有 API 返回统一 JSON 格式

- 错误处理使用统一格式

- 数据库操作使用 Prisma

## 禁止事项

- 不要使用 var，只用 const/let

- 不要在代码里写中文注释

- 不要安装 lodash，原生方法够用

## 验证标准

- 所有 PR 必须通过单测

- 测试覆盖率 > 80%

#

Skill 名称

用途说明

1

find-skills

AI Agent 的"应用商店搜索器"，60K+ 订阅量

2

agent-browser

浏览器自动化测试与交互

3

ui-ux-pro-max

UI 设计参考与最佳实践

4

fullstack-dev

全栈开发支持

5

frontend-dev

前端最佳实践

6

anthropics/skills

Anthropic 官方工具集

7

pptx-generator

快速制作 PPT 演示文稿

8

humanizer-zh

优化中文文章表达

9

brainstorming

创意激发与头脑风暴

10

remotion-dev/skills

视频制作

# 全局安装 Skill

npx skills add <repo-url> --skill <skill-name> -g -y

# 示例：安装官方 docx skill

npx skills add https://github.com/anthropics/skills --skill docx -g -y

# 项目级安装

npx skills add <repo-url> --skill <skill-name>

事件名称

触发时机

核心作用

PreToolUse

工具调用之前

拦截工具执行，反馈调整建议

PermissionRequest

弹出权限对话框时

自动批准或拒绝权限请求

PostToolUse

工具调用完成后

执行后置操作（格式化、日志记录）

UserPromptSubmit

用户提交提示词后

预处理用户输入

Notification

Claude 发送通知时

自定义通知方式

Stop

Claude 完成响应时

收尾工作（清理临时文件）

SubagentStop

子代理任务完成时

处理子代理返回结果

PreCompact

即将压缩上下文时

自定义压缩规则

SessionStart

启动新会话时

初始化环境配置

SessionEnd

会话结束时

保存数据、清理资源

Agent 名称

类型

用途

general-purpose

默认

通用兜底任务处理

Explore

只读

代码库探索与搜索

Plan

只读

方案规划与设计

name = "code-reviewer"

description = "代码审查专家，自动检查安全、性能、最佳实践"

tools = ["Read", "Grep", "Glob", "Bash"]

model = "opus"

[prompt]

system = """

你是严格的代码审查专家。

审查维度（按优先级）：

1. 安全漏洞（SQL 注入、XSS、CSRF、敏感信息泄漏）

2. 性能瓶颈（N+1 查询、不必要的重渲染）

3. 错误处理（异常吞没、错误信息泄漏）

4. 可维护性（命名规范、重复代码、注释缺失）

输出格式：

- 文件路径 + 行号

- 严重等级（严重/高/中）

- 问题描述（一句话）

- 修复建议（代码示例）

"""

MCP 名称

用途

安装命令

Context7

拉取官方文档（库、框架）

npx -y @upstash/context7-mcp

Sequential Thinking

复杂任务规划分解

npx -y @modelcontextprotocol/server-sequential-thinking

Serena

代码语义检索、符号级编辑

uvx serena-mcp

Brave Search

网页搜索

npx -y @modelcontextprotocol/server-brave-search

GitHub

GitHub 集成（PR、Issue）

npx -y @modelcontextprotocol/server-github

Playwright

浏览器自动化测试

npx -y @playwright/mcp

快捷键

功能

Ctrl+A

跳到行首

Ctrl+E

跳到行尾

Ctrl+W

删除前一个单词

Ctrl+U

删除光标前所有内容

Ctrl+K

删除光标后所有内容

↑ / ↓

浏览历史命令

←←

把当前 turn 放到后台运行（v2.1.193+）

Shift+Tab

Plan Mode ↔ Normal Mode 切换

Tab

切换深度思考模式

/vim

启用 Vim 键位模式

Esc Esc

回退恢复

Ctrl+C

中断当前操作

Ctrl+D

退出 Claude Code

用途

链接

官网

https://developers.openai.com/codex

Quickstart

https://developers.openai.com/codex/quickstart

Config Basics

https://developers.openai.com/codex/config-basic

Advanced Config

https://developers.openai.com/codex/config-advanced

Subagents 文档

https://developers.openai.com/codex/subagents

AGENTS.md 指南

https://developers.openai.com/codex/guides/agents-md

Codex Remote (GA)

https://developers.openai.com/codex/cloud

Changelog

https://developers.openai.com/codex/changelog

GitHub

https://github.com/openai/codex

Releases

https://github.com/openai/codex/releases

OpenAI 控制台

https://platform.openai.com/login

ChatGPT Codex

https://chatgpt.com/codex

Windows 安装指南

https://developers.openai.com/codex/windows

版本

日期

类型

关键内容

0.142.3

6-26

维护版本

无功能变更

0.142.2

6-25

功能更新

MCP tool search 默认开启、macOS 系统代理支持

0.142.0

6-22

大版本

/import 从 Claude Code 导入、Scheduled Reminders

0.141.0

6-18

功能更新

Remote executors Noise 加密

0.140.0

6-15

功能更新

Codex App EEA/UK/CH 地区可用

0.139.0

6-09

功能更新

code-mode standalone web search

0.138.0

6-08

功能更新

/app 把 CLI 会话交给桌面 App

# 一键脚本（推荐）

curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 无人值守安装

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

# npm

npm install -g @openai/codex

# 国内加速镜像

npm install -g @openai/codex --registry=https://registry.npmmirror.com

# Homebrew（macOS / Linux）

brew install codex

# Windows 推荐使用 WSL2

wsl --install && wsl && npm i -g @openai/codex

模式

命令

适用场景

TUI 交互模式

codex

默认交互模式，日常开发使用

非交互 exec

codex exec "任务"

CI/CD 集成、脚本调用

完全自主模式

codex --yolo

跳过所有确认（请谨慎使用）

# CLI 临时使用指定 Profile

codex --profile fast

codex --profile deep-review

# 非交互模式使用 Profile

codex exec --profile review "review this change"

# 在 config.toml 顶部设置默认 Profile

# profile = "fast"

# ~/.codex/config.toml

# ═══════════════════════════════════════════

# 模型设置

# ═══════════════════════════════════════════

model = "gpt-5.4"                       # 默认模型

# profile = "fast"                       # 取消注释设置默认 Profile

model_provider = "teamorouter"          # 默认 provider

model_context_window = 1000000          # 上下文窗口大小

model_auto_compact_token_limit = 900000 # 自动压缩阈值

tool_output_token_limit = 40000         # 工具输出限制

# 推理设置

model_reasoning_effort = "medium"       # minimal/low/medium/high/xhigh

model_reasoning_summary = "detailed"    # auto/concise/detailed/none

plan_mode_reasoning_effort = "high"     # Plan mode 推理强度

model_verbosity = "medium"              # low/medium/high

# ═══════════════════════════════════════════

# 沙箱与审批（日常推荐配置）

# ═══════════════════════════════════════════

approval_policy = "on-request"          # untrusted/on-request/never

sandbox_mode = "workspace-write"        # read-only/workspace-write/danger-full-access

network_access = "enabled"              # 网络访问

# ═══════════════════════════════════════════

# 网页搜索

# ═══════════════════════════════════════════

web_search = "cached"                   # cached（默认）/ live（实时）/ disabled

# ═══════════════════════════════════════════

# 模型 Provider（多供应商配置）

# ═══════════════════════════════════════════

[model_providers.openai]

name = "OpenAI Direct"

base_url = "https://api.openai.com/v1"

wire_api = "responses"

env_key = "OPENAI_API_KEY"

requires_openai_auth = true

[model_providers.teamorouter]

name = "TeamoRouter"

base_url = "https://api.teamorouter.com/v1"

wire_api = "responses"

env_key = "OPENAI_API_KEY"

requires_openai_auth = true

[model_providers.anyrouter]

name = "AnyRouter"

base_url = "https://anyrouter.top/v1"

wire_api = "responses"

env_key = "OPENAI_API_KEY"

requires_openai_auth = true

# ═══════════════════════════════════════════

# Profiles —— 快速切换工作模式（6 套场景）

# ═══════════════════════════════════════════

[profiles.fast]                         # 快速模式：便宜省钱

model = "gpt-5.4-mini"

model_reasoning_effort = "low"

approval_policy = "on-request"

sandbox_mode = "workspace-write"

[profiles.work]                         # 工作模式：主力配置

model = "gpt-5.5"

model_reasoning_effort = "high"

approval_policy = "on-request"

sandbox_mode = "workspace-write"

[profiles.review]                       # 审查模式：只读 + 高推理

model = "gpt-5.5"

model_reasoning_effort = "xhigh"

approval_policy = "on-request"

sandbox_mode = "read-only"

[profiles.safe]                         # 安全模式：日常推荐

model = "gpt-5.4"

model_reasoning_effort = "medium"

approval_policy = "on-request"

sandbox_mode = "workspace-write"

[profiles.auto]                         # 自动模式：完全自主（慎用）

model = "gpt-5.4"

approval_policy = "never"

sandbox_mode = "danger-full-access"

[profiles.cheap]                        # 极致省钱模式

model = "gemini-3.1-flash-lite-preview"

model_reasoning_effort = "low"

# ═══════════════════════════════════════════

# Subagent 配置

# ═══════════════════════════════════════════

[agents]

max_threads = 6                         # 同时保持的 agent 线程数

max_depth = 1                           # 嵌套深度（1 = 一层子 agent）

# ═══════════════════════════════════════════

# MCP Servers

# ═══════════════════════════════════════════

[mcp_servers.context7]

command = "npx"

args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.sequential-thinking]

command = "npx"

args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]

[mcp_servers.fetch]

command = "uvx"

args = ["mcp-server-fetch"]

# AGENTS.md - 项目规范

## 项目概述

本项目是一个 [项目描述]。

技术栈：[技术栈列表]

## 常用命令

- `npm run dev`: 启动开发服务器

- `npm test`: 运行测试

- `npm run build`: 打包构建

- `npm run lint`: 代码检查

## 代码规范

- TypeScript strict mode

- 单个函数不超过 50 行

- 单个文件不超过 300 行

- 不使用 any 类型

## 测试要求

- 新功能必须有单元测试

- 核心逻辑覆盖率 > 80%

- 集成测试覆盖主要用户流程

## Git 规范

- conventional commits: feat/fix/docs/style/refactor/test/chore

- 分支命名: feature/xxx, fix/xxx, refactor/xxx

- PR 必须关联 Issue

## 重要约定

- API 响应统一格式：{ data, error, meta }

- 数据库使用 Prisma ORM

- 日期时间统一使用 UTC 时区

## 验证标准

- 所有测试通过

- Lint 无错误

- Build 成功

- 文档已更新

把当前 PR（分支 vs main）拆成 6 个并行 subagents：

1. Security issue       → reviewer agent

2. Code quality         → reviewer agent

3. Bugs                 → ui_fixer agent（只诊断不修）

4. Race condition       → reviewer agent

5. Test flakiness       → reviewer agent

6. Maintainability      → code-mapper agent

等全部完成后汇总结果，每项给出文件位置、风险等级、修复建议。

不要修改任何文件。

命令

说明

/model

切换模型 / 调整推理深度（minimal/low/medium/high/xhigh）

/approvals

切换审批模式（suggest / auto-edit / full-auto）

/agent

切换/查看 Subagent 线程

/mcp

管理 MCP 服务器

/usage

查看 Token 活动统计（0.142+）

/goal

设定目标并自动监控进度

/import

从 Claude Code 导入配置（0.142+）

/delete

永久删除会话（0.142+）

/plugin

管理插件（OpenAI Curated/Workspace/Shared）

/init

自动生成 AGENTS.md

/reasoning

调整推理深度

/diff

查看代码变更 diff

/status

查看连接状态

审批模式

适用场景

沙箱模式

权限范围

suggest

每步都询问确认

read-only

只读权限

auto-edit

自动修改文件

workspace-write

可修改当前目录

full-auto

完全自动执行

danger-full-access

全部权限（慎用）

用途

链接

唯一官网

https://ccswitch.io/

GitHub

https://github.com/farion1231/cc-switch

中文 README

https://github.com/farion1231/cc-switch/blob/main/README_ZH.md

Releases

https://github.com/farion1231/cc-switch/releases

中文用户手册

https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md

v3.16.4 Release

https://github.com/farion1231/cc-switch/releases/tag/v3.16.4

CHANGELOG

https://github.com/farion1231/cc-switch/blob/main/CHANGELOG.md

TeamoRouter 集成

https://teamorouter.com/docs/install-cc-switch

系统

安装包 / 命令

Windows x64

CC-Switch-v3.16.4-Windows.msi

Windows ARM64

原生 ARM64 构建

macOS

CC-Switch-v3.16.4-macOS.dmg

Linux

.deb / .rpm / .AppImage

Arch

paru -S cc-switch-bin

Homebrew

brew install --cask cc-switch（无需 brew tap）

macOS 提示

Gatekeeper 拦截时，到「系统设置 → 隐私与安全性」点「仍要打开」。

供应商

链接

Kimi 官方

https://platform.moonshot.cn/console?aff=cc-switch

PackyCode

https://www.packyapi.com/register?aff=cc-switch （cc-switch 9 折）

AIGoCode

https://aigocode.com/invite/CC-SWITCH

AICodeMirror

https://www.aicodemirror.com/register?invitecode=9915W3

DMXAPI

https://www.dmxapi.cn/register?aff=bUHu （Claude 3.4 折）

Crazyrouter

https://crazyrouter.com/register?aff=OZcm&ref=cc-switch

SubRouter

https://subrouter.ai/?aff=l3ri

TeamoRouter

https://teamorouter.com （本文档专章介绍）

类别

功能

说明

供应商管理

添加 / 切换 / 编辑 / 排序 / 复制

40+ 预设 + 自定义

MCP 服务器

跨 7 个 Agent 统一管理

一处编辑多处同步

Prompts

Markdown 编辑器管理

同步到 CLAUDE.md / AGENTS.md / GEMINI.md

Skills

从 GitHub 仓库发现 / 安装

内置 skills.sh

会话管理

跨应用浏览和搜索历史

恢复 / 删除

本地代理

Token 消耗追踪 + 成本监控

趋势图表

故障转移

多供应商自动切换

熔断器 + 请求整流

云同步

WebDAV + S3（v3.16.2+）

多设备同步

用量追踪

Token + 成本可视化

火山方舟 AK/SK（v3.16.4+）

# 供应商管理

cc-switch provider list

cc-switch provider switch <id>

cc-switch provider add

cc-switch provider edit <id>

# MCP 服务器管理

cc-switch mcp list

cc-switch mcp add

cc-switch mcp enable <id> --app claude

cc-switch mcp sync

# Skills 管理

cc-switch skills list

cc-switch skills search <query>

cc-switch skills install <name>

cc-switch skills sync

# 会话管理

cc-switch sessions list

cc-switch sessions search <query>

cc-switch sessions resume <id>

# 数据管理

cc-switch backup create

cc-switch backup restore <file>

cc-switch export <file>

cc-switch doctor

{

  "mcpServers": {

    "context7": { "command": "npx", "args": ["-y", "@upstash/context7-mcp"],

      "env": { "CONTEXT7_API_KEY": "your-key" } }

  }

}

注意事项

Claude 官方模型不建议开路由（兼容性还有问题）；国产模型之间故障转移稳定；熔断器自动检测 5xx 错误计数；请求整流防止雪崩。

问题

解决

macOS Gatekeeper 拦截

系统设置 → 隐私与安全性 → 仍要打开

Codex 切换不生效

必须重启 codex 终端进程

Claude Code 切换不生效

重启 Claude Code 会话

MCP 服务器启动失败

cc-switch mcp validate <command> 验证 PATH

配置文件冲突

CC Switch 数据库优先；编辑 live 后再编辑 supplier

关键提醒

Codex 不支持热切换，切换供应商后必须重启正在运行的 codex 终端进程才生效；这是 TeamoRouter 官方文档明确说明的要点。