入门指南Claude Code⚡ 1 分钟快速配置

分钟快速配置 Claude

这页是给完全没用过终端的同学准备的。 全程不需要打字命令,只需要:① 下载一个软件 ② 复制粘贴一段 Key ③ 点一下”激活”。
看完跟着做,1 分钟能让 Claude Code 跑起来。


你需要准备的两样东西

一台 Windows 或 Mac 电脑

Windows 10/11 或 macOS 都可以。

一个 CC Club API Key

如果还没有,先去 获取 API Key 免费申请一把(领完回到这页继续)。

API Key 形如 cr_xxxxxxxxxxxxxxxxxxxxxxxxxxxx先把它复制到一个记事本里,等下要用。


第 1 步:下载并安装 CC Switch

CC Switch 是一个桌面应用,帮你管理 API 配置 —— 全程只需复制粘贴,无脑操作。

  1. 点击下载:CC Switch Windows 版 (.msi, 12 MB)
  2. 双击下载好的安装包,按提示完成安装
  3. 安装完成后,从开始菜单打开 CC Switch
⚠️

第一次打开如果 Windows 弹出 “Windows 已保护你的电脑”,点 “更多信息” → “仍要运行”。这是 Windows 对未签名应用的默认拦截,不影响使用。


第 2 步:在 CC Switch 里填一份配置

打开 CC Switch 后,照下面三个动作做:

👀 全流程预览(先看一眼,下面有逐步说明)

1切到 Claude 分组并点击 + 按钮

Claude 图标 → 点右上角橙色 + 按钮

2填写供应商名称、API Key、请求地址

供应商名称API Key请求地址

3在配置 JSON 框里粘贴配置

展开 高级选项 → 在 配置 JSON 框里整段贴下方代码

切到 Claude 分组

CC Switch 左侧有一列分组:Claude / Claude Desktop / Codex / OpenCode / Gemini。点 Claude

点 ”+ 添加供应商”

页面右上角的蓝色按钮。会弹出一个表单。

复制下面这段到 “配置 JSON” 框

把整段贴进去,只改一个地方:把 "ANTHROPIC_AUTH_TOKEN" 后面那对空引号 "" 里填上你的 API Key。

{
  "effortLevel": "medium",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API 密钥",
    "ANTHROPIC_BASE_URL": "https://claude-code.club/api"
  },
  "model": "sonnet[1m]"
}

其他字段照下表填:

字段填什么
供应商名称随便取,比如 CC Club Claude
官网链接留空
API把你的 Key 再贴一遍
请求地址https://claude-code.club/api
API 格式下拉选 Anthropic Messages(原生)
模型区域留空

点右下角 “保存”

成功会回到列表,看到一条新的 CC Club Claude 供应商。


第 3 步:测试、激活、验证

保存好的供应商还没生效。这一步分三个动作:先 测试 配置(确认 Key + 地址都对)→ 再 启用(让它生效)→ 最后在终端 验证(端到端跑一次)。

✅ 全流程预览(先看一眼,下面有逐步说明)

1点击供应商行右侧的测试按钮

在那条供应商上点 测试(蓝色按钮)

2
测试成功的绿色提示

看到绿色 测试成功 提示

3点击启用按钮激活这条供应商

启用(绿色按钮),行首出现 即生效

4终端运行 claude 你好 看到中文回复

终端跑 claude “你好”,几秒内看到中文回复 —— 链路就通了

先点 “测试” 验证配置

在刚保存的那条供应商行上,点蓝色 测试 按钮(如上方图 ①)。CC Switch 会用你填的 Key + 请求地址向上游发一次握手请求。

  • 看到绿色 “测试成功” 提示(图 ②):Key 和地址都对,可以继续下一步
  • 看到红色错误:通常是 Key 错了 / 地址错了 / 网络不通。点 编辑 检查 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL,最常见的坑是 Key 首尾带了空格

为什么先测试? 测试只验证”CC Switch 能连上 API”,不需要 Claude Code 本体。先把这一步走通,等下装命令行才有底。

点 “启用” 激活这条配置

测试通过后,点同一行的绿色 启用 按钮(图 ③)。激活成功后:

  • 行首会出现一个 ✓ 勾选标记
  • 状态从”已保存”变成”当前使用
⚠️

保存 ≠ 启用 ≠ 测试,三件事各走各的:

  • 保存 = 把这条配置写进 CC Switch
  • 测试 = 检查这条配置能不能连通
  • 启用 = 让 Claude Code 实际用这条配置

不点”启用”,就算测试通过也不生效。

装 Claude Code 本体

CC Switch 只管”配置”,不管”安装”。Claude Code 本体还得装一次 —— 但 CC Switch 提供了一键安装按钮

在 CC Switch 顶部找 “安装 Claude Code” 按钮,点一下,它会自动帮你装好。

(如果找不到按钮、或者按钮报错,按 手动安装步骤 走。)

在终端验证一次

打开任意终端(Windows 用 PowerShell / Mac 用 Terminal),输入:

claude "你好"

几秒内返回一段中文回复(如上方图 ④),整条链路就通了 🎉。

之后你不用再管这些配置 —— 每次启动 claude,它都会自动读取 CC Switch 里已启用的那条供应商。


走完了,下一步看什么?

已经能跑了,但 Claude Code 真正强大的地方在 IDE 里。建议接下来看:


出问题了?

问题 1:终端输 claude 提示 “找不到命令”

说明 Claude Code 本体没装好。两个办法:

  • 重试 CC Switch 的”一键安装”:可能上一次因为网络中断没装完
  • 换手动安装:跟着 手动安装步骤(下面)走
问题 2:跑 claude 报 “Invalid API key”

99% 是因为供应商没启用。回 CC Switch,先点 测试 看是否通过:

  • 测试通过但终端报错 → 说明你忘了点 启用。点一下,确认行首有 ✓ 勾选标记
  • 测试就报错 → 是 Key 本身有问题。点 编辑 检查 ANTHROPIC_AUTH_TOKEN,常见原因是首尾带了空格
问题 3:CC Switch 保存时报 “JSON 格式错误”

最常见的两个原因:

  • API Key 首尾带了空格(复制粘贴时容易带)
  • JSON 的 } 之前多了逗号(比如 "model": "sonnet[1m]",}

参照本页”第 2 步”的代码块整段重粘最快。

问题 4:响应很慢 / 一直转圈

可能是网络节点不合适。回 CC Switch 编辑那条供应商,把 "ANTHROPIC_BASE_URL" 改成下面其中一个再试:

  • https://jp.claude-code.club/api — 日本节点(回国优化)
  • https://hk.claude-code.club/api — 香港节点(回国优化)
  • https://sz.ai-code.club/api — 深圳节点(国内中转出境)

改完别忘了再单击一次激活。

手动安装 Claude Code(备用方案)

如果 CC Switch 里没有”一键安装”按钮,或者点了报错,需要手动装一次:

按你的操作系统跳到对应页面:

按里面的 “一键脚本安装” 走(不用看 “手工安装”)。装完回这页继续做”第 3 步:激活并验证”。


已经是熟手?

如果你看得懂终端、想完全掌控安装过程,直接走传统路径


MIT 2026 © Nextra.
加入社群CC Club返回官网