Claude Code安装使用
Claude Code是由Anthropic公司推出的面向开发者的智能编码Agent, Claude Code是一个工具软件，不能与Claude大模型划等号。Claude Code构建在Anthropic公司的Claude大语言模型之上, 是一个具备记忆、工具调用、自主规划和环境感知能力的"智能代理"
1. 发展背景
在AI辅助编程领域，从早期的代码补全工具(如TabNine、GitHub Copilot)到具备简单对话能力的助手，再到如今的智能代理系统，技术发展经历了三个主要阶段：
- 代码补全阶段：基于统计模型，提供简单的代码片段补全
- 对话辅助阶段：结合大语言模型，能够理解自然语言指令并生成代码
- 智能代理阶段：具备自主规划、工具调用、环境感知和记忆能力，能够完成复杂的开发任务
Claude Code正是处于第三个阶段的代表性产品，它的出现标志着AI编程助手从"被动响应"向"主动协作"的转变。
2. 安装Claude Code
Claude Code已经在2026年年初申明通过nodejs安装已经过时，后面不再维护, 推荐原生安装方式, 以管理员权限打开PowerShell，运行：
irm https://claude.ai/install.ps1 | iex等待下载完成（约 1-2 分钟）。验证：
claude --version显示版本号即成功。
4. 配置文件详解
提示： 如果
C:\Users\你的用户名下没有.claude文件夹，手动新建一个即可。
共需要配置 3 个文件，拷贝到对应位置后直接可用，无需其他操作。
文件 1：settings.json
存放路径： C:\Users\你的用户名\.claude\settings.json, 这个文件是Claude Code的核心配置，用于指定API地址、密钥、使用的模型等。每一行的含义如下：
| 配置项 | 作用 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | API 服务地址 | 指向 DeepSeek 提供的 Anthropic 兼容接口 |
ANTHROPIC_API_KEY | API 密钥 | 你的 DeepSeek API Key，需替换为真实值 |
ANTHROPIC_MODEL | 默认模型 | 日常对话使用的模型，[1m] 表示 100 万 token 上下文 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku 模型 | 执行轻量任务（如文件搜索、简单问答）时自动调用 |
ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet 模型 | 执行中等复杂任务时自动调用 |
ANTHROPIC_DEFAULT_OPUS_MODEL | Opus 模型 | 执行高复杂度任务时自动调用 |
CLAUDE_CODE_EFFORTLEVEL | 推理深度 | max 表示最高推理强度，生成质量更好但耗时更长 |
完整文件内容：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_API_KEY": "sk-你的-api-key",
"ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
}
}安全提醒： 该文件包含 API Key，切勿上传到 GitHub 或分享给他人。
文件 2：CLAUDE.md
存放路径： C:\Users\你的用户名\.claude\CLAUDE.md, 这个文件是 Claude Code 的全局指令文件，里面的规则会在每次对话中自动生效，用来定制 AI 的行为风格。比如你可以要求它始终用中文回复、遵循特定的编码规范等。
完整文件内容：
# 编码原则
## 1. 基础信息
请始终使用中文回复。
## 2. 四个原则
### 1. 编码前思考
- 明确说明假设 — 如果不确定，询问而不是猜测
- 呈现多种解释 — 当存在歧义时，不要默默选择
### 2. 简洁优先
- 不要添加要求之外的功能
- 不要为一次性代码创建抽象
- 不要为不可能发生的场景做错误处理
### 3. 精准修改
- 只碰必须碰的，不要"改进"相邻的代码
- 匹配现有风格，即使你更倾向于不同的写法
### 4. 目标驱动执行
- 定义成功标准，循环验证直到达成提示： CLAUDE.md 可以放在两个位置：
C:\Users\你的用户名\.claude\CLAUDE.md— 全局生效，所有项目共用项目目录\CLAUDE.md— 仅当前项目生效，优先级高于全局
文件 3：.claude.json
存放路径： C:\Users\你的用户名\.claude.json
这个文件用于跳过 Claude Code 首次启动时的交互式引导流程，实现"开箱即用"。
| 字段 | 作用 | 说明 |
|---|---|---|
customApiKeyResponses.approved | 预批准的 API Key 列表 | 填入 Key 的部分片段用于匹配验证，避免每次弹出确认 |
customApiKeyResponses.rejected | 拒绝的 API Key 列表 | 通常留空 |
hasCompletedOnboarding | 是否已完成引导 | 设为 true 跳过首次引导问卷 |
完整文件内容：
{
"customApiKeyResponses": {
"approved": ["你的-api-key-末尾片段"],
"rejected": []
},
"hasCompletedOnboarding": true
}说明：
approved数组中填入 API Key 的末尾若干位字符（如41209fd4073e302d09ee），Claude Code 启动时会用这些片段来匹配你配置的完整 Key，匹配成功则跳过弹窗确认。
5. 启动和使用
打开命令提示符，进入你的项目目录：
cd C:\Users\你的用户名\my-project
claude出现交互界面后，直接输入问题即可：
帮我分析这个项目的结构常用命令
| 命令 | 作用 |
|---|---|
/help | 查看帮助 |
/clear | 清空当前对话 |
/compact | 压缩上下文（对话太长导致卡顿时使用） |
/cost | 查看 API 调用费用 |
/doctor | 诊断安装和配置问题 |
Ctrl + C | 退出 Claude Code |
6. 常见问题
Q1: 提示"npm 不是内部命令"
Node.js 没装好。重启电脑后再打开命令提示符试试，如果仍不行则重新安装 Node.js。
Q2: 启动时报API Key错误
检查 settings.json 是否放在正确的路径（C:\Users\你的用户名\.claude\），文件内容是否完整，API Key 是否有效。
Q3: 提示网络连接错误
检查能否正常访问 https://api.deepseek.com，确认网络代理设置或防火墙是否拦截。
Q4: 如何更新Claude Code？
npm update -g @anthropic-ai/claude-code更新完成后运行 claude --version 确认版本。
Q5: .claude文件夹在资源管理器中看不到？
以 . 开头的文件夹在 Windows 资源管理器中默认隐藏。在地址栏直接输入路径 C:\Users\你的用户名\.claude 回车即可访问。