CCClaude Code中文喂饭教程

Claude Code CLI 安装与登录

Claude Code CLI 安装教程：完成安装、登录、版本检查和可用性验证，确认 CLI 正常后再进入模型配置和正式任务。

Windows PowerShell 安装

安装是少数需要执行命令的地方。执行前先确认终端是自己信任的环境，不要在陌生脚本里粘贴账号、密钥或 token。

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

macOS、Linux、WSL 安装

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

WinGet 安装

winget install Anthropic.ClaudeCode

验证安装

claude --version
claude doctor

如果 claude --version 失败，先不要继续。安装没完成时，模型配置、项目读取和权限模式都会跟着出问题。

验证结果怎么看

可以把验证结果交给 CC 解释，但不要粘贴任何密钥：

这是 Claude Code 安装验证结果，请帮我判断是否可以继续。

claude --version：
【粘贴结果】

claude doctor：
【粘贴结果】

请判断：
1. 是否有阻塞问题。
2. 如果有，最可能是哪一类问题。
3. 下一步应该先处理什么。
4. 是否可以进入登录和模型配置。
5. 不要让我粘贴 API Key、Token 或账号密码。

Windows 常见提醒

Windows 上最常见的混乱是“安装在一个环境，启动在另一个环境”。可以按表排查：

现象优先判断
PowerShell 能用，CMD 不能用PATH 刷新或终端环境不同
Windows 能用，WSL 不能用WSL 里没有安装
安装后仍找不到命令重新打开终端或检查 PATH
doctor 报 shell 问题当前 shell 配置或权限限制
公司电脑无法执行脚本安全策略或管理员权限限制

登录

安装后，在项目目录或任意终端里启动：

claude

按浏览器提示完成登录。账号必须支持 Claude Code；免费 Claude.ai 账号通常不包含 Claude Code 权限。

登录失败先不要继续

如果登录失败，不要马上改模型、改网关、改项目。先确认：

登录问题不要和模型问题混在一起。登录都没完成时，不要急着配置国内模型或网关。

Claude Code 登录没有完成，请帮我排查。

现象：
【浏览器是否打开、终端是否回调、报错文字】

请判断：
1. 更像浏览器回调问题、账号权限问题、网络问题还是终端环境问题。
2. 我应该先重新登录、重新打开终端，还是先看 doctor。
3. 哪些信息不能粘贴给你。
4. 不要修改项目文件。

第一次启动后先做什么

请只读检查当前 Claude Code 环境。

要求：
1. 不要修改文件。
2. 告诉我当前是否能正常响应。
3. 告诉我当前项目路径是什么。
4. 如果发现权限、网络、账号或 shell 问题，请先说明，不要继续任务。

不要一启动就做什么

安装排障的顺序

阶段先确认
安装命令是否执行成功，有没有报错
命令可用claude --version 是否能返回版本
环境健康claude doctor 是否有阻塞项
登录状态浏览器登录和终端回调是否完成
项目只读是否能进入项目并只读分析

只要前一阶段没通过，就不要跳到后一阶段。跳着排查会浪费时间。

安装后的第一轮闭环

请只读确认 Claude Code 当前是否可用于学习。

请检查：
1. 当前能否正常对话。
2. 当前工作目录是什么。
3. 是否能只读查看当前目录。
4. 是否有明显权限、网络、登录问题。
5. 下一步是否应该配置模型，还是先修环境问题。

如果安装失败

Claude Code 安装失败了。

请帮我按阶段排查：
1. 安装命令是否执行成功。
2. claude 命令是否进入 PATH。
3. claude --version 是否可用。
4. claude doctor 是否有阻塞项。
5. 登录是否完成。
6. 下一步最小修复动作是什么。

不要让我重复试错，不要让我粘贴任何密钥。

验收结果

下一篇：集成大模型