Entropic Echo

主题

Claude Code 使用指南 ​

三步完成从安装到使用：安装 → 配置 API → 启动。

步骤一：安装 ​

安装 Git（按平台准备） ​

Windows 原生环境 ​

Claude Code 在 Windows 原生环境下依赖 Git for Windows。

下载地址 ：Git for Windows，全程默认选项安装。

powershell
git --version

安装 Claude Code ​

按网络情况选择下载源：国内网络用「本站下载」，能直连 claude.ai 的用户可用「官方下载」。

国内网络请用「本站下载」。 官方脚本要访问 downloads.claude.ai 取版本并验签名，墙内会失败；能直连的用户再用「官方下载」。

已针对国内网络优化：断点续传、下载进度、离线收尾；客户端装有 zstd 时只需下载约 80MB。

Linux / macOS

curl -fsSL https://download.entropicecho.com/downloads/claude-code/scripts/install.sh | bash

Windows PowerShell

Invoke-WebRequest -Uri "https://download.entropicecho.com/downloads/claude-code/scripts/install.ps1" | Invoke-Expression

Windows CMD

curl -fsSL https://download.entropicecho.com/downloads/claude-code/scripts/install.cmd -o install.cmd && install.cmd && del install.cmd

需要能直连 claude.ai。命令与官方文档一致，安装后由官方脚本自行保持更新。

Linux / macOS

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可以使用包管理器安装：

Homebrew (macOS) ​

bash
brew install --cask claude-code

WinGet (Windows) ​

powershell
winget install Anthropic.ClaudeCode

或使用 npm 全局安装（全平台通用，安装后命令名为 claude）：

bash
npm install -g @anthropic-ai/claude-code

验证：

bash
claude --version

Windows 原生环境需要先安装 Git for Windows；WSL 环境不需要。完整说明见 手动配置与排错。

步骤二：配置 API ​

先确认走哪条路 ​

你的情况走哪条怎么做
已经有 Claude 官方账号且能正常 OAuth 登录官方账号直接 claude 启动，按提示登录，不用做下面的配置
没有官方账号 / 国内网络访问不稳定 / 想用 GPT / Gemini / 国产模型中转站 API Key继续看下面的配置

中转站 API Key 与官方账号互斥 ——同时配置会让 Claude Code 状态混乱，遇到这种情况见 CC-018：OAuth 登录冲突。

最快的方式：控制台一键配置

在控制台 API 密钥 页点当前 key 右侧的 ⋮ → ★ 一键配置，选 Claude Code 与你的系统，第 ③ 步的「配置文件」直接写进 ~/.claude/settings.json（Base URL、API Key、模型别名、默认档、上下文窗口一次生成）。详见 一键配置。

用 CC Switch 配置（推荐） ​

本站默认使用 CC Switch 统一管理 Claude Code 的 API 配置。完整安装、路由开关、框架选择和供应商编辑见 CC Switch 统一配置。

在 CC Switch 中选择 Claude Code / Anthropic 格式；Base URL 也要使用该格式对应值，规则以 CC Switch 统一配置 为准。需要从控制台导入时，先按 创建令牌 找到入口。

手动配置方式（settings.json / 环境变量）仅在排障或高级自定义时使用，见 手动配置与排错。

步骤三：启动 ​

bash
claude

常用命令 ​

命令说明
/model查看或切换当前模型
/cost查看当前令牌用量
/compact压缩上下文，释放空间
/resume恢复历史对话
/clear清空当前对话

深入使用 ​

页面内容
CC Switch 统一配置默认配置入口
手动配置与排错配置文件、环境变量与常见问题
进阶使用CLAUDE.md、MCP 扩展、Hooks、自定义命令
推荐工具MICUCODELINE、生图 MCP、CC Switch、AI Session Viewer、ZCF