﻿========================================
  济川AI · Claude Code + CC Switch 一键安装器
  使用说明
========================================


【一】这个包是干什么的

一次性帮你把下面这些装好，不用自己一个个折腾：

  1. Node.js          —— Claude Code 运行需要的基础环境
  2. Claude Code      —— 在命令行里用的 AI 编程助手
  3. CC Switch        —— 配置管理小工具，用来把济川AI的密钥
                         一键导入到 Claude Code

一般不需要管理员权限；如果提示权限不足，右键安装文件，选「以管理员身份运行」。
安装过程会在你的电脑上装 Node.js 和 CC Switch；如果你在安装时填了代理地址，
还会把它保存起来（见【七】）。


【二】电脑要求

  · Windows 10 或 Windows 11，64 位系统（含 ARM 笔记本）
    （Win7/Win8 用不了）
  · 磁盘剩余空间 2 GB 以上
  · 能正常上网即可。代理软件不是必需的：没有代理的话，
    安装时直接按回车，下载会自动走国内镜像。
  · 一个济川AI账号（在 https://jc.jichuanai.com 注册登录），
    并且已经创建好 API 密钥。不需要 claude.ai 账号。


【三】怎么安装

  第 1 步：把 Install-ClaudeCode-CCSwitch.bat 解压出来
           （重要：一定要先解压，不要在压缩包里直接双击）

  第 2 步：双击它

  第 3 步：按屏幕提示操作。中间会问你一次代理地址：

           · 没有代理软件 —— 直接按回车就行

           · 开了代理软件的「系统代理」或「TUN 模式」
             —— 也直接按回车

           · 想让安装走你的代理，就填 HTTP 代理地址，例如：
               Clash    通常是  http://127.0.0.1:7890
               v2rayN   通常是  http://127.0.0.1:10809

           注意填的是 HTTP 端口，不是 socks 端口。端口号在代理
           软件的设置界面里能看到。

  然后等它跑完就行。整个过程大概 3 到 10 分钟，取决于网速。


【四】装完之后怎么用济川AI

  第 1 步：导入密钥
    1. 打开 https://jc.jichuanai.com 并登录
    2. 进入「API 密钥」页面
    3. 在你要用的那个密钥上，点「CCS 导入」
    4. 选择 Claude Code，再选一个模型
    5. 这时会弹出 CC Switch 窗口，在里面点确认导入

  第 2 步：开始使用
    1. 重新打开一个新的「命令提示符」窗口：开始菜单里搜 cmd，
       选「命令提示符」（不要选 PowerShell）
    2. 输入 claude 然后回车

    想在某个文件夹里干活：先打开这个文件夹，在地址栏里输入 cmd
    按回车，再输入 claude。

    如果你一定要用 PowerShell，请先执行一次（只需一次）：
        Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

  以后每次用，只要重复第 2 步就行。想换密钥或换模型，回到
  网站的「API 密钥」页面重新点「CCS 导入」即可。

  如果 Claude Code 弹出要你登录 claude.ai，说明密钥导入没有
  生效。请按这个教程重新操作：
      https://docs.jichuanai.com/clients/claude-code


【五】关于 CC Switch

  CC Switch 会把济川AI的设置写到你电脑的下面这个文件里：

      C:\Users\你的用户名\.claude\settings.json

  这是正常的，不用手动改它。如果哪天发现模型选不对、或者
  切换模型没反应，回到网站重新点一次「CCS 导入」，通常就恢复了。


【六】常见问题

  Q：双击之后杀毒软件报毒 / 直接把文件删了
  A：这类命令行安装脚本被误报比较常见。请在杀毒软件里把这个文件
     加进「信任」或「排除」列表，然后重新解压一次再运行。
     如果你不确定文件来源是否可靠，就不要运行。

  Q：提示「连不上 127.0.0.1:xxxx」
  A：这是你填的代理地址连不上。代理软件没开，或者端口号填错了。
     如果你其实没有代理，重新运行，在代理那一步直接按回车。

  Q：提示「这里不能填 socks 代理」
  A：你填的是 socks 端口。同一个软件里一般还有一个 HTTP 端口，
     改填那个。v2rayN 通常是 10809，Clash 通常是 7890。
     没有代理的话，直接按回车就行。

  Q：提示「发现以前留下的代理设置」
  A：说明你以前装的时候填过代理，现在又没填。如果这个代理已经不用了，
     请清掉它，否则会让下载和上网出问题：
       1. 开始菜单搜「编辑账户的环境变量」，把 HTTP_PROXY 和
          HTTPS_PROXY 删掉
       2. 打开「命令提示符」，依次执行：
            npm config delete proxy
            npm config delete https-proxy
       3. 重新运行安装器

  Q：提示 Node.js 版本太旧
  A：Claude Code 需要 Node.js 22 或更高版本。安装器会自动再装一个
     新版，旧版不会被卸载，不用你处理。

  Q：提示「数字签名校验没通过」
  A：Node.js 安装包下载不完整，或者被替换了，安装器已经停止安装。
     换个网络（比如手机热点）后重新运行。

  Q：提示权限不足 / 安装失败代码 1603、1625、1925、1926
  A：右键安装文件，选「以管理员身份运行」再试一次。

  Q：Node.js 装完了，但提示「当前窗口还没识别到它」
  A：正常现象，关掉窗口重新双击运行一次就好。

  Q：下载很慢，或者提示下载失败
  A：多半是网络问题。换个网络（比如手机热点）再运行一次；
     安装器会自动换另一个下载地址重试。

  Q：CC Switch 没装上（安装完成那一屏的标题是「CC Switch 还需要手动安装」）
  A：不影响 Claude Code 本身。请到官网下载安装：
       https://ccswitch.io/download
     装好后回到济川AI网站，按【四】导入密钥即可。

  Q：输入 claude 提示「无法加载文件」「禁止运行脚本」
  A：你用的是 PowerShell。请改用「命令提示符」（搜 cmd），或者在
     PowerShell 里先执行一次：
       Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

  Q：输入 claude 后让我登录 claude.ai
  A：密钥导入没有生效，请看【四】末尾的教程链接重新操作。

  Q：中途失败了，可以重复运行吗
  A：可以。已经装好的部分会自动跳过，不会重复安装。

  Q：想卸载怎么办
  A：Node.js 和 CC Switch 都在「设置 - 应用」里卸载。
     Claude Code 在命令行执行：npm uninstall -g @anthropic-ai/claude-code


【七】提醒

  · 如果你在安装时填了代理地址，安装器会把它保存到用户环境变量
    （HTTP_PROXY 和 HTTPS_PROXY）里，这样 Claude Code 之后也能走
    这个代理；重启电脑后依然有效。以后换了代理端口要同步改，
    不再使用代理时，请到「编辑账户的环境变量」里把这两项删掉。
    没填代理（直接回车）的话，安装器不会保存任何代理设置。
  · 安装器会检查两样东西：CC Switch 安装包的文件校验值，以及
    Node.js 安装包的数字签名。校验不通过就不会安装。
  · 装完之后能不能正常使用，还取决于你的济川AI账号余额和网络
    情况，这部分不在安装器的处理范围内。

========================================
