Claude Code 安装配置与使用详细攻略(下载、配置、使用、进阶)

Claude Code 安装配置与使用详细攻略(下载、配置、使用、进阶)需要先看清适用场景和关键步骤，避免只记结论却忽略实际限制。

Claude Code 安装配置与使用指南（下载、配置、使用、进阶）

一、安装 Claude Code

Claude Code 是 Anthropic 推出的 AI 编程助手，直接在终端里运行，能读懂你的代码仓库、执行命令、修改文件、跑测试，是如今 AI 编程领域最热门的工具之一。它的安装方式有不少，可以根据自己机器的实际情况选择。按官方推荐的优先级排序：原生安装 > WinGet > npm 安装。更详细的说明可以查阅官方文档。

1. 原生安装方式

不同操作系统对应的命令不一样，Windows 下 CMD 和 PowerShell 两条命令也不同，按自己的环境选择。

macOS / Linux / WSL 使用：

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

2. 原生安装报错？试试 WinGet

如果用原生方式安装时报错，可能是网络问题导致 PowerShell 的 irm 命令拿到的不是安装脚本，而是被重定向到了一个网页的 HTML 代码。PowerShell 尝试执行这段 HTML 里的 JavaScript，自然就会抛出一堆语法错误，比如"参数列表中缺少参量""此语言版本中不支持 var 关键字"之类的报错。

判断方法很简单：报错信息里出现的是 script、documentElement、onload 这类网页相关的关键词，而不是正常的安装日志，说明拿到的就是网页源码而不是脚本。

遇到这种情况，可以改用官方推荐的 WinGet 方式，在 PowerShell 中执行：

winget install Anthropic.ClaudeCode

安装完成后，一定要关掉当前 PowerShell 窗口，重新打开一个新的。这一步很关键，否则会读不到新写入的环境变量，直接执行 claude 会提示找不到命令。

3. 还是不行？用 npm 安装

如果上面两种方式都有问题，可以尝试 npm 安装：

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

这个方式的缺点是官方已经停止对 npm 包下载的维护了，后续更新体验不到，但不影响正常使用。如果你在公司内网，不方便访问公网，推荐用这种方式。注意 npm 安装对本地 Node 版本有要求，版本太低不行（实测 Node 14 是不行的，建议用 Node 18 以上）。

安装完成后，可以用下面命令验证是否成功：

claude --version

能输出版本号说明安装成功。

二、启动与配置 Claude Code

重新打开 PowerShell 后执行 claude，可能会发现连不上官方服务，这是因为本地还没有相关配置，请求不到远程服务。

两种使用模式

Claude Code 支持两种方式使用：

1. 官方订阅模式：使用 Anthropic 官方账号（Claude Pro / Max 订阅）直接登录，输入 claude 后会自动引导完成登录认证
2. 第三方 API 模式：通过修改配置指向第三方 API 服务（如 MiniMax、DeepSeek 等），用 API Key 鉴权

如果走官方订阅，直接用 Claude 账号登录即可。如果想用第三方 API，或者官方服务连接不上，就需要手动配置。

手动配置

在你个人用户目录下的 .claude 目录中，新建一个 settings.json 文件。具体的配置内容可以去你购买的平台找，比如我这里用的是 MiniMax 的 token plan，平台会提供详细的配置方法。

一共需要配置两个文件，它们的层级关系是这样的：

C:Users你的用户名├── .claude.json│└── .claude     └── settings.json

第一步：编辑或创建 settings.json

Windows 路径为用户目录下的 .claude/settings.json，macOS & Linux 为 ~/.claude/settings.json。其中 MINIMAX_API_KEY 要替换成你自己的 API Key。

{  "env": {    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",    "ANTHROPIC_AUTH_TOKEN": "MINIMAX_API_KEY",    "API_TIMEOUT_MS": "3000000",    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,    "ANTHROPIC_MODEL": "MiniMax-M2.7",    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"  }}

几个配置项的含义：

1. ANTHROPIC_BASE_URL：API 服务的地址，改成你购买的服务商提供的地址
2. ANTHROPIC_AUTH_TOKEN：你的 API Key，鉴权用
3. ANTHROPIC_MODEL：默认使用的主模型
4. ANTHROPIC_SMALL_FAST_MODEL：轻量快速模型，用于处理简单的子任务（如文件摘要、路由判断）
5. ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL：分别对应 Sonnet、Opus、Haiku 三个档位的模型
6. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：设为 1 可以关闭非必要的网络请求（如遥测数据）

注意：环境变量 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 的优先级高于配置文件。也就是说，如果环境变量里已经设置了这两个值，会覆盖配置文件里的内容。

第二步：编辑或新增 .claude.json

这个文件放在和 .claude 文件夹同级的位置（注意不是和 settings.json 同级），目的是保证每次使用不用重复登录：

{  "hasCompletedOnboarding": true}

配置完成后重新启动，就能正常登录使用了。如果是在 macOS 或 Linux 上，把上面所有 Windows 路径换成对应的 ~ 路径即可，逻辑完全一样。

三、Claude Code 使用技巧

常用内置命令

Claude Code 自带一些常用命令：

1. /plan：开启规划模式。这个模式下不会主动编辑文件或做具体行动，而是先给出一个大致计划，等你确认后再执行
2. /init：项目初始化，或者不小心删了配置文件、想重置环境时使用
3. /clear：清除当前会话的历史聊天记录，聊偏了需要"擦黑板"、节省 token 时用
4. /resume：因为某些原因退出会话后，找回上一次没聊完的会话
5. /export：把本次会话以 Markdown 文档形式导出
6. /compact：压缩当前会话的历史记录，上下文接近上限时用它释放空间
7. /config：查看和修改当前会话的配置
8. /help：查看所有可用命令的列表
9. /model：切换当前会话使用的模型
10. /agents：查看和管理子 Agent
11. /memory：查看和管理项目记忆
12. /mcp：管理 MCP 工具连接

核心使用流程

以最常用的 /plan 为例：输入命令后稍等片刻，它会先给出一个 plan，按一下回车，它就会自己去执行这个计划里的开发任务。这种"先规划再执行"的方式非常适合复杂任务，能避免 AI 一上来就乱改代码。

日常开发中，一个典型的高效工作流是：

1. 用自然语言描述需求：例如"帮我给这个项目加一个用户注册功能"
2. 让 Claude Code 先分析项目结构，理解现有代码
3. 用 /plan 让它给出实施计划
4. 确认计划后让它逐步执行
5. 每完成一步，自己 review 一下改动，有问题及时让它修正

使用小技巧

1. 指定文件范围：直接 @文件名 可以聚焦到某个文件，比如"帮我看下 @main.go 里的 bug"
2. 跨会话记忆：Claude Code 会记住项目的上下文，换会话也能衔接
3. 打断执行：执行过程中按 Esc 可以中断，让 AI 停下来等你调整
4. 设置项目规则：在项目根目录放一个 CLAUDE.md 文件，Claude Code 每次运行都会读取它，用来约束 AI 的行为规范、技术栈、架构约定

四、Skills 扩展

Claude Code 不仅能写代码，还能做设计、分析等工作。Skills 可以让 AI 掌握各种技能——就像一个人不会做饭，你给他一本食谱，他需要做饭时就会自己去食谱里查，然后再动手做。

Skills 可以用官方提供的，也可以用第三方维护的，当然也可以自己编写。GitHub 社区上有很多类似的 Skills 库。

以制作 PPT 为例：想让 Claude Code 做一个介绍代码项目的 PPT，而 MiniMax 官方维护的 Skills 库里有制作 PPT 的 skill，那么依次执行下面两个命令，就会从 GitHub 下载对应的内容：

claude plugin marketplace add https://github.com/MiniMax-AI/skillsclaude plugin install minimax-skills

安装完成后，直接让 Claude Code 做一个 PPT 即可，不需要额外声明什么。只要安装了对应的 skill，它在执行时会自己去找并调用这个 skill。

除了 PPT，常见的 Skills 还有：

1. 代码审查：自动 review 代码质量、找 bug
2. 文档生成：根据代码自动生成 API 文档
3. 单元测试：自动生成测试用例
4. 数据库设计：根据业务需求设计表结构
5. 架构分析：分析项目整体架构并输出报告

如果自己有某个反复使用的流程，也可以编写自己的 Skill，把流程固化成模板，以后让 AI 一键执行。

五、进阶配置与常见问题

1. 连接官方服务失败

如果执行 claude 后一直卡在连接阶段，先检查网络是否能正常访问外网。公司内网环境通常需要走代&理，或者直接改用第三方 API 模式配置。

2. 修改配置后不生效

改完 settings.json 后一定要重启 claude，同时确认改的是正确的文件路径。很多"配置不生效"的问题其实都是改错了文件——settings.json 在 .claude 目录里，.claude.json 在用户目录根下，别搞混。

3. 上下文被占满

长对话很容易把上下文窗口用完。这时可以执行 /compact 压缩历史，或者 /clear 清空重来。也建议开启 /plan 模式，减少无效对话轮次。

4. 权限控制

Claude Code 默认有权限管理机制，AI 想执行命令、修改文件时会先征得你同意。可以在配置里调整权限策略，也可以随时在会话中收紧或放开权限。

5. 多项目隔离

Claude Code 会在每个项目里生成自己的配置和上下文，不同项目的记忆互不干扰。想重置某个项目时，删掉项目里的 .claude 相关缓存即可。

这部分就是 Claude Code 从下载、配置到使用的完整过程。装好之后多做几个项目练手，会越来越顺手。遇到问题多看看官方文档，或者查看 /help 命令输出，大部分坑都能自己解决。