Claude Code 入门到精通：2026 保姆级教程（含省钱配置）
- Claude Code 是 Anthropic 官方的终端 AI 编程 Agent
- 直接在终端操作，深度集成 Git、文件系统、Shell 命令
- 官方按 token 计费，重度使用每月 $60-100+
- 配合 youragent API Key，同样的 Claude Opus 4.6，费用降低 89-96%
Claude Code 是什么？
Claude Code 是 Anthropic 出品的 CLI（命令行）AI 编程工具。和 Cursor 不同，它不是 IDE，而是终端里的 AI Agent。
它能：
- 🔍 阅读你的整个代码库，理解项目结构
- ✏️ 直接编辑多个文件
- 🖥️ 执行 Shell 命令（编译、测试、部署）
- 🔀 自动 Git commit、创建 PR
- 🔌 连接 MCP Server 扩展能力
安装
前提条件
- Node.js 18+（推荐 20+）
- npm 或直接用 npx
安装方法
# 方法一：全局安装
npm install -g @anthropic-ai/claude-code
# 方法二：不安装直接用
npx @anthropic-ai/claude-code
验证安装：
claude --version配置 API Key
官方方式（贵）
export ANTHROPIC_API_KEY=sk-ant-你的官方密钥
claude
官方价格：Claude Opus 4.6 输入 $15 / 输出 $75 per 1M tokens。
youragent 方式（省 89-96%）
# 设置 youragent API Key 和端点
export ANTHROPIC_API_KEY=sk-你的youragent密钥
export ANTHROPIC_BASE_URL=https://your-agent.cc/api
# 启动 Claude Code
claude
youragent 价格：$100 官方等价额度仅需 $4-5。同样的 Claude Opus 4.6，无降智。
永久配置（推荐）
把环境变量写入 Shell 配置文件：
# macOS / Linux
echo 'export ANTHROPIC_API_KEY=sk-你的youragent密钥' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL=https://your-agent.cc/api' >> ~/.zshrc
source ~/.zshrc
# 或用 Claude Code 的配置文件
claude config set apiKey sk-你的youragent密钥
claude config set baseUrl https://your-agent.cc/api
基础使用
启动
# 在项目根目录启动
cd my-project
claude
Claude Code 会自动扫描项目结构，建立代码库理解。
基础对话
启动后直接输入需求：
> 帮我分析这个项目的架构，画个依赖关系图
> 找出所有未处理的 error，加上 try-catch
> 写一个单元测试覆盖 utils.js 的所有函数
常用命令
| 命令 | 功能 |
|---|---|
/help | 显示帮助 |
/clear | 清空对话历史 |
/compact | 压缩上下文（节省 token） |
/cost | 查看当前会话花费 |
/model | 切换模型 |
Agent 模式实战
Claude Code 天生就是 Agent 模式。它可以：
自动编辑 + 执行
> 把整个项目从 JavaScript 迁移到 TypeScript
Claude Code 会：
分析所有 .js 文件
逐个转换为 .ts
添加类型声明
修改 tsconfig.json
运行 tsc 检查错误
自动修复类型错误 Git 深度集成
> 完成后自动 commit，写好 commit message
Claude Code 会：
git add 所有修改的文件
生成合适的 commit message
执行 git commit 多文件协同编辑
> 给项目添加用户认证功能：路由、中间件、数据库模型全部搞定
Claude Code 会同时修改 routes.js、middleware.js、models/user.js、
package.json（添加依赖），然后运行 npm install
MCP 连接（进阶）
MCP (Model Context Protocol) 让 Claude Code 连接外部工具。
配置 MCP Server
在项目根目录创建 .mcp.json：
{
"servers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-server-filesystem", "/path/to/allowed/dir"]
},
"github": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-server-github"],
"env": {
"GITHUB_TOKEN": "你的GitHub Token"
}
}
}
}
常用 MCP Server
| Server | 用途 |
|---|---|
mcp-server-filesystem | 文件系统操作 |
mcp-server-github | GitHub API 操作 |
mcp-server-postgres | 数据库查询 |
mcp-server-puppeteer | 浏览器自动化 |
配置 MCP 后，Claude Code 可以直接操作 GitHub、查数据库、控制浏览器——真正的全栈 Agent。
费用控制技巧
1. 用 /compact 压缩上下文
长对话会消耗大量 token。定期用 /compact 压缩：
> /compact2. 用 /cost 监控花费
> /cost
Session cost: $0.23 (1.2M tokens)
3. 选择合适的模型
| 任务 | 推荐模型 | 原因 |
|---|---|---|
| 复杂架构设计 | Opus 4.6 | 最强推理能力 |
| 日常代码编辑 | Sonnet 4.6 | 性价比高，速度快 |
| 简单问答 | Sonnet 4.6 | 没必要用 Opus |
4. 用 youragent 大幅降低成本
同样的使用量，费用对比：
| 使用强度 | 官方费用 | youragent 费用 | 节省 |
|---|---|---|---|
| 轻度 (5M tokens/月) | ~$25 | ~$1 | 96% |
| 中度 (50M tokens/月) | ~$250 | ~$10 | 96% |
| 重度 (200M tokens/月) | ~$1000 | ~$40 | 96% |
Claude Code vs Cursor
| 特性 | Claude Code | Cursor |
|---|---|---|
| 界面 | 终端 CLI | GUI IDE |
| 上手难度 | 需要终端经验 | 开箱即用 |
| Agent 能力 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| Git 集成 | 深度（自动 commit） | 基础 |
| MCP 支持 | ✅ 原生 | ⚠️ 有限 |
| 适合 | 后端/CLI 开发者 | 前端/全栈 |
常见问题
Q1：Claude Code 支持 Windows 吗？
支持。通过 WSL2 或直接在 PowerShell/CMD 中使用。推荐 WSL2 获得最佳体验。
Q2：为什么用 youragent 而不是官方 API？
价格。官方 Claude Opus 4.6 API 每 1M token 输入 $15 / 输出 $75。youragent 同样是官方 1:1 倍率，但价格仅需 4%。
Q3：连接 youragent 后速度怎么样？
多渠道负载均衡，平均延迟 <200ms，和官方体验完全一致。
Q4：Claude Code 和 Claude Max ($100/月订阅) 哪个划算？
如果你每月 token 消耗在 50M 以下，Claude Code + youragent（~$2-10/月）远比 Claude Max 划算。Max 适合每天长时间高强度使用的用户。
Q5：可以在 CI/CD 中使用 Claude Code 吗？
可以。设置好环境变量后，可以在 GitHub Actions、GitLab CI 等环境中非交互式运行 Claude Code。
快速开始
# 1. 安装
npm install -g @anthropic-ai/claude-code
# 2. 配置 youragent（省 96%）
export ANTHROPIC_API_KEY=sk-你的密钥
export ANTHROPIC_BASE_URL=https://your-agent.cc/api
# 3. 开始使用
cd your-project
claude
获取 API Key → Telegram @zhoumo_828 / 微信 Moumlbius
*本文最后更新：2026 年 3 月 18 日*
*相关阅读：Cursor API Key 配置教程 · AI 编程工具对比 · Cursor 免费版 vs Pro*