安装与配置

以官方文档为准

Claude Code 安装方式更新很快。本文给你一条稳妥路径，遇到细节变化时优先看 Claude Code 官方文档。

准备工作：选一个 Agent IDE

Claude Code 是命令行工具，但建议在 IDE 的终端里使用，方便同时看文件。推荐以下免费 IDE：

IDE	说明	下载
Cursor	AI 编辑器首选	cursor.com
Trae	国内友好备选	trae.com.cn
VS Code	免费稳定，插件多	code.visualstudio.com

装好 IDE 后，后续所有操作都在 IDE 的终端（Terminal）里进行。

方式 1：终端命令行安装

需要能访问 claude.ai（魔法上网或配置代理）。

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

先装 Git（Claude Code 在 Windows 上依赖 Git Bash）：

winget install Git.Git

然后装 Claude Code：

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

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

方式 2：让 Agent 帮你装

直接在 IDE 的 Agent 对话框里输入：

帮我安装 node 并且用 npm 安装好最新的 claude code

Agent 会自动完成 Node.js 和 Claude Code 的安装。

方式 3：无魔法安装

先装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

把 Homebrew 加到 PATH（装完后按终端提示操作，或输入）：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

然后装 Claude Code：

brew install --cask claude-code@latest

winget install Anthropic.ClaudeCode

装完后，把 Claude Code 的可执行文件路径配置到系统环境变量的 Path 里，然后重启 IDE。

验证安装

claude --version

有版本号输出就对了。如果提示找不到命令，关掉终端重新打开，或检查 PATH 配置。

也可以跑一下环境诊断：

claude doctor

接模型：CC Switch

Claude Code 本身只是个框架，得给它接个"脑子"。如果直接用 Claude 官方模型，登录就行。但更实际的做法是用 CC Switch 接不同的模型供应商。

CC Switch 是一个开源的桌面应用，在一个面板里统一管理 API 配置，一键切换。

brew tap farion1231/ccswitch
brew install --cask cc-switch

去 GitHub Releases 下载对应版本的安装包。

装好后打开 CC Switch：

在 Claude Code 页面点 "Add Provider"
选择预设模板（如 Minimax、DeepSeek、GLM 等），或手动填 API Key 和 Base URL
点 "Enable" 激活配置
重启终端使环境变量生效

详细图文教程见 CC Switch 使用指南。

推荐模型

国内用户推荐 GLM-5.1（目前口碑最好的国产 coding 模型），MiniMax M2.7 和 K2.5 也不错。复杂项目建议用 Claude Opus 4.6 或 GPT-5.5。

第一次启动

用 cd 进入你的项目文件夹，然后启动：

cd your-project-folder
claude

第一次启动会打开浏览器登录。Claude Code 需要 Pro、Max、Team、Enterprise 或 Anthropic Console 账号，免费 Claude.ai 账号不能直接使用 Claude Code。

如果用 CC Switch 配了模型，可以跳过官方登录。

跳过权限确认

开发时推荐加这个参数，省得不停点确认：

claude --dangerously-skip-permissions

注意安全

这个参数会让 Claude Code 不再询问就执行所有操作（包括终端命令）。只在你信任当前项目的代码时使用。

后续切换模型

在 CC Switch 里配好新的 API 供应商并启用后，重启终端。Claude Code 里用 /model 命令切换。

Git 与 GitHub 绑定

如果还没配好 Git，可以在 Claude Code 里输入：

帮我下载 Git，并与我的 GitHub 账号绑定

Claude Code 会引导你完成配置。

代理配置

国内网络访问 Anthropic 可能不稳定。先把系统代理或终端代理跑通，再启动 Claude Code。

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
claude

端口按你自己的代理软件为准。不要把 API Key、Cookie、项目源码交给不可信的中转服务。

API Key vs 订阅

Claude Pro/Max/Team 订阅：适合日常使用 Claude Code，心智负担低。
Anthropic Console API：适合团队、自动化、按量计费和更细的权限管理。
CC Switch 配置第三方模型：适合特殊网络或企业环境，但要自己评估数据安全、稳定性和合规风险。

01MVP 项目里的建议配置

在 01MVP 这类 monorepo 里使用 Claude Code，先让它读仓库规则，再开始改代码：

claude

进入后先让它阅读：

AGENTS.md
.agents/references/workflow-testing-git.md
和当前任务相关的 .agents/references/*.md

这样它会知道哪些目录可以改、哪些包不能随便删、该跑哪些检查。

常见问题

安装后命令不存在

重新打开终端，或者检查安装器写入的 bin 目录是否在 PATH 里。

Windows 下工具行为奇怪

先确认你是在 PowerShell、CMD、Git Bash 还是 WSL 里运行。项目依赖 Linux 工具链时，优先把整个项目放在 WSL 文件系统里操作。

经常断开或登录失败

先用浏览器确认 Claude 账号可用，再检查终端代理。不要一边改代理软件，一边让 Claude Code 执行长任务。

CC Switch 切了模型但连不上

检查 API Key 有没有填对，模型名称是否和提供方一致。详细排查见 CC Switch 使用指南。

On this page