Skip to content

一键脚本配置 ​

控制台为每个 API Key 生成专属脚本,运行一次就把 CcodeZH 的地址和 Key 写入用户目录下的 .claude 文件夹(settings.json 和 config.json),原有的 settings.json 会自动备份。大约 2 分钟。

还没有 Key 的先完成 注册充值并创建 Key;Claude Code 还没装的先看 快速使用:安装 Claude Code。


第一步:登录控制台 ​

访问 ccodezh.com/dashboard,登录并进入控制台。


第二步:下载脚本 ​

  1. 进入左侧「API 密钥」页,点开目标密钥的 「一键配置」
  2. 在弹窗底部「不用 CC Switch?下载配置脚本」区域,按系统下载:
    • macOS / Linux → setup-claude-code-mac-linux.sh
    • Windows → setup-claude-code-windows.bat

下载的是 Codex 脚本?

选中的 Key 是 cx 分组时,这里生成的是 Codex 配置脚本(文件名以 setup-codex 开头),见 Codex 接入 CcodeZH(cx 分组)。用 Claude Code 请换一个 cc 或 cc-n 分组的 Key。

下载后,文件通常保存在**「下载」文件夹**里。


第三步:运行脚本 ​

macOS / Linux 用户 ​

1. 打开终端 ​

终端(Terminal)是 Mac 内置的命令行工具。

打开方式:

  • 按下 ⌘(Command)+ 空格,输入「终端」或「Terminal」,回车打开
  • 或打开「启动台」,在搜索框输入「终端」

2. 进入下载目录 ​

bash
cd ~/Downloads

执行后没有任何提示、光标跳到下一行,说明成功。

脚本保存在其他位置?

把 ~/Downloads 替换成脚本所在的路径即可,例如 cd ~/Desktop 表示切换到桌面。

3. 运行脚本 ​

bash
bash setup-claude-code-mac-linux.sh

脚本自动完成所有配置,通常只需几秒钟。

4. 遇到权限不足(Permission denied) ​

如果终端出现:

Permission denied

在命令前加 sudo 重新运行:

bash
sudo bash setup-claude-code-mac-linux.sh

5. 输入密码 ​

加了 sudo 后,终端会提示:

Password:

密码输入时光标不会移动,这是正常的

Mac 出于安全设计,输入密码时不会显示任何字符,也不会有 * 号。直接输完你的 Mac 登录密码,然后按回车即可。如果输错了,重新运行命令再输一次。

6. 确认完成 ​

终端没有报错提示,或显示类似「配置完成」的字样,说明脚本运行成功。关闭终端窗口即可。


Windows 用户 ​

1. 找到脚本文件 ​

打开「文件资源管理器」,点击左侧的「下载」,找到刚才下载的 .bat 文件。

2. 双击运行 ​

直接双击 .bat 文件,脚本会自动运行。

3. 遇到安全警告 ​

Windows 可能弹出「Windows 已保护你的电脑」提示,这是系统对未经微软认证的脚本的默认警告,不影响使用。

处理方式:点击「更多信息」→ 点击「仍然运行」

4. 遇到管理员权限弹窗 ​

若弹出「用户账户控制」窗口,点击「是」即可。

5. 窗口自动关闭 ​

脚本运行结束后,命令行窗口会自动关闭,这是正常现象,说明已运行完成。


第四步:重启 Claude Code ​

脚本运行完成后,让 Claude Code 重新读取配置:

  • CLI:关掉正在运行 claude 的终端窗口,打开新终端,进入项目目录运行 claude
  • VSCode 插件:完全退出 VSCode 再打开

发一句话能正常回复,即配置成功。配置不生效或报错见 错误排查指南。