Claude Code 安装与使用

不凡的凡

675人浏览 · 2026-04-12 20:41:53

不凡的凡 · 2026-04-12 20:41:53 发布

Claude Code 安装与使用指南：国内开发者从零到精通

信息时效声明：本文内容截至 2026-04-12（北京时间），Claude Code 版本、API 价格、中转站政策变化较快，请以官方最新信息为准。
立场声明：这是基于个人真实使用经验的总结，目标读者是国内个人开发者，帮你少踩坑、快上手。

为什么写这篇指南

如果你看到这篇文章，大概率已经听说过 Claude Code —— Anthropic 官方推出的命令行 AI 编程工具。它在复杂代码任务上的表现，确实配得上"高级编程搭档"这个评价。

但作为国内开发者，想顺畅使用它，你要跨过几道门槛：

安装本身不复杂，但后续配置有坑
Anthropic 账号注册需要海外手机号
直连 API 经常被墙或不稳定
模型切换需要额外工具

这篇指南会帮你一一解决。我会按"从零开始"的顺序讲，也会分享我的踩坑经历和最终方案。

一、Claude Code 是什么，适合谁用
二、安装 Claude Code
三、Anthropic 账号注册（需要翻墙）
四、国内访问方案：为什么我选择模型中转站
五、中转站选型对比：我最终选了 jiekou.ai
六、使用 cc-Switch 管理模型切换
七、Claude Code 使用技巧
八、常见问题与踩坑记录

一、Claude Code 是什么，适合谁用

简单介绍

Claude Code 是 Anthropic 官方推出的命令行工具，让你在终端里直接与 Claude 交互，并且：

能读取你当前目录的代码文件
能执行命令、修改文件、运行测试
能理解项目结构，做跨文件的复杂修改
支持多轮对话，保持上下文

适合谁

场景	是否推荐
复杂重构（跨多个文件）	★★★★★ 强烈推荐
从需求文档生成实现计划	★★★★★ 强烈推荐
调试深层 bug	★★★★☆ 推荐
日常补全和小修改	★★★☆☆ 可以用，但 Copilot 更顺手
纯前端样式调整	★★☆☆☆ 大材小用

与其他工具的关系

Claude Code 不是 VS Code 插件，它是一个独立的命令行工具。你可以把它理解为：

一个能在终端里帮你写代码、改代码、跑命令的 AI 搭档。

二、安装 Claude Code

2.1 环境要求

Node.js 18+（建议使用 LTS 版本）
npm 或 yarn
macOS / Linux / Windows（WSL）

2.2 安装步骤

方法一：通过 npm 安装（推荐）

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

方法二：通过 npx 直接运行（不想全局安装）

npx @anthropic-ai/claude-code

2.3 首次启动

# 在你的项目目录下运行
cd your-project
claude

首次运行时，Claude Code 会提示你：

选择登录方式（Anthropic 账号 / API Key）
授权访问当前目录
选择默认模型

⚠️ 注意：如果你在国内，首次登录可能会遇到网络问题。先别急，看完后面的配置方案。

三、Anthropic 账号注册（需要翻墙）

3.1 注册 Anthropic 账号

如果你选择用 Anthropic 账号登录（而不是 API Key），需要先注册：

访问 console.anthropic.com
使用邮箱注册（支持 Google/GitHub 授权）
需要海外手机号验证

3.2 海外手机号解决方案

方案	成本	稳定性	推荐度
接码平台（SMS-Activate 等）	$1-3/次	中等	★★★☆☆
海外亲友号码	免费	高	★★★★★
虚拟号码服务（Google Voice）	免费	高	★★★★☆

我的做法：找海外朋友帮忙收了个验证码，一劳永逸。

3.3 获取 API Key

注册完成后：

进入 console.anthropic.com/settings/keys
点击 “Create API Key”
保存好你的 Key（只显示一次）

⚠️ 安全提示：API Key 相当于你的账户密码，不要泄露、不要提交到 Git 仓库。

四、国内访问方案：为什么我选择模型中转站

4.1 问题：直连 Anthropic API 的困境

即使有了账号和 API Key，国内开发者还会遇到：

问题	表现
连接超时	请求经常失败，尤其是长任务
响应慢	简单问题也要等很久
不稳定	时好时坏，影响工作流
需要全局代理	每次用都要开 VPN
容易被封号	随时可能被封号

4.2 可选方案对比

方案	优点	缺点	适用场景
直连 + VPN	官方接口，最安全	不稳定，延迟高	偶尔使用
模型中转站	稳定、低延迟	需要信任第三方	日常高频使用
自建代理	完全可控	技术门槛高、维护成本	有服务器资源

4.3 我的决策逻辑

作为个人开发者，我优先考虑：

稳定性：不能经常掉链子
性价比：价格合理
易用性：配置简单
安全性：至少承诺不存储敏感数据

最终我选择了 模型中转站 方案，并且在对比后选了 jiekou.ai。

五、中转站选型对比：我最终选了 jiekou.ai

5.1 我测试过的中转站

我花了大约一周时间测试了几个主流中转站，以下是对比：

服务商	稳定性	价格	延迟	模型覆盖	客服响应
OpenRouter	★★★★☆	按量计费	较高	全	英文为主
CloseAI	★★★☆☆	便宜	中等	主流模型	中文
API2D	★★★☆☆	中等	中等	主流模型	中文
jiekou.ai	★★★★★	便宜	低	全	中文响应快

5.2 为什么选 jiekou.ai

优点：

稳定：用了一个多月，没遇到过服务中断
延迟低：响应速度接近直连（在有 VPN 的情况下）
价格透明：按 token 计费，和官方价格差不多，没有隐形加价
支持最新模型：Claude Opus 4.6、Sonnet 4.6 都能用
中文客服：有问题响应及时

使用方式：

# 设置环境变量（在 ~/.zshrc 或 ~/.bashrc 中添加）
export ANTHROPIC_BASE_URL=https://api.jiekou.ai/v1
export ANTHROPIC_API_KEY=你的jiekou.ai密钥

5.3 安全提醒

⚠️ 重要：使用任何中转站都意味着你的请求内容会经过第三方服务器。

不建议用于处理敏感代码（如涉及密钥、用户数据等）

个人项目和日常开发问题不大

企业项目请评估合规要求

5.4 注册 jiekou.ai

访问 jiekou.ai
注册账号（支持微信/邮箱）
充值（建议先充小额测试）
获取 API Key
配置到 Claude Code（见下一节）

六、使用 cc-Switch 管理模型切换

6.1 为什么需要 cc-Switch

Claude Code 默认会用一个模型，但实际使用中你可能想：

日常任务用 Sonnet（便宜、快）
复杂任务切换到 Opus（更强、更贵）
不同项目用不同的 API 配置

手动改配置文件很麻烦，cc-Switch 就是为了解决这个问题。

6.2 安装 cc-Switch

# 通过 npm 安装
npm install -g cc-switch

# 验证安装
cc-switch --version

6.3 配置 cc-Switch

创建配置文件（~/.cc-switch/config.json）：

{
  "profiles": {
    "sonnet": {
      "model": "claude-sonnet-4-6",
      "baseURL": "https://api.jiekou.ai/v1",
      "apiKey": "你的API Key"
    },
    "opus": {
      "model": "claude-opus-4-6",
      "baseURL": "https://api.jiekou.ai/v1",
      "apiKey": "你的API Key"
    },
    "direct": {
      "model": "claude-sonnet-4-6",
      "baseURL": "https://api.anthropic.com",
      "apiKey": "你的Anthropic官方Key"
    }
  },
  "default": "sonnet"
}

6.4 使用 cc-Switch

# 切换到 Sonnet（日常开发）
cc-switch sonnet

# 切换到 Opus（复杂任务）
cc-switch opus

# 切换到直连（开了 VPN 时）
cc-switch direct

# 查看当前配置
cc-switch current

# 启动 Claude Code（会自动使用当前配置）
claude

6.5 我的日常切换习惯

场景	使用模型	原因
快速问答、小修改	Sonnet	便宜够用
重构、跨文件修改	Opus	理解能力强
写文档、代码审查	Sonnet	性价比高
调试深层 bug	Opus	推理能力更强

七、Claude Code 使用技巧

7.1 基本命令

# 启动 Claude Code
claude

# 指定工作目录
claude --dir /path/to/project

# 使用特定模型
claude --model claude-opus-4-6

# 查看帮助
claude --help

7.2 高效使用技巧

技巧 1：给 Claude 足够的上下文

# ❌ 不好的提问
帮我修复这个 bug

# ✅ 好的提问
在 src/auth/login.ts 的 handleLogin 函数里，
用户输入错误密码后应该返回 401 而不是 500，
请帮我定位问题并修复。

技巧 2：用斜杠命令提效

Claude Code 支持一些内置斜杠命令：

命令	作用
`/help`	查看帮助
`/clear`	清除对话历史
`/compact`	压缩对话历史，释放上下文
`/cost`	查看本次会话花费
`/model`	切换模型
`/permissions`	管理权限设置

技巧 3：明确告诉 Claude 你要什么

# 不明确
这个函数写得不好，帮我改一下

# 明确
这个函数有以下问题：
1. 没有错误处理
2. 变量命名不清晰
3. 缺少注释

请逐条修复，不要改动其他逻辑。

技巧 4：利用 Claude 的记忆功能

Claude Code 会在项目目录下创建 .claude/ 文件夹，保存：

对话历史
项目记忆（你告诉它要记住的事）
权限设置

你可以手动编辑 .claude/CLAUDE.md 来告诉 Claude 项目相关信息：

# 项目信息

这是一个 React + TypeScript 项目。

## 代码规范
- 使用函数组件
- 样式用 Tailwind CSS
- 测试用 Vitest

## 重要文件
- src/App.tsx: 主入口
- src/api/: API 调用相关

技巧 5：分步骤处理复杂任务

# ❌ 一次性给太大任务
帮我重构整个认证模块

# ✅ 分步骤
1. 先分析当前认证模块的结构
2. 列出需要改进的地方
3. 我们逐个处理

7.3 实用工作流示例

场景：从需求到实现

第一步：需求分析
> 我要添加一个用户头像上传功能，需要：
> - 支持拖拽上传
> - 图片压缩
> - 上传进度显示
> 请先帮我分析需要改动哪些文件，给出实施计划。

第二步：逐步实现
> 好，先从后端 API 开始，请帮我实现上传接口。

第三步：测试
> 请为这个接口写单元测试。

第四步：前端实现
> 现在实现前端组件...

第五步：提交
> 请帮我生成 commit message。

7.4 成本控制技巧

Claude Code 按 token 计费，以下技巧可以帮你省钱：

技巧	说明
及时 `/compact`	长对话会积累大量历史，压缩后可减少 token 消耗
用 Sonnet 做日常	Opus 贵 3-4 倍，大部分任务 Sonnet 够用
明确指令	减少"请重试"的次数
限制文件范围	不要让 Claude 读取不相关的文件

八、常见问题与踩坑记录

Q1：安装后提示找不到命令

原因：npm 全局安装路径不在 PATH 中。

解决：

# 查看 npm 全局安装路径
npm config get prefix

# 添加到 PATH（以 macOS 为例，在 ~/.zshrc 中添加）
export PATH="$(npm config get prefix)/bin:$PATH"

# 生效
source ~/.zshrc

Q2：连接超时 / 无法连接到 Anthropic

原因：网络问题，需要代理或中转站。

解决：参考第四、五章，配置模型中转站。

Q3：API Key 配置了但还是报错

排查步骤：

# 1. 检查环境变量是否生效
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL

# 2. 手动测试 API
curl https://api.jiekou.ai/v1/messages \
  -H "x-api-key: 你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 10, "messages": [{"role": "user", "content": "hi"}]}'

Q4：Claude 修改了不该改的文件

解决：

使用 Git，随时可以回滚
在 .claude/settings.json 中设置忽略文件：

{
  "permissions": {
    "deny": [
      ".env",
      "*.key",
      "secrets/*"
    ]
  }
}

Q5：cc-Switch 切换后不生效

排查：

# 查看当前使用的环境变量
cc-switch current

# 确认 Claude Code 启动时使用的是新的环境变量
# 可能需要重启终端或重新 source 配置文件

Q6：花费太高怎么办

建议：

检查是否一直在用 Opus，考虑降级到 Sonnet
检查对话历史是否太长，使用 /compact 压缩
检查是否有重复的无效对话

总结

Claude Code 是一个强大的 AI 编程工具，但对国内开发者来说，配置过程确实有些曲折。我的最终配置方案是：

安装：npm 一行命令
账号：Anthropic 官方账号（找朋友帮忙验证）
访问：jiekou.ai 中转站（稳定、低延迟）
切换：cc-Switch（灵活管理模型）

这套方案用了一个多月，整体体验流畅，推荐给同样在国内的个人开发者。

参考资料

DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

RAG召回分数漂亮但回答仍错：评测集构造与DeepSeek生成护栏的工程解法

DeepSeek技术社区

评测绿不等于上线绿：DeepSeek-V4 迁移中合成数据陷阱与真实场景脱节

DeepSeek技术社区

DeepSeek-V4上下文管理实战：会话摘要与外存策略如何平衡性能与记忆精度

DeepSeek技术社区

所有评论(0)

查看更多评论

不凡的凡

@weixin_37543822

已为社区贡献1条内容

Claude Code 安装与使用

不凡的凡

Claude Code 安装与使用指南：国内开发者从零到精通

为什么写这篇指南

目录

一、Claude Code 是什么，适合谁用

简单介绍

适合谁

与其他工具的关系

二、安装 Claude Code

2.1 环境要求

2.2 安装步骤

2.3 首次启动

三、Anthropic 账号注册（需要翻墙）

3.1 注册 Anthropic 账号

3.2 海外手机号解决方案

3.3 获取 API Key

四、国内访问方案：为什么我选择模型中转站

4.1 问题：直连 Anthropic API 的困境

4.2 可选方案对比

4.3 我的决策逻辑

五、中转站选型对比：我最终选了 jiekou.ai

5.1 我测试过的中转站

5.2 为什么选 jiekou.ai

5.3 安全提醒

5.4 注册 jiekou.ai

六、使用 cc-Switch 管理模型切换

6.1 为什么需要 cc-Switch

6.2 安装 cc-Switch

6.3 配置 cc-Switch

6.4 使用 cc-Switch

6.5 我的日常切换习惯

七、Claude Code 使用技巧

7.1 基本命令

7.2 高效使用技巧

技巧 1：给 Claude 足够的上下文

技巧 2：用斜杠命令提效

技巧 3：明确告诉 Claude 你要什么

技巧 4：利用 Claude 的记忆功能

技巧 5：分步骤处理复杂任务

7.3 实用工作流示例

场景：从需求到实现

7.4 成本控制技巧

八、常见问题与踩坑记录

Q1：安装后提示找不到命令

Q2：连接超时 / 无法连接到 Anthropic

Q3：API Key 配置了但还是报错

Q4：Claude 修改了不该改的文件

Q5：cc-Switch 切换后不生效

Q6：花费太高怎么办

总结

参考资料

所有评论(0)

温馨提示：您尚未绑定手机号

不凡的凡