Claude Code 一键配置安装教程

一条命令完成 Claude Code CLI 和 Claude 桌面版（Claude Desktop） 的安装与配置，默认模型 claude-opus-5-5，推理强度中档（medium）。

1. 运行一键配置命令

macOS / LinuxWindows PowerShell

bash

curl -fsSL https://docs.aizhan.space/sh/claudecode.sh | bash

powershell

irm https://sh.api.aizhan.space/claudecode.ps1 | iex

macOS 打开「终端」，Linux 打开你常用的终端，WSL / Git Bash 用第一条命令
Windows 打开「Windows PowerShell」执行第二条命令，不需要 Git Bash

脚本启动后会显示当前状态和菜单：

1 安装 Claude Code CLI / 桌面版
2 配置 Claude Code CLI / 桌面版 API
3 一键全部安装（第一次用直接选这个）

选完菜单后会问你要用哪个客户端：1 Claude Code CLI、2 Claude 桌面版、直接回车 = 两个都用。然后选择线路（国内直连 / 海外 CDN），输入 API Key，脚本会先验证 Key，再写入配置。

2. 安装方式

安装对象	macOS / Linux	Windows
Claude Code CLI	官方安装器 `claude.ai/install.sh`，失败自动改用 npm，再失败切换国内镜像	官方安装器 `claude.ai/install.ps1`，失败自动改用 npm + 国内镜像
Claude 桌面版	macOS 用 `brew install --cask claude`；Linux 官方暂无桌面版	`winget install Anthropic.Claude`

用 npm 安装需要 Node.js，见安装 Node.js。
没有 Homebrew / winget 时，脚本会打开 claude.ai/download，手动下载安装后回到脚本选「2」配置即可。
Windows 上 Git for Windows 是可选的：没装时 Claude Code 用 PowerShell 执行命令。

3. 脚本会写哪些文件

Claude Code CLI：~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aizhan.space",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "claude-opus-5-5",
  "effortLevel": "medium"
}

同时会在 ~/.claude.json 写入 hasCompletedOnboarding: true，跳过首次登录引导。

Claude 桌面版：开启「第三方推理（gateway）」模式，配置目录：

系统	位置
macOS	`~/Library/Application Support/Claude/` 和 `Claude-3p/`
Windows	`%LOCALAPPDATA%\Claude\` 和 `Claude-3p\`
Linux	`~/.config/Claude/` 和 `Claude-3p/`

脚本把两个 claude_desktop_config.json 的 deploymentMode 设为 3p，并在 Claude-3p/configLibrary/ 下写入名为「AI驿站」的 gateway 配置（地址、Key、可用模型列表，claude-opus-5-5 排在第一个）。

已有的其他配置（例如权限、MCP 服务器）都会保留；改动前会自动备份为同目录下的 *.bak.时间戳 文件。

4. 验证

bash

claude -p "Reply with exactly: OK"

看到 OK 就说明配置成功。桌面版需要彻底退出（托盘 / 菜单栏图标也要退出）后重新打开，然后直接发一条消息试试。

5. 常见问题

改了配置没生效：Claude Code 重新打开终端再运行；桌面版必须彻底退出再打开。
401 / Key 无效：确认 Key 复制完整，并且属于 Claude 分组。
想切换线路或换 Key：重新运行脚本选「2」即可，会覆盖旧的 Key 和地址。
回滚：把备份的 *.bak.时间戳 文件改回原文件名。

Claude Code 一键配置安装教程 ​

1. 运行一键配置命令 ​

2. 安装方式 ​

3. 脚本会写哪些文件 ​