Claude Code 终端 AI 助手搭建指南:从安装到实战
一、Claude Code 是什么
Claude Code 是 Anthropic 官方推出的一款命令行 AI 编程助手,它将强大的 Claude 大模型直接集成到你的终端中,让你无需离开命令行就能获得 AI 辅助编程能力。
核心特点
| 特点 | 说明 |
|---|---|
| 终端原生 | 直接在终端中运行,无需切换到浏览器或 IDE |
| 代码感知 | 能读懂你的项目结构、文件内容和 Git 历史 |
| 多模型支持 | 支持 Claude Opus、Sonnet、Haiku 等多个模型 |
| 工具调用 | 能直接读写文件、执行命令、搜索代码 |
| 上下文记忆 | 支持跨会话的记忆系统,记住你的偏好和项目信息 |
| 多平台 | 支持 Windows、macOS、Linux |
| IDE 集成 | 可作为 VS Code、JetBrains 插件使用 |
Claude Code 与其他 AI 工具对比
| 对比项 | Claude Code | GitHub Copilot | Cursor |
|---|---|---|---|
| 交互方式 | 命令行 + IDE 插件 | IDE 内联补全 | IDE 对话 |
| 代码理解深度 | 深度(可读整个项目) | 中等(当前文件上下文) | 深度 |
| 自主执行 | 可执行命令、读写文件 | 仅补全代码 | 有限 |
| 模型选择 | 多种 Claude 模型 | GPT-4 系列 | 多种模型 |
| 适用场景 | 复杂任务、重构、调试 | 日常代码补全 | 项目级对话 |
二、安装前准备
1. 系统要求
-
操作系统:Windows 10+、macOS 10.15+、Linux(Ubuntu 20.04+等)
-
Node.js:版本 18.0 或更高
-
终端:CMD、PowerShell、Git Bash、iTerm2、Terminal 等
2. 安装 Node.js
Claude Code 依赖 Node.js 运行环境,需要先安装。
Windows 安装:
# 方式一:官网下载 # 访问 https://nodejs.org 下载 LTS 版本安装包,双击安装 # 方式二:使用 winget winget install OpenJS.NodeJS.LTS # 方式三:使用 scoop scoop install nodejs-lts
macOS 安装:
brew install node
Linux 安装:
# Ubuntu / Debian curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt install -y nodejs # 或使用 nvm(推荐) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash nvm install --lts
验证安装:
node --version # 应显示 v18.x.x 或更高 npm --version # 应显示 9.x.x 或更高
三、安装 Claude Code
方式一:npm 全局安装(推荐)
npm install -g @anthropic-ai/claude-code
安装完成后验证:
claude --version
输出版本号即表示安装成功。
方式二:使用 npx 临时运行
npx @anthropic-ai/claude-code
这种方式不需要全局安装,每次运行时自动下载。
方式三:作为 VS Code 插件安装
-
打开 VS Code
-
进入扩展商店(Ctrl+Shift+X)
-
搜索 "Claude Code"
-
点击 "Install" 安装
-
安装完成后侧边栏会出现 Claude Code 图标
方式四:作为 JetBrains 插件安装
-
打开 JetBrains IDE(如 IntelliJ IDEA、WebStorm)
-
进入 Settings → Plugins → Marketplace
-
搜索 "Claude Code"
-
点击 "Install" 安装
-
重启 IDE,工具栏中会出现 Claude Code 图标
四、配置 API Key
1. 获取 Anthropic API Key
-
注册并登录账号
-
进入 API Keys 页面
-
点击 "Create Key" 创建新的 API Key
-
复制并妥善保存(只显示一次)
2. 设置环境变量
Windows(PowerShell):
# 临时设置
$env:ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"
# 永久设置(用户级别)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-your-key-here", "User")
Windows(CMD):
set ANTHROPIC_API_KEY=sk-ant-api03-your-key-here
macOS / Linux:
# 临时设置 export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here" # 永久设置(添加到 shell 配置文件) echo 'export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"' >> ~/.bashrc source ~/.bashrc # 如果使用 zsh echo 'export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"' >> ~/.zshrc source ~/.zshrc
3. 验证配置
# 测试 API 连接 claude "Hello, what model are you?"
如果返回模型信息,说明配置成功。
五、选择与切换 AI 模型
Claude 模型家族
| 模型 | ID | 特点 | 适用场景 |
|---|---|---|---|
| Opus 4.7 | claude-opus-4-7 |
最强能力,深度推理 | 复杂架构设计、代码审查、难题攻关 |
| Sonnet 4.6 | claude-sonnet-4-6 |
平衡性能与速度 | 日常编程、代码生成、问题解答 |
| Haiku 4.5 | claude-haiku-4-5 |
最快速度,成本最低 | 快速问答、简单任务、批量处理 |
在 Claude Code 中切换模型
# 使用 /model 命令切换 /model sonnet /model opus /model haiku # 或使用 /fast 切换快速模式(使用 Opus 但更快输出) /fast
在对话中指定模型
# 启动时指定模型 claude --model claude-sonnet-4-6 # 使用 opus 模型 claude --model claude-opus-4-7
模型选择建议
日常编码 → Sonnet(性价比最高) 复杂重构 → Opus(理解能力最强) 快速问答 → Haiku(响应最快)
六、基本使用方法
1. 启动 Claude Code
# 进入你的项目目录 cd /path/to/your/project # 启动 Claude Code claude
启动后你将进入交互式对话界面:
╭─────────────────────────────────────────╮ │ Claude Code v1.x.x │ │ Model: claude-sonnet-4-6 │ │ /help for commands │ ╰─────────────────────────────────────────╯ > _
2. 基本对话
> 帮我解释一下这个项目中的 src/main.py 文件 > 这段代码有什么 bug?怎么修复? > 写一个 Python 函数,实现快速排序 > 把这段 JavaScript 代码转换成 TypeScript
3. 常用斜杠命令
| 命令 | 说明 |
|---|---|
/help |
查看帮助信息 |
/model |
切换 AI 模型 |
/fast |
切换快速模式 |
/clear |
清空当前对话 |
/compact |
压缩对话上下文 |
/config |
打开配置界面 |
/memory |
查看和管理记忆 |
/review |
审查当前分支的代码变更 |
/init |
初始化 CLAUDE.md 项目文档 |
/cost |
查看当前会话的 Token 消耗 |
4. 文件操作示例
> 读取 config.json 文件,看看有什么配置项 > 帮我在 src/utils/ 目录下创建一个 logger.js 工具函数 > 把所有 .js 文件中的 var 替换成 const > 搜索整个项目中使用了 deprecated API 的地方
5. Git 操作示例
> 查看当前分支的状态和最近的提交 > 帮我写一个 commit message,描述我刚才的改动 > 创建一个 PR,标题是"添加用户认证功能" > 代码审查:看看 main 分支和当前分支的差异
七、高级功能
1. 项目文档 CLAUDE.md
在项目根目录创建 CLAUDE.md 文件,让 Claude 了解你的项目:
# 项目概述 这是一个电商平台的后端服务 # 技术栈 - Node.js + Express - PostgreSQL 数据库 - Redis 缓存 - Docker 部署 # 代码规范 - 使用 ESLint + Prettier - 函数命名使用 camelCase - 文件命名使用 kebab-case - 测试文件放在 __tests__ 目录 # 常用命令 - `npm run dev` 启动开发服务器 - `npm test` 运行测试 - `npm run build` 构建生产版本
2. 记忆系统
Claude Code 可以跨会话记住你的偏好:
# 在对话中让 Claude 记住某些信息 > 请记住:我习惯用 TypeScript,喜欢函数式编程风格 # Claude 会将这些信息保存到 .claude/memory/ 目录 # 下次对话时会自动加载这些记忆
3. 后台 Agent
对于耗时任务,可以让 Claude 在后台运行:
> 帮我在后台运行所有测试,完成后通知我 > 在后台帮我分析整个项目的代码质量,生成报告
4. 代码审查
# 审查当前分支的改动 /review # 或者直接问 > 审查一下我最近的改动,有没有潜在的问题?
5. 多文件重构
> 把项目中所有的 axios 请求替换成 fetch API > 将 src/services/ 目录下的所有文件从 JavaScript 迁移到 TypeScript > 给所有的 API 端点添加输入验证中间件
八、配置文件详解
全局配置位置
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\用户名\.claude\settings.json |
| macOS | ~/.claude/settings.json |
| Linux | ~/.claude/settings.json |
常用配置项
{
"model": "claude-sonnet-4-6",
"theme": "dark",
"permissions": {
"allow": [
"Read",
"Glob",
"Grep",
"Bash(git status)",
"Bash(git log)",
"Bash(npm test)",
"Bash(npm run build)"
],
"deny": [
"Bash(rm -rf *)",
"Bash(git push --force)"
]
},
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": ["npx prettier --write $CLAUDE_FILE_PATH"]
}
]
}
}
项目级配置
在项目根目录创建 .claude/settings.json:
{
"permissions": {
"allow": [
"Bash(npm run dev)",
"Bash(npm test)",
"Bash(npx prisma generate)"
]
}
}
九、实战场景演示
场景 1:快速理解新项目
> 这个项目是做什么的?帮我梳理一下整体架构和主要模块 > 项目的入口文件在哪里?请求的处理流程是怎样的? > 列出所有 API 端点,并说明它们的功能
场景 2:调试 Bug
> 运行 npm test 后有一些测试失败,帮我分析原因并修复 > 用户反馈登录接口有时候会超时,帮我排查可能的原因 > 这个报错是什么意思?怎么解决? 粘贴报错信息...
场景 3:编写新功能
> 帮我实现一个用户注册接口,要求: > 1. 邮箱和密码注册 > 2. 密码需要加密存储 > 3. 发送验证邮件 > 4. 包含输入验证和错误处理 > 5. 编写对应的单元测试
场景 4:代码重构
> 分析 src/controllers/ 目录下的代码,找出重复逻辑并提取公共函数 > 这个函数太长了,帮我拆分成多个小函数 > 把这个类组件重构成函数式组件 + Hooks
场景 5:编写文档
> 帮我给这个项目写一个 README.md,包括项目介绍、安装步骤、使用说明 > 为 src/api/ 目录下的所有接口编写 API 文档 > 帮我写一份技术方案文档,说明如何实现微服务拆分
十、常见问题
Q1:npm install 报错权限不足
# Windows:以管理员身份运行 PowerShell # macOS / Linux: sudo npm install -g @anthropic-ai/claude-code # 或者修改 npm 全局安装路径 mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc
Q2:API Key 无效或过期
# 检查环境变量是否设置正确 echo $ANTHROPIC_API_KEY # macOS / Linux echo %ANTHROPIC_API_KEY% # Windows CMD echo $env:ANTHROPIC_API_KEY # Windows PowerShell # 重新设置 API Key export ANTHROPIC_API_KEY="sk-ant-api03-your-new-key"
Q3:网络连接问题
# 如果在国内,可能需要配置代理 export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 # 或使用第三方 API 中转服务
Q4:如何更新 Claude Code
npm update -g @anthropic-ai/claude-code
Q5:对话上下文过长
# 使用 /compact 压缩上下文 /compact # 或使用 /clear 清空重新开始 /clear
十一、使用技巧
1. 提示词技巧
# 提供具体需求,而非模糊描述 ❌ 帮我改一下这个函数 ✅ 把 calculateTotal 函数的税率计算从硬编码改为从配置文件读取 # 分步骤提出复杂任务 ✅ 第一步:分析当前代码结构 ✅ 第二步:设计新的接口方案 ✅ 第三步:实现代码并编写测试 # 提供上下文 ✅ 我们使用的是 Express + PostgreSQL,参考 src/services/user.js 的写法
2. 安全最佳实践
-
不要在对话中包含敏感信息(密码、密钥等)
-
使用
.gitignore排除.claude/目录中的敏感文件 -
定期检查权限配置,避免授予过高的权限
-
在执行破坏性操作前确认 Claude 的操作计划
3. 成本控制
# 使用 /cost 查看当前消耗 /cost # 简单任务用 Haiku 模型 /model haiku # 复杂任务再切换到 Opus /model opus # 使用 /compact 减少 Token 消耗 /compact
十二、引入其他 AI 大模型(DeepSeek、小米 MiMo 等)
Claude Code 原生支持 Anthropic 的 Claude 模型,但通过 API 中转代理的方式,你可以接入任何兼容 OpenAI / Anthropic API 格式的大模型,包括 DeepSeek、小米 MiMo、通义千问、Kimi 等。
原理说明
Claude Code 通过环境变量 ANTHROPIC_BASE_URL 指定 API 的基础地址。通过将这个地址指向一个兼容 Anthropic API 格式的中转服务,就能让 Claude Code 调用其他大模型。
Claude Code → 中转代理服务 → DeepSeek / MiMo / 其他模型
方案一:使用 One API 统一接入(推荐)
One API 是一个开源的 API 管理和分发系统,支持将各种大模型统一转换为 OpenAI / Anthropic 兼容格式。
1. 部署 One API
# 使用 Docker 部署(推荐) docker run -d \ --name one-api \ -p 3000:3000 \ -e TZ=Asia/Shanghai \ -v /data/one-api:/data \ justsong/one-api:latest
部署完成后访问 http://localhost:3000,默认账号密码为 root / 123456。
2. 配置模型渠道
登录 One API 后台,进入 渠道 页面,添加以下渠道:
添加 DeepSeek 渠道:
| 配置项 | 值 |
|---|---|
| 名称 | DeepSeek |
| 类型 | DeepSeek |
| 密钥 | 你的 DeepSeek API Key |
| 模型 | deepseek-chat, deepseek-coder, deepseek-reasoner |
添加小米 MiMo 渠道:
| 配置项 | 值 |
|---|---|
| 名称 | 小米MiMo |
| 类型 | OpenAI 兼容 |
| 基础URL | https://api.xiaomi.com/v1(或小米提供的实际地址) |
| 密钥 | 你的 MiMo API Key |
| 模型 | MiMo-7B-Chat 等 |
3. 创建令牌
进入 令牌 页面,创建一个新的 API 令牌,记住生成的 Token 值。
4. 配置 Claude Code 连接 One API
Windows(PowerShell):
# 设置 API 基础地址指向 One API $env:ANTHROPIC_BASE_URL="http://localhost:3000" $env:ANTHROPIC_API_KEY="sk-your-one-api-token"
macOS / Linux:
# 设置 API 基础地址 export ANTHROPIC_BASE_URL="http://localhost:3000" export ANTHROPIC_API_KEY="sk-your-one-api-token" # 永久写入配置 echo 'export ANTHROPIC_BASE_URL="http://localhost:3000"' >> ~/.bashrc echo 'export ANTHROPIC_API_KEY="sk-your-one-api-token"' >> ~/.bashrc source ~/.bashrc
5. 在 Claude Code 中切换模型
# 启动 Claude Code claude # 切换到 DeepSeek /model deepseek-chat /model deepseek-coder /model deepseek-reasoner # 切换到小米 MiMo /model MiMo-7B-Chat
方案二:使用 LobeHub 中转
LobeHub 提供了类似的 API 代理功能,界面更美观。
# Docker 部署 docker run -d \ --name lobe-chat \ -p 3210:3210 \ -e OPENAI_API_KEY=your-key \ lobehub/lobe-chat:latest
方案三:直接调用 DeepSeek API(需适配)
DeepSeek 提供了兼容 OpenAI 格式的 API,需要通过一层简单的格式转换。
1. 获取 DeepSeek API Key
-
注册并登录
-
进入 API Keys 页面创建密钥
2. 部署格式转换代理
创建一个简单的 Node.js 代理服务,将 Anthropic 格式转换为 OpenAI 格式:
# 安装 anthropic-to-openai 代理 npm install -g @anthropic-ai/claude-code-proxy # 或使用开源项目 git clone https://github.com/anthropic-adapter/anthropic-to-openai.git cd anthropic-to-openai npm install npm start
3. 配置环境变量
# 指向转换代理 export ANTHROPIC_BASE_URL="http://localhost:8080" export ANTHROPIC_API_KEY="your-deepseek-api-key" export OPENAI_BASE_URL="https://api.deepseek.com" export OPENAI_API_KEY="your-deepseek-api-key"
方案四:直接调用小米 MiMo API
1. 获取 MiMo API 访问权限
小米 MiMo 模型目前通过以下方式提供服务:
-
小米大模型开放平台:访问小米 AI 开发者平台申请 API 权限
-
第三方平台:部分第三方 API 平台已接入 MiMo 模型
2. 通过第三方平台接入
如果你使用的是支持 MiMo 的第三方平台(如硅基流动 SiliconFlow):
# 设置 SiliconFlow 作为中转 export ANTHROPIC_BASE_URL="https://api.siliconflow.cn/v1" export ANTHROPIC_API_KEY="sk-your-siliconflow-key"
3. 在 Claude Code 中使用
claude # 切换到 MiMo 模型(具体模型名以平台提供为准) /model MiMo-7B-Chat /model MiMo-7B-Instruct
各模型对比与选择建议
| 模型 | 提供商 | 特点 | 推荐场景 | 价格 |
|---|---|---|---|---|
| DeepSeek-V3 | DeepSeek | 强大的代码和推理能力 | 复杂编程任务 | 较低 |
| DeepSeek-R1 | DeepSeek | 深度推理,思维链 | 算法题、数学推理 | 中等 |
| DeepSeek-Coder | DeepSeek | 代码专用优化 | 日常编码 | 低 |
| 小米 MiMo-7B | 小米 | 轻量高效,中文友好 | 中文对话、轻量任务 | 低 |
| Qwen2.5 | 阿里 | 多语言能力强 | 通用任务 | 低 |
| Kimi | 月之暗面 | 长文本处理能力强 | 文档分析 | 中等 |
获取各平台 API Key 的入口
| 平台 | 地址 | 注册方式 |
|---|---|---|
| DeepSeek | https://platform.deepseek.com/ | 手机号注册 |
| 硅基流动(SiliconFlow) | https://cloud.siliconflow.cn/ | 手机号注册 |
| 通义千问 | https://dashscope.aliyun.com/ | 阿里云账号 |
| Kimi | https://platform.moonshot.cn/ | 手机号注册 |
| 智谱 AI | https://open.bigmodel.cn/ | 手机号注册 |
多模型环境变量切换脚本
为方便在不同模型之间快速切换,可以创建一个切换脚本:
Windows(PowerShell)脚本 switch-model.ps1:
param(
[string]$Model = "deepseek"
)
switch ($Model) {
"deepseek" {
$env:ANTHROPIC_BASE_URL = "http://localhost:3000"
$env:ANTHROPIC_API_KEY = "sk-your-one-api-key"
Write-Host "已切换到 DeepSeek 模型" -ForegroundColor Green
}
"mimo" {
$env:ANTHROPIC_BASE_URL = "http://localhost:3000"
$env:ANTHROPIC_API_KEY = "sk-your-one-api-key"
Write-Host "已切换到小米 MiMo 模型" -ForegroundColor Green
}
"claude" {
$env:ANTHROPIC_BASE_URL = $null
$env:ANTHROPIC_API_KEY = "sk-ant-api03-your-claude-key"
Write-Host "已切换到 Claude 原生模型" -ForegroundColor Green
}
}
使用方式:
.\switch-model.ps1 deepseek # 切换到 DeepSeek .\switch-model.ps1 mimo # 切换到小米 MiMo .\switch-model.ps1 claude # 切换回 Claude
macOS / Linux 脚本 switch-model.sh:
#!/bin/bash
case "$1" in
deepseek)
export ANTHROPIC_BASE_URL="http://localhost:3000"
export ANTHROPIC_API_KEY="sk-your-one-api-key"
echo "✅ 已切换到 DeepSeek 模型"
;;
mimo)
export ANTHROPIC_BASE_URL="http://localhost:3000"
export ANTHROPIC_API_KEY="sk-your-one-api-key"
echo "✅ 已切换到小米 MiMo 模型"
;;
claude)
unset ANTHROPIC_BASE_URL
export ANTHROPIC_API_KEY="sk-ant-api03-your-claude-key"
echo "✅ 已切换到 Claude 原生模型"
;;
*)
echo "用法: source switch-model.sh [deepseek|mimo|claude]"
;;
esac
使用方式:
source switch-model.sh deepseek # 切换到 DeepSeek source switch-model.sh mimo # 切换到小米 MiMo source switch-model.sh claude # 切换回 Claude
注意事项
-
兼容性:非 Claude 模型可能不完全支持 Claude Code 的所有功能(如工具调用、文件操作等),部分高级功能可能受限。
-
性能差异:不同模型在代码理解和生成能力上有差异,建议根据实际任务选择合适的模型。
-
费用:通过 One API 中转时,费用取决于你所使用的模型提供商的定价。
-
网络:如果 API 服务器在海外,可能需要配置代理:
export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890
-
数据安全:使用第三方中转服务时,注意代码数据可能经过中转服务器,敏感项目建议使用 Claude 原生 API 或私有化部署。
总结
Claude Code 是目前最强大的终端 AI 编程助手之一,它将大模型的能力直接带入开发者最熟悉的命令行环境。通过 API 中转的方式,你还可以在 Claude Code 中接入 DeepSeek、小米 MiMo 等国产大模型,享受不同模型的优势。
无论是日常编码、代码审查、调试 Bug 还是重构项目,Claude Code 都能显著提升开发效率。掌握多模型切换,让你的 AI 编程工具箱更加灵活!
掌握 Claude Code,让 AI 成为你最得力的编程搭档!
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐


所有评论(0)