Claude Code 的安装配置与使用指南。涵盖 Windows、macOS 及 Linux 系统的安装方法，包括 npm 和官方脚本两种方式。详细说明了 API Key 配置、国产模型接入方案（如阿里云百炼、智谱 AI）及代理设置。提供了核心 CLI 命令、代码审查、重构等实用场景示例，以及 MCP 协议配置、Team Mode 等高级功能。最后阐述了安全隐私注意事项及未来发展趋势，帮助开发者高效利用 AI 编程助手提升工作效率。
在人工智能辅助编程飞速发展的当下，Claude Code 作为 Anthropic 公司推出的命令行工具（CLI），正逐渐成为开发者工作流中不可或缺的一部分。这款工具不仅继承了 Claude 模型强大的逻辑推理能力和低代码幻觉的优势，更将 AI 助手直接集成到终端环境中，实现了代码编写、调试、重构的智能化升级。
Claude Code 是一款基于命令行的 AI 编程助手，它通过终端界面与开发者进行交互，能够：
与传统 IDE 插件相比，Claude Code 具有以下核心优势：
| 特性 | Claude Code | 传统 IDE 插件 |
|---|---|---|
| 上下文理解 | 整个项目级 | 单文件级别 |
| 执行能力 | 可运行命令、修改文件 | 仅提供建议 |
| 交互方式 | 自然语言对话 | 菜单/快捷键 |
| 系统集成 | 终端原生体验 | 依赖特定 IDE |
硬件配置：
操作系统支持：
必装依赖：
验证命令：
node -v
npm -v
git --version
安装 Node.js： 如果未安装或版本过低，可通过以下方式升级：
方式一：官方安装包
方式二：使用 NVM（推荐）
# macOS/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc # 或 ~/.zshrc
# 安装最新 LTS 版本
nvm install --lts
nvm use --lts
# 验证
node --version
npm --version
| 方式 | 优点 | 缺点 | 推荐度 |
|---|---|---|---|
| 官方一键脚本 | 自动更新、无需 Node.js | 需要网络访问 | ⭐⭐⭐⭐⭐ |
| npm | 全局安装稳定可靠、离线可用 | 需手动更新 | ⭐⭐⭐⭐ |
方式一：PowerShell 官方脚本（强烈推荐） 以管理员身份打开 PowerShell，执行：
irm https://claude.ai/install.ps1 | iex
验证安装：
claude --version
claude --help
方式二：npm 全局安装
npm install -g @anthropic-ai/claude-code --scripts-prepend-node-path
-g：全局安装包，让 claude 命令在任意目录都能执行；--scripts-prepend-node-path：安装过程中为脚本注入 Node.js 路径，是 Windows 下的'必加项'（Linux/macOS 通常不需要）。环境变量问题处理：若提示'claude 不是可运行命令'：
npm prefix -g方式三：CMD 安装
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
方式一：官方一键脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash
方式二：npm 安装
sudo npm install -g @anthropic-ai/claude-code
配置环境变量（如需要）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# Ubuntu/Debian
curl -fsSL https://claude.ai/install.sh | bash
# 或 npm 安装
sudo npm install -g @anthropic-ai/claude-code
首次运行会引导配置：
claude
按提示完成 API Key 配置即可开始使用。
Claude Code 的配置文件位于用户目录下的隐藏文件夹：
~/.claude/C:\Users\YourName\.claude关键配置文件：
settings.json - 核心配置claude.json - 会话配置为了直接使用，编辑或创建 ~/.claude.json：
{
"hasCompletedOnboarding": true
}
注意：hasCompletedOnboarding 必须作为顶层字段，不要嵌套在其他字段中。
由于网络限制，国内用户可通过兼容 API 接入国产模型：
方案一：阿里云百炼 Coding Plan
~/.claude/settings.json：{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}
获取 API Key：
方案二：智谱 AI
{
"env": {
"ANTHROPIC_API_KEY": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4/",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
}
}
模型说明：
glm-4.5-air：轻量级，快速响应glm-4.7：主力模型，性能均衡glm-5：最强模型，适合复杂任务# macOS/Linux
export HTTPS_PROXY="http://127.0.0.1:7897"
export HTTP_PROXY="http://127.0.0.1:7897"
# 永久生效（添加到 ~/.zshrc 或 ~/.bashrc）
echo 'export HTTPS_PROXY="http://127.0.0.1:7897"' >> ~/.zshrc
echo 'export HTTP_PROXY="http://127.0.0.1:7897"' >> ~/.zshrc
source ~/.zshrc
| 命令 | 功能描述示例 |
|---|---|
claude | 启动交互模式 |
claude --model | 指定模型 claude --model claude-sonnet-4-5-20250929 |
claude --file | 读取文件 claude -f main.py '分析代码' |
claude --new | 新建会话 claude -n |
claude -r 或 claude --resume | 恢复最近的对话，显示历史消息 |
claude -c 或 claude --continue | 继续当前目录最近的对话 claude -c |
claude -f main.py "帮我审查这段代码，找出潜在问题"
claude -f old_code.js "帮我重构这段代码，提高可读性"
claude -f app.py "为这个文件生成详细的 API 文档"
claude -f buggy_code.py "这段代码报错了，帮我找出问题"
claude -f utils.py "为这个模块生成完整的单元测试"
启动 Claude Code 后，可使用自然语言进行多轮对话：
cd /path/to/your/project
claude
典型对话流程：
> 帮我创建一个 Python Flask 项目框架
好的，我将为你创建以下结构：
- app.py (主应用)
- requirements.txt (依赖)
- templates/ (模板目录)
- static/ (静态资源)
是否需要我立即创建这些文件？
> 是的，请创建
✓ 已创建 app.py
✓ 已创建 requirements.txt
✓ 已创建 templates/ 目录
✓ 已创建 static/ 目录
接下来需要我为 app.py 添加基础路由吗？
> 好的，添加首页和 API 端点 ...
信任目录机制：首次进入项目目录时，Claude Code 会询问是否信任：
Do you trust this directory? [Y/n]
选择 Y 后，Claude Code 才能读写项目文件。
推荐工作流：
MCP 允许 Claude Code 访问外部工具和数据源：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
},
"git": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-git"]
}
}
}
Team Mode 支持多 Agent 协作：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
启用后，Claude Code 可以：
claude --max-tokens 4096 "简短回答这个问题"
# 启用本地缓存加速响应
claude --cache-enabled
# 一次性处理多个相关文件
claude -f src/*.py "统一格式化这些文件"
Q1: 提示'claude 命令不存在' 解决方案：
npm prefix -gQ2: Node.js 版本过低 解决方案：
# 使用 nvm 升级
nvm install 20
nvm use 20
Q3: 网络连接超时 解决方案：
Q4: 无法连接 Anthropic 服务
解决方案：
// 编辑 ~/.claude.json
{
"hasCompletedOnboarding": true
}
Q5: API Key 无效 解决方案：
Q6: Claude 修改了错误的文件 解决方案：
-f specific_file.py/undo 命令撤销操作Q7: 响应速度慢 解决方案：
oh-my-claudecode 是社区开发的增强工具集，提供：
安装：
npx -y oh-my-claudecode@latest
CC Switch 是多模型管理工具，支持：
下载地址：farion1231/cc-switch
claude-code-router 提供负载均衡和故障转移：
npm install -g @musistudio/claude-code-router
ccr start
配置文件 ~/.claude-code-router/config.json：
{
"PORT": 3456,
"Providers": [{
"name": "provider1",
"api_base_url": "https://api1.example.com",
"api_key": "key1",
"models": ["model-a", "model-b"]
}],
"Router": {"default": "provider1"}
}
虽然 Claude Code 是 CLI 工具，但可通过以下方式集成到 IDE：
VS Code 集成：
/vim 模式进行编辑Cursor 集成：
最佳实践：
注意事项：
Claude Code 内置 Constitutional AI 机制：
Claude Code 作为前沿的 AI 编程工具，其核心价值体现在：
技术演进方向：
生态发展方向：
# macOS/Linux
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
# 验证
claude --version
# 启动
claude
# 基础
claude # 启动
claude -f file.py # 读取文件
claude -n # 新会话
# 配置
claude --model <name> # 切换模型
claude --help # 帮助
# 历史
claude -r # 恢复最近的对话，显示历史消息
// ~/.claude/settings.json
{
"env": {
"ANTHROPIC_API_KEY": "sk-ant-xxx",
"ANTHROPIC_BASE_URL": "https://api.example.com",
"ANTHROPIC_MODEL": "claude-sonnet-4-5"
}
}
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online