Appearance
一键脚本配置
控制台为每个 API Key 生成专属脚本,运行一次就把 CcodeZH 的地址和 Key 写入用户目录下的 .claude 文件夹(settings.json 和 config.json),原有的 settings.json 会自动备份。大约 2 分钟。
还没有 Key 的先完成 注册充值并创建 Key;Claude Code 还没装的先看 快速使用:安装 Claude Code。
第一步:登录控制台
访问 ccodezh.com/dashboard,登录并进入控制台。
第二步:下载脚本
- 进入左侧「API 密钥」页,点开目标密钥的 「一键配置」
- 在弹窗底部「不用 CC Switch?下载配置脚本」区域,按系统下载:
- macOS / Linux →
setup-claude-code-mac-linux.sh - Windows →
setup-claude-code-windows.bat
- macOS / Linux →
下载的是 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.sh5. 输入密码
加了 sudo 后,终端会提示:
Password:密码输入时光标不会移动,这是正常的
Mac 出于安全设计,输入密码时不会显示任何字符,也不会有 * 号。直接输完你的 Mac 登录密码,然后按回车即可。如果输错了,重新运行命令再输一次。
6. 确认完成
终端没有报错提示,或显示类似「配置完成」的字样,说明脚本运行成功。关闭终端窗口即可。
Windows 用户
1. 找到脚本文件
打开「文件资源管理器」,点击左侧的「下载」,找到刚才下载的 .bat 文件。
2. 双击运行
直接双击 .bat 文件,脚本会自动运行。
3. 遇到安全警告
Windows 可能弹出「Windows 已保护你的电脑」提示,这是系统对未经微软认证的脚本的默认警告,不影响使用。
处理方式:点击「更多信息」→ 点击「仍然运行」
4. 遇到管理员权限弹窗
若弹出「用户账户控制」窗口,点击「是」即可。
5. 窗口自动关闭
脚本运行结束后,命令行窗口会自动关闭,这是正常现象,说明已运行完成。
第四步:重启 Claude Code
脚本运行完成后,让 Claude Code 重新读取配置:
- CLI:关掉正在运行
claude的终端窗口,打开新终端,进入项目目录运行claude - VSCode 插件:完全退出 VSCode 再打开
发一句话能正常回复,即配置成功。配置不生效或报错见 错误排查指南。