1
Claude Code 安装与使用
AI 编程助手的完整上手指南 | 星辰 | 2026.03.27
1.1 安装

macOS / Linux

安装或更新 Node.js(v18.0 或更高版本)。

1. 在终端中执行下列命令,安装 Claude Code。
npm install -g @anthropic-ai/claude-code
2. 运行以下命令验证安装。若有版本号输出,则表示安装成功。
claude --version

Windows

在 Windows 上使用 Claude Code,需要安装 WSL 或 Git for Windows,然后在 WSL 或 Git Bash 中执行以下命令。

npm install -g @anthropic-ai/claude-code

详情可以参考 Claude Code 官方文档的 Windows安装教程。

1.2 在 Claude Code 配置 Coding Plan

在 Claude Code 中接入 Coding Plan,需要配置以下信息:

1. ANTHROPIC_BASE_URL:设置为 https://starapi.net/
2. ANTHROPIC_AUTH_TOKEN:设置为 Coding Plan 专属 API Key(sk 开头的一串字符,通过获取兑换码,创建令牌)
3. ANTHROPIC_MODEL:设置为 Coding Plan 支持的模型

macOS / Linux

1. 创建并打开配置文件 ~/.claude/settings.json
~ 代表用户主目录。如果 .claude 目录不存在,需要先行创建。可在终端执行 mkdir -p ~/.claude 来创建。
nano ~/.claude/settings.json
2. 编辑配置文件。将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://starapi.net/",
        "ANTHROPIC_MODEL": "claude-sonnet-4-6"
    }
}
3. 保存配置文件,重新打开一个终端即可生效。
必须执行:编辑或新增 ~/.claude.json 文件,将 hasCompletedOnboarding 字段的值设置为 true 并保存文件。该字段为顶层字段,请勿嵌套于其他字段内部。
{
  "hasCompletedOnboarding": true
}

该步骤可避免启动 Claude Code 时报错:Unable to connect to Anthropic services

Windows

创建并打开配置文件 C:\Users\您的用户名\.claude\settings.json

CMD

a. 创建目录
if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
b. 创建并打开文件
notepad "%USERPROFILE%\.claude\settings.json"

PowerShell

a. 创建目录
mkdir -Force $HOME\.claude
b. 创建并打开文件
notepad $HOME\.claude\settings.json
2. 编辑配置文件。将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://starapi.net/",
        "ANTHROPIC_MODEL": "claude-sonnet-4-6"
    }
}
3. 保存配置文件,重新打开一个终端即可生效。编辑或新增 C:\Users\您的用户名\.claude.json 文件,将 hasCompletedOnboarding 字段的值设置为 true,并保存文件。
{
  "hasCompletedOnboarding": true
}
1.3 使用 Claude Code
1. 打开终端,并进入项目所在的目录。运行以下命令启动程序 Claude Code:
cd path/to/your_project
claude
2. 启动后,需要授权 Claude Code 执行文件。
终端中授权 Claude Code 执行文件的确认界面
图 1-1:终端中授权 Claude Code 执行文件的确认界面(输入 y 继续)
3. 输入 /status 确认模型、Base URL、API Key 是否配置正确。
4. 在 Claude Code 中对话。
1.4 切换模型
1. 启动 Claude Code 时切换:在终端执行 claude --model <模型名称> 指定模型并启动 Claude Code,例如 claude --model claude-sonnet-4-6
2. 会话期间:在对话框输入 /model <模型名称> 命令切换模型,例如 /model claude-sonnet-4-6
1.5 常见命令
命令说明
/init在项目根目录生成 CLAUDE.md 文件,用于定义项目级指令和上下文。
/status查看当前模型、API Key、Base URL 等配置状态。
/model <模型名称>切换模型,例如 /model claude-sonnet-4-6
/clear清除对话历史,开始全新对话。
/plan进入规划模式,仅分析和讨论方案,不修改代码。
/compact压缩对话历史,释放上下文窗口空间。
/config打开配置菜单,可设置语言、主题等。

更多命令与用法详情,请参考 Claude Code 官方文档。

1.6 Claude Code IDE 插件

Claude Code IDE 插件支持在 VS Code、VS Code 系列 IDE(如 Cursor、Trae 等)、JetBrains 系列 IDE(如 IntelliJ IDEA、PyCharm 等)中使用。

VS Code

1. 请先在 Claude Code 配置 Coding Plan,Windows 还需要安装 WSL 或 Git for Windows。
2. 打开 VS Code,在扩展市场中搜索 Claude Code for VS Code 并安装。
3. 安装完成后,重启 VS Code。单击右上角图标进入 Claude Code 开始对话。
4. 若在对话时弹出 Anthropic 登录界面,说明尚未在 Claude Code 配置 Coding Plan,请先完成配置。
5. 切换模型:在 Claude Code 中切换模型配置,然后在 IDE 插件中新建对话即可生效。
VS Code 插件市场搜索 Claude Code
图 1-2:VS Code 插件市场 — 搜索并安装 Claude Code for VS Code
Claude Code VS Code 主界面
图 1-3:Claude Code VS Code 插件主界面 — Past Conversations 页面

JetBrains

1. 请先安装 Claude Code 并在 Claude Code 配置 Coding Plan。
2. 打开 JetBrains(如 IntelliJ IDEA、PyCharm 等),在扩展市场中搜索 Claude Code 并安装。
3. 安装后重启 IDE,点击右上角图标即可使用,可通过 /model <模型名称> 命令切换模型。若在对话时出现 Not logged in. Please run /login 报错,说明尚未在 Claude Code 配置 Coding Plan,请先完成配置。
JetBrains 插件市场搜索 Claude Code
图 1-4:JetBrains 插件市场 — 搜索并安装 Claude Code 插件
Claude Code Anthropic 登录方式
图 1-5:Claude Code 登录方式选择 — Claude Pro Subscription / Anthropic Console / API Key
1.7 错误码

常见报错及解决方案请参考 1.8 常见问题部分。

报错 API Error: Unable to connect to API (ECONNRESET)
该错误由 Claude Code 客户端的网络连接问题引起,与您的配置无关,通常会自行恢复。建议:
  1. 等待几分钟后重试。
  2. 检查网络连接是否正常。
  3. 如果使用了代理或 VPN,请关闭后重试。
  4. 将 Claude Code 升级到最新版本:npm install -g @anthropic-ai/claude-code@latest
报错 Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
该错误表示 Claude Code 尝试连接 Anthropic 官方服务而非 Coding Plan 服务端,通常是因为环境变量未正确配置或未生效。请按以下步骤排查:
1. 检查配置文件:确认 ~/.claude/settings.json 中已正确配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。确认配置内容如下(请替换为您的实际 API Key):
# 查看当前配置
cat ~/.claude/settings.json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://starapi.net/",
        "ANTHROPIC_MODEL": "claude-sonnet-4-6"
    }
}
2. 检查环境变量是否冲突:如果同时通过环境变量和配置文件设置了 ANTHROPIC_BASE_URL,请确保两者指向相同的 Coding Plan 地址,避免冲突。执行以下命令检查:echo $ANTHROPIC_BASE_URL。如果输出为空或指向非 Coding Plan 地址,请清除该环境变量或将其设置为正确的 Coding Plan Base URL。
3. 确认 hasCompletedOnboarding:检查 ~/.claude.json 文件中 hasCompletedOnboarding 是否设置为 true,否则 Claude Code 启动时会尝试连接 Anthropic 官方服务进行登录验证。
4. 重新打开终端:修改配置文件后,需要打开一个新的终端窗口,再执行 claude 命令以使配置生效。

更多常见问题请参考 1.8 常见问题。

1.8 常见问题

见 1.7 错误码部分,已包含详细排查步骤。

1.9 最佳实践
1. 上下文管理
  • 及时清理:使用 /clear 定期重置对话,防止旧的上下文干扰新任务并节省 Token。
  • 主动压缩:使用 /compact 命令让 Claude 总结关键决策和修改的文件,保留核心记忆。
  • 明确指定文件:提问时使用 @ 引用文件(如 write a test for @auth.py),避免模型无效扫描整个项目。
  • 善用子代理(Sub-agents):对于大规模任务,让 Claude 启动子代理执行。子代理完成任务后返回精炼结论,保护主对话的上下文空间。
2. 先计划,再执行
  • 启用 Plan 模式:复杂任务前,先分析方案,不实际修改文件。
  • 快捷操作:连续按两次 Shift + Tab 进入 Plan Mode。
  • 提示词约束:提示词明确要求"先输出详细实施计划,经我确认后再修改文件"。
  • 降低试错成本:确保逻辑闭环后再进行代码变更。
3. 沉淀项目核心知识:编写 CLAUDE.md
  • 包含关键信息:每次会话启动时自动加载 CLAUDE.md,建议填入构建命令、代码规范及工作流等通用规则。
  • 动态维护:内容应简短易读,仅记录广泛适用的全局约定,并随项目演进持续补充新规则。
4. 扩展能力:MCP 与 Skills
  • MCP:安装成熟的 MCP Server,连接外部服务。例如:添加联网搜索 MCP。
  • Skills:编写详细的 Skill 描述文案。Claude 决定是否调用该工具,取决于对该工具用途的定义。例如:添加视觉理解能力 Skill。
  • Skills vs MCP:Skills 教会 Claude"怎么做"(工作流知识),MCP 给 Claude"做的工具"(外部接口)。两者互补,Skills 也可集成外部接口。
5. 自动化守护:Hooks
  • 使用 Hooks:Hooks 是确定性规则。它在 Claude 工作流的特定生命周期节点(如 PreToolUse 工具执行前校验等)自动运行本地脚本,确保关键校验或操作 100% 执行。
  • 配置方式:
    a. 运行 /hooks 进行交互式配置。
    b. 直接编辑 .claude/settings.json
    c. 让 Claude 帮你编写,如:"编写一个在每次文件编辑后运行 eslint 的 hook"。
6. 建立自检闭环
  • 强制验证:要求 Claude 修改代码后,必须运行相关的测试用例(如 pytest 或 npm test)。
  • 定义成功标准:"修改完成后,请确保编译通过,并且运行 curl 命令验证 API 返回值为 200"。
  • 视觉反馈:前端修改时,要求 Claude 截取浏览器截图来确认 UI 效果。
1.10 能力扩展

Claude Code 支持通过 MCP 和 Skills 扩展自身能力,例如调用联网搜索获取实时信息、使用图片理解 Skill 分析图像内容等。详情请参考 1.9 最佳实践。

2
闲鱼运营基本流程
从零起步,快速掌握闲鱼运营逻辑 | 闲鱼 x 闲鱼二手交易平台
2.1 账号设置
1
账号人设打造
使用豆包生成昵称、头像、个人简介
2
设置路径
首页 → 我的 → 设置 → 个人资料
完善的头像、昵称和简介能提升买家信任感,有助于提高转化率。
2.2 商品发布流程

发布商品时需要填写以下字段,每个字段都会影响商品的曝光和成交:

商品发布流程
图 2-1:商品发布流程
  • 分类:选择正确的商品分类,有助于平台精准推荐
  • 工期:虚拟商品无需工期,实物商品需填写生产/发货时间
  • 价格:参考同行定价,设置有竞争力的价格
  • 交付方式:选择自动发货或手动发货,自动发货适用于虚拟商品
自动回复功能可参考 小红书运营流程 章节的自动回复设置方法,实现 24 小时自动接待。
2.3 闲鱼推广

3.1 闲鱼币推广

闲鱼币推广
图 2-2:闲鱼币推广
  • 急速卖:使用闲鱼币快速推广商品,获得更多曝光
  • 闲鱼币抵扣:允许买家使用闲鱼币抵扣部分金额,提升转化

3.2 曝光推广

擦亮任务1
图 2-3:每天尽早完成擦亮任务以获得更多的曝光
擦亮任务2
图 2-4:每天尽早完成擦亮任务以获得更多的曝光

3.3 刷单任务

初期可以通过刷单提升商品的基础数据和店铺权重,但要注意保持真实感,避免被平台检测。
3
小红书运营流程
小红书账号运营流程 SOP | 内容种草与私域引流
3.1 相关帖子下面积极恢复

有咨询 Claude 封号、如何使用、求中转渠道等帖子下面,可根据帖子内容进行以下回复策略:

通用回复:推荐使用中转 API,个人在用,稳定价格优惠,需要可推荐等内容。
同行推广帖下回复:本人有满血 API,价格厚道,可测试等内容。
3.2 群聊

加入与 Claude Code 相关的群聊,关注群聊天信息,遇到有交流中转或者账号问题的均可适当介绍业务,观察群内是否允许打广告,如打广告被踢概率大建议私信介绍,直接介绍优势:价格、稳定、售后无忧等内容。

1
通过帖子加入群聊
通过帖子加入群聊
图 3-1:通过帖子加入群聊
2
通过搜索加入群聊
可以搜索 Claude Code、Claude 中转等关键词加入群聊
通过搜索加入群聊
图 3-2:通过搜索加入群聊
4
QQ 获客方法
私域沉淀与客户运营 | QQ 群 + 好友 + 空间 + 频道
4.1 前期准备

1. 注册 QQ 账号

  • 使用手机号注册 QQ 账号,建议使用实名认证,提升账号权重。
  • 账号昵称、头像、签名等信息设置成与业务相关的形象,提高可信度。

2. 准备引流工具

  • 准备好话术、宣传海报、小程序、文档等引流素材。
  • 话术需要准备好多套,用于 QQ 获客话术、私聊引导话术、进群话术、群发话术等。
QQ 获客界面
图 4-1:QQ 获客 — 前期引流素材和话术
QQ 群运营
图 4-2:QQ 获客 — 搜索群聊
4.2 加群获客

1. 搜索目标 QQ 群

  • 在 QQ 群搜索栏中输入与业务相关的关键词,如"副业交流"、"创业"、"兼职"、"宝妈"等。
  • 选择群人数在 100-500 的活跃群,避免进入广告群或僵尸群。

2. 加入 QQ 群

  • 加群时,验证信息写得真实自然,例如:"朋友推荐加入"、"同行交流学习"等。
  • 进群后不要立即发广告,先观察群内氛围,了解群规和管理员风格。

3. 群内互动获客

  • 主动帮助:在群内主动回答问题,树立专业形象,吸引他人私聊你。
  • 分享资料:提供有价值的免费资料或工具,在分享中自然植入引流信息。
  • 举办活动:在群内发起抽奖、打卡、免费课程等活动,吸引用户关注。
  • 私聊跟进:对感兴趣的用户主动私聊,提供更详细的介绍或服务。
4.3 主动加好友

1. 精准添加好友

  • 根据目标客户的特征,通过 QQ 群成员列表、空间访客、评论等渠道,筛选潜在客户。
  • 添加好友时,验证信息写得真诚,例如:"看到您在 XX 群,想交流学习"等。

2. 好友话术

  • 加好友通过后,第一时间发送打招呼话术,简短介绍自己和业务。
  • 不要一上来就推销产品,先建立信任,再逐步引导。
4.4 QQ 空间运营

1. 打造个人 IP

  • QQ 空间是展示个人形象和业务的重要阵地,定期发布高质量的动态内容。
  • 内容类型包括:成功案例、客户反馈、行业干货、生活分享等,塑造专业且真实的人设。

2. 互动引流

  • 在 QQ 空间的评论区积极互动,回复用户的疑问和评论,增加曝光度。
  • 利用 @ 功能、点赞功能等,增加与潜在客户的互动机会。
4.5 QQ 频道获客

1. 加入目标频道

  • 在 QQ 频道中搜索与业务相关的频道,如"创业"、"副业"、"电商"等。
  • 进入频道后,积极参与讨论,分享有价值的内容,树立专业形象。

2. 创建自己的频道

  • 如果条件允许,可以创建自己的 QQ 频道,定期举办直播、分享会等活动,吸引目标客户关注。
  • 在频道内设置引流入口,如公告栏、置顶消息等,引导用户添加好友或进入社群。
4.6 注意事项
遵守平台规则:严格遵守 QQ 平台的使用规则,避免频繁加人、群发广告等行为,防止账号被封。
保持活跃:保持账号的日常活跃度,定期更新空间动态,参与群聊和频道互动。
注重质量:获客的核心是提供价值,不要只追求数量,要注重客户的精准度和转化率。
📋
数据记录:建立客户档案,记录每位潜在客户的来源、需求和跟进状态,方便后续维护和转化。
5
闲鱼交付文档模板
如何零门槛使用高质量 Claude API(StarAPI 平台) | 标准化交付全流程
5.1 完成主站账号注册
1
点击下方链接进入主站
https://starapi.net
2
用邮箱快速完成注册并登录
5.2 兑换码充值
StarAPI 平台主页
图 5-1:StarAPI 主站 — 访问 starapi.net 并使用邮箱完成账号注册
1
完成登录之后,点击进入左侧的"钱包管理→输入兑换码"选项
2
在下方输入在闲鱼上拿到的兑换码,并点击确认兑换
3
兑换完成后即可看到可用余额
兑换码充值界面
图 5-2:钱包充值 — 点击左侧"钱包管理→输入兑换码",填写兑换码并确认,余额即时到账
5.3 创建 API 密钥
1
确认余额到账之后,点击进入左侧的"令牌管理"选项
2
点击左上角的"添加令牌"
3
根据自己的使用需求完成对应的 API 密钥设定
分组选择说明:
- 常规使用就用推荐 default 分组
- 如果要兼顾性价比就选择 经济 分组
4
设定完成后选择"提交"
令牌管理界面
图 5-3:令牌管理 — 点击"添加令牌",设定 API 密钥并选择分组(default / 经济)
5.4 如何使用密钥
1
完成 API 密钥创建之后,点击密钥右方的"复制"图标
2
根据你的操作系统选择对应的命令行指令,并且在本地运行
3
之后就能开始享受稳定、优质的 Claude API 服务了
Claude Code 客户端配置
图 5-4:本地配置 — 在终端运行 export ANTHROPIC_API_KEY=sk-... 即可调用 Claude API
如果你之前没有用过 Claude Code,也可以选择"装客户端",从零开始配置 Claude Code。
支付建议:https://pay.starapi.net/pay(支付记录会自动同步)