WSL下Claude Code安装与国内免费使用
Claude Code是一个命令行界面,可将 Claude AI 直接带到您的终端。它是由 Anthropic 公司推出的一款智能编程工具,基于 Claude Sonnet 模型开发。这款工具最大的亮点是能够通过自然语言指令直接在终端操作,无需复杂的配置,就能完成代码编辑、Bug 修复、代码搜索等任务。它支持多种编程语言,包括 Java、Python、go 等,并且可以直接集成到 VS Code、Cursor 等开发环境中,让开发者体验更流畅.
https://www.anthropic.com/
关于 WSL
WSL (Windows Subsystem for Linux),微软开源的Linux on Windows框架,是 Microsoft 公司于 2016 年在 Windows 10 平台发布的一项功能,其使得用户可以在 Windows 操作系统上运行 ELF 格式的 Linux 可执行文件。
还没安装WSL的可以去看这个贴子(包括如何迁移WSL):https://blog.csdn.net/zhoumi_/article/details/149333491
安装前准备:WSL安装nvm和npm
npm 和 nvm 的区别

npm 和 nvm 是两个与 Node.js 相关但功能完全不同的工具,主要区别如下:
1. 核心功能不同
npm(Node Package Manager)是 Node.js 的包管理工具,用于管理 JavaScript 项目中的依赖包:
- 安装 / 卸载第三方库(如 npm install react)
- 管理项目依赖版本(通过 package.json)
- 运行项目脚本(如 npm run dev)
- 发布自己开发的包到 npm 仓库
简单说,npm 负责管理「代码包」,是 Node.js 生态中共享和复用代码的工具。
nvm(Node Version Manager)是 Node.js 版本管理工具,用于在同一台设备上管理多个 Node.js 版本:
- 安装不同版本的 Node.js(如 nvm install 18、nvm install 20)
- 切换当前使用的 Node.js 版本(如 nvm use 18)
- 卸载不需要的 Node.js 版本
简单说,nvm 负责管理「Node.js 本身的版本」,解决不同项目对 Node.js 版本依赖冲突的问题。
2. 依赖关系不同
- npm 是 Node.js 的内置工具,安装 Node.js 时会自动附带 npm(不同 Node 版本会对应特定版本的 npm)。
- nvm 是独立工具,与 Node.js 无依赖关系,通过 nvm 安装 Node.js 时,会自动安装对应版本的 npm。
WSL下载nvm(nodejs版本管理器)
# 下载并运行 nvm 安装脚本(官方脚本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装过程:
脚本通过 curl 下载并执行了 nvm 的安装程序,将 nvm 克隆到了 /root/.nvm 目录(因为你当前是 root 用户)。
配置自动加载:
安装程序自动将 nvm 的加载命令添加到了 /root/.bashrc 文件中,这样每次打开终端时,nvm 会自动生效。
立即生效命令:
输出中提供了手动加载 nvm 的命令(无需重启终端):
bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 加载 nvm 核心功能
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 加载命令补全
运行这几行命令后,nvm 就可以立即使用了。
验证 nvm 安装成功
bash
nvm --version # 输出 nvm 版本号,如 v0.39.7,说明安装成功
nvm ls # 列出所有已安装的 Node.js 版本,当前使用的版本会标有 "->"
WSL下安装npm(nodejs包管理工具)
sudo apt install npm
0 upgraded, 472 newly installed, 0 to remove and 1 not upgraded.
Need to get 86.6 MB of archives.
After this operation, 370 MB of additional disk space will be used.
Do you want to continue? [Y/n] y

# 查看全局安装的包列表,确认是否包含目标包
root@Desktop-CLF:/opt/claude# npm list -g @anthropic-ai/claude-code
/root/.nvm/versions/node/v24.7.0/lib
└── @anthropic-ai/claude-code@1.0.103
#查看 npm 全局安装路径:
root@Desktop-CLF:/opt/claude# npm config get prefix # 输出类似 /root/.npm-global 或 /usr/local
/root/.nvm/versions/node/v24.7.0
#检查该路径是否在 PATH 中
root@Desktop-CLF:/opt/claude# echo $PATH # 查看是否包含上述路径的 bin 目录(如 /root/.npm-global/bin)
/root/.nvm/versions/node/v24.7.0/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/snap/bin
一切OK
小技巧:安装 npm 代理 nrm
nrm(npm registry manager)是一个 npm 源管理工具,用于快速切换不同的 npm 镜像源(如 npm 官方源、淘宝源等),提高包安装速度。以下是安装和使用方法:
安装 nrm
首先确保已安装 Node.js(自带 npm),然后在终端执行以下命令全局安装 nrm:
bash
npm install -g nrm
(stock) root@Desktop-CLF:/opt/claude/mystocks_spec/web/frontend# nrm test
npm ---------- 861 ms
yarn --------- 849 ms
tencent ------ 1177 ms
cnpm --------- 263 ms (Fetch error, if this is your private registry, please ignore)
* taobao ------- 158 ms
npmMirror ---- 1139 ms (Fetch error, if this is your private registry, please ignore)
huawei ------- 437 ms
(stock) root@Desktop-CLF:/opt/claude/mystocks_spec/web/frontend# nrm use huawei
SUCCESS The registry has been changed to 'huawei'.
(stock) root@Desktop-CLF:/opt/claude/mystocks_spec/web/frontend# npm config get registry #查看设置是否生效
https://repo.huaweicloud.com/repository/npm/
WSL下安装nodejs
nvm install stable

WSL下安装官方 Claude Code
第一步 全局安装 Claude Code (官⽅)
npm install -g @anthropic-ai/claude-code

显示 “added 9 packages, and changed 3 packages”,这通常意味着安装过程已经成功完成,再用node --version检查即可。
PS:有位博主提出以下三种方式全局安装:原文链接:https://blog.csdn.net/zhoumi_/article/details/149333491
# 全局安装
npm install -g @anthropic-ai/claude-code
# 如遇权限问题
sudo npm install -g @anthropic-ai/claude-code
# 如遇平台识别问题
npm install -g @anthropic-ai/claude-code --force --no-os-check
第二步 配置中转API
首选方法(最快最具性价比,还可以免费试用):claude-code club
注册和试用网址: https://academy.claude-code.club/ )

国内其他:智谱 GLM Coding
🚀 速来拼好模,智谱 GLM Coding 超值订阅,邀你一起薅羊毛!Claude Code、Cline 等 10+ 大编程工具无缝支持,“码力”全开,越拼越爽!立即开拼,享限时惊喜价!
链接:https://www.bigmodel.cn/

Any Router是一个Claude Code免费共享平台,提供API中转服务 (目前好像不可用了)。

国内用户可以通过 AnyRouter 提供的 API 中转服务,轻松绕过网络和注册限制,实现免费使用。以下是具体步骤:
去这里:https://anyrouter.top/
进入到Any Router首页,我使用LinuxDO登录,这是个很有意思的BBS:https://linux.do/,但好象被墙了

登录后,你会自动进入数据看板,并免费获得 100 美元的初始额度。
目前 Claude Code 支持配置第三方 API KEY,国内支持 Kimi K2
和 GLM 4.5 等,如果中转 API 站点支持 OpenAI 的 completions 也是可以通过 ccr 的方式实现的,这里就不介绍了,主要介绍官方的方式。
Mac / Linux 用户
打开终端
创建 vim ~/.claude/settings.json 文件,内容如下:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",
"ANTHROPIC_BASE_URL": "https://aicodeditor.com",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"permissions": {
"allow": [],
"deny": []
}
}
Windows 用户
打开 git bash 终端
创建 vim ~/.claude/settings.json 文件,内容如下:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",
"ANTHROPIC_BASE_URL": "https://aicodeditor.com",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
},
"permissions": {
"allow": [],
"deny": []
}
}
注意:
AnyRouter的公告:
- [2025/07/27] 本站目前试验性开放邮箱登录,为防止滥用,当前仅允许 *.edu.cn 后缀邮箱注册,发送邮件可能有一定的延迟,也可能被识别为垃圾邮件,请注意检查
- 暂时停止来自 Github 账号的新用户注册;来自 Linux Do 账号的注册以及所有已注册用户的登录均不受影响。用户每日签到获赠额度提升至 $25。
- 记住API地址: ANTHROPIC_BASE_URL:https://anyrouter.top 是API 服务地址,与主站地址相同
添加API令牌:
进入“API 令牌”页面,点击“添加令牌”。
在名称栏填写易记的名称,例如“Claude Code Key”
在“模型限制”中选择 claude-sonnet-4-20250514,并勾选“设为无限额度”,其他保持默认设置即可。
点击“提交”,复制生成的 API Key,以备后续使用(以 sk- 开头,令牌后面要用)
{选择模型:/model, 默认的模型是Claude 4 Sonnet, 对于日常任务,推荐使用 Claude 4 Sonnet,费率仅为 Claude 4 Opus 的 1/5;对于有较复杂的任务,可以使用更强大的 Claude 4 Opus}

ccma - Claude Code Manager (墙裂推荐)
https://zoeblow.github.io/ccma/
https://github.com/zoeblow/ccma
一个强大的 CLI 工具,用于管理多个 Claude Code 配置和 API 端点。轻松在不同的 Claude Code 环境之间切换!
npm version License: MIT Node.js
✨ 特性
🔧 多配置管理 - 存储和管理多个 Claude Code 配置
🚀 快速切换 - 一键切换不同的 API 端点和认证令牌
🌍 跨平台支持 - 支持 Windows、macOS 和 Linux
💡 简单易用 - 直观的命令行界面
🔒 安全存储 - 本地安全存储敏感配置信息
⚡ 即时生效 - 配置更改立即生效,无需重启
npm install -g ccma
完整命令参考
| 命令 | 描述 | 示例 |
|---|---|---|
| ccma add |
添加新配置 | ccma add prod https://api.anthropic.com sk-xxx claude-3-5-sonnet |
| ccma del |
删除配置 | ccma del old-config |
| ccma use [name] | 切换配置 | ccma use production |
| ccma list / ccma ls | 列出所有配置 | ccma ls |
| ccma current | 显示当前配置 | ccma current |
| ccma clear | 清除所有配置 | ccma clear |
| ccma --version / ccma -V | 显示版本 | ccma -V |
| ccma --help / ccma -h | 显示帮助 | ccma -h |
但如果你想用其他的工具,可以参考我这篇文档:https://www.cnblogs.com/treasury-manager/p/19131789
可选安装python与git
以上均安装完成后,还有两个可选的安装,python与git
# 安装 Python 3 和 pip
sudo apt install python3 python3-pip
# 安装 Git
sudo apt install git
# 配置用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
测试安装是否成功
claude "Hello, Claude!"
claude /doctor
修改默认设置
claude config set -g model claude-sonnet-4
claude config set -g verbose true
claude config set -g outputFormat text
全局配置
设置全局配置
claude config set --global model claude-opus-3
claude config set --global max-tokens 4000
claude config set --global temperature 0.7
重置配置
claude config reset
查看所有配置
claude config list
配置环境变量(推荐)
为避免每次重复输入,可将环境变量写入 bash_profile 和 bashrc:
echo -e '\n export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.bash_profile
echo -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bash_profile
echo -e '\n export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.bashrc
echo -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.bashrc
echo -e '\n export ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.zshrc
echo -e '\n export ANTHROPIC_BASE_URL=https://anyrouter.top' >> ~/.zshrc
项目配置
# 在项目目录中设置
claude config set --project model claude-sonnet-3.5
claude config set --project ignore-patterns "*.log,temp/*"
# 查看项目配置
claude config list --project
# 继承全局配置
claude config inherit --global
#配置文件
Claude Code 的配置文件位置:
全局配置:~/.claude/config.json
项目配置:.claude/config.json
更详细的,可参考:https://ctok.ai/claude-code-complete-guide
重启终端后,在您的项目目录下运行:
cd your-project-folder
claude
即可使用 Claude Code
如果没有配置环境变量,则这样操作:
cd your-project-folder
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=https://anyrouter.top
claude
运行后
选择你喜欢的主题 + Enter
确认安全须知 + Enter
使用默认 Terminal 配置 + Enter
信任工作目录 + Enter
开始在终端里和你的 AI 编程搭档一起写代码吧!🚀
'CLAUDE_CODE_MAX_OUTPUT_TOKENS'配置
Steps to Reproduce
Create or update ~/.claude/settings.json with:
{
"env": {
"ANTHROPIC_CUSTOM_HEADERS": "anthropic-beta: interleaved-thinking-2025-05-14",
"MAX_THINKING_TOKENS": "100000",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000"
},
"model": "sonnet"
}
Launch Claude Code in interactive mode by executing claude
The following error is printed in terminal: ERROR Invalid env var CLAUDE_CODE_MAX_OUTPUT_TOKENS: 64000
Expected Behavior
The validation should respect model-specific token limits:
Haiku models: Allow up to 8,192 tokens
Sonnet models: Allow up to 64,000 tokens
Opus models: Allow up to 32,000 tokens
模型选择
/models
在 Sonnet 4.5 和 Haiku 4.5 之间选择
Claude Sonnet 4.5 和 Claude Haiku 4.5 都是功能强大的 Claude 4 模型,具有不同的优势:
选择 Claude Sonnet 4.5(最智能)用于:
复杂推理和分析:用于复杂任务的一流智能
长期运行的自主代理:在长时间独立工作的代理方面表现卓越
高级编码任务:我们最强的编码模型,具有高级规划和安全工程能力
大上下文工作流:通过内存工具和上下文编辑功能增强上下文管理
需要最大能力的任务:当智能和准确性是首要优先级时
选择 Claude Haiku 4.5(最快且最智能的 Haiku)用于:
实时应用:为交互式用户体验提供快速响应时间和接近前沿的性能
大容量智能处理:以提高的速度进行成本效益的大规模智能处理
成本敏感的部署:以较低的价格点提供接近前沿的性能
子代理架构:用于多代理系统的快速、智能代理
大规模计算机使用:成本效益的自主桌面和浏览器自动化
需要速度的任务:当低延迟至关重要同时保持接近前沿智能时
模型的有效性:
使用您计划使用的所有模型进行测试,技能作为模型的附加功能,因此有效性取决于底层模型。按模型的测试考虑:
Claude Haiku(快速、经济):技能是否提供了足够的指导?
Claude Sonnet(平衡):技能是否清晰高效?
Claude Opus(强大的推理):技能是否避免过度解释?
对 Opus 完美有效的东西可能需要为 Haiku 提供更多细节。如果您计划在多个模型中使用您的技能,请针对所有模型都能很好地工作的说明。
基础命令详解
# 在项目目录中启动
cd /path/to/your/project
claude
# 指定项目路径
claude --project /path/to/project
# 查看项目状态
claude /project-info
# 重置项目设置
claude /reset-project
1 启动命令
# 启动交互式会话
claude
# 运行一次性查询并退出
claude -p "你的问题或指令"
# 从文件输入内容
cat file | claude -p "处理这个文件"
# 跳过权限检查(谨慎使用)
claude --dangerously-skip-permissions
# 恢复上次对话
claude --continue
# 查看会话列表
claude --resume
2 会话管理命令
# 更新到最新版本
claude update
# 查看和修改配置设置
claude config
# 代理配置
claude /agents # 配置/设置子代理:cite[4]
3. 会话内命令
在Claude交互会话中,可以直接使用以下命令:
命令 功能 使用场景
/clear 清理会话历史 优化性能,释放内存
/compact 压缩会话数据 减少Token占用,控制成本
/config 查看或修改配置 调整工具行为(如API密钥)
/cost 查看Token使用情况 监控资源消耗
/help 查看帮助文档 新手入门首选
/init 初始化项目配置 新项目首次使用时
/memory 设置项目记忆 避免重复输入关键信息
/review 请求代码审查 提交前的质量检查
/bug 提交问题报告 遇到错误时反馈给Anthropic
/doctor 系统诊断检查 排查权限/网络问题
/terminal-setup 设置键绑定 改善多行输入体验
Think模式完全指南
Think 模式是Claude Code的一个强大功能,要求Claude对复杂问题进行更深入的分析。当面对复杂问题时,Claude会进入"思考"状态,进行更深入、更结构化的推理。
使用示例:
深入思考我们身份验证流程中的边缘情况
思考如何构建新的支付服务
Think模式的特点:
- 更深入的分析:Claude会多步推理,考虑各种可能性和边缘情况
- 结构化输出:思考结果通常以有条理的方式呈现
- 复杂问题解决:特别适用于架构设计、系统优化等复杂任务
Think模式最佳实践
- 根据问题复杂度选择:简单问题用think,复杂问题用ultrathink
- 成本考虑:Max套餐用户可以多用ultrathink,免费用户谨慎使用
- 时间权衡:紧急任务用基础模式,深度分析用高级模式
记忆系统详解
Claude Code的记忆系统是其核心功能之一,允许AI在不同会话间保持上下文一致性。
使用/init命令,创建 CLAUDE.md 文件
CLAUDE.md 是Claude Code的核心配置文件,它会被自动读取并加入到上下文中。这个文件应该包含:
- 项目基础信息和架构说明
- 常用命令和构建脚本
- 代码规范和约定
- 测试指南
- 开发环境配置
- 其他必要的上下文信息
CLAUDE.md创建方法:
# 使用/init命令自动生成
claude
> /init
# 或者手动创建并填充内容
touch CLAUDE.md
CLAUDE.md文件位置
CLAUDE.md 文件可以放置在多个位置:
项目根目录:./CLAUDE.md(推荐,可提交到git)
项目本地:./CLAUDE.local.md(不提交到git)
全局配置:~/.claude/CLAUDE.md
父目录和子目录中也会被自动读取
/init主要是执行以下几条命令:


记忆管理命令
# 打开并编辑当前项目的持久记忆文件
/memory
这将打开 CLAUDE.md 文件,您可以在此添加或修改Claude的 "长期记忆" 内容。
MCP (Model Context Protocol) 集成
官方MCP介绍:https://docs.claude.com/zh-CN/docs/claude-code/mcp
https://github.com/hangwin/mcp-chrome/blob/master/README_zh.md
MCP基础概念
MCP(Model Context Protocol)是Anthropic推出的开源通信标准,让Claude Code可以:
📁 访问本地文件系统
🌐 连接各种API服务
🗄️ 操作数据库
🛠️ 集成开发工具
🔧 自动化任务
Claude Code 既是 MCP 服务器也是客户端。作为客户端,它可通过三种方式连接任意数量的 MCP 服务器:
• 项目配置中(在该目录运行 Claude Code 时可用)
• 全局配置中(所有项目可用)
• 提交到 .mcp.json 文件(任何在你代码库工作的成员都可用)。例如,你可以在 .mcp.json 添加 Puppeteer 和 Sentry 服务器,方便每位工程师开箱即用。
用 MCP 时,建议用 --mcp-debug 标志帮助排查配置问题。
MCP允许Claude与外部工具和数据源集成,极大地扩展了其功能:
MCP服务器管理
claude mcp # 启动 MCP 向导
claude mcp list # 列出MCP服务器
claude mcp add # 添加MCP服务器
claude mcp remove # 移除MCP服务器
手动配置 MCP
claude config set mcp.enabled true
常用 MCP 服务器
Chrome MCP Server
是一款基于 Chrome 插件的模型上下文协议 (MCP) 服务器,它将 Chrome 浏览器的功能无缝暴露给 Claude 等 AI 助手,实现复杂的浏览器自动化、深度内容分析和智能语义搜索。
与传统浏览器自动化工具(如 Playwright)有本质区别,Chrome MCP Server 直接利用我们日常使用的 Chrome 浏览器,完整保留我们的用户习惯、个性化配置及登录状态,使各类大语言模型或聊天机器人能够真正接管您的浏览器,成为日常工作中得心应手的智能助手。
其核心使命是:将 Chrome 浏览器转变为智能助手——通过 AI 接管浏览器操作,将其升级为功能强大的 AI 控制自动化工具,支持跨标签页上下文理解、内置向量数据库、截图功能、网络监控、交互操作、书签管理及浏览历史记录等 20 余种实用工具,且全部在本地运行,显著提升您的工作效率。

chrome-devtools-mcp
https://github.com/ChromeDevTools/chrome-devtools-mcp
方法一:打开WINDOWS 下的Chrome 并访问 chrome://extensions/,并打开右上角的 开发者模式
npm install -g mcp-chrome-bridge
参考:https://zhuanlan.zhihu.com/p/1945244696445182752
方法二:WSL也可以安装这个开源版:sudo apt install -y chromium-browser
现在我们要让Claude Code和Chrome MCP Server建立连接。这就像给AI和浏览器之间搭建一座桥梁。
配置方法一:使用命令行(推荐)
Claude Code提供了非常简便的MCP添加命令:
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
配置方法二:手动编辑配置文件
如果你喜欢手动控制,也可以直接编辑配置文件:
项目级配置文件位置:
# 在项目根目录创建或编辑
./.mcp.json
用户级配置文件位置:
# macOS/Linux
~/.claude/config.json
# Windows
%APPDATA%\Claude\config.json
配置文件内容:
{
"mcpServers": {
"chrome-mcp": {
"type": "http",
"url": "http://127.0.0.1:12306/mcp",
"description": "Chrome浏览器自动化控制服务"
}
}
}
puppeteer
npm install puppeteer --save
Puppeteer 是一个 JavaScript 库,它提供了一个高级 API 来通过 开发工具协议 或 WebDriver 双向 控制 Chrome 或 Firefox。Puppeteer 默认在无头(无可见 UI)模式下运行
https://pptr.nodejs.cn/
Google开源的Node.js工具库。它可以控制Chrome或Chromium浏览器进行自动化测试,网页爬取等操作。使用Puppeteer,你就可以让Chrome浏览器像机器人一样执行你的命令,包括点击、填写表单、截图、生成PDF等。Puppeteer还支持Headless模式,也就是无界面模式,这意味着你可以在后台运行,无需人工干预。同时,你还可以利用Chrome开发者工具进行调试和分析!
参考:https://zhuanlan.zhihu.com/p/624900686
添加Playwright支持
npx @playwright/mcp@latest
claude mcp add playwright npx '@playwright/mcp@latest'
数据库连接
# PostgreSQL
claude mcp add postgresql --connection-string "postgresql://user:pass@localhost:5432/db"
# MySQL
claude mcp add mysql --host localhost --user root --database mydb
# SQLite
claude mcp add sqlite --database-path ./data.db
#文件系统
# 本地文件系统
claude mcp add filesystem --root-path /path/to/project
# Git 仓库
claude mcp add git --repository-path /path/to/repo
#Web 服务
# REST API
claude mcp add rest-api --base-url https://api.example.com --auth-token your-token
# GraphQL
claude mcp add graphql --endpoint https://api.example.com/graphql
MySQL集成
#添加MySQL数据库连接(注意:如果 ` 号不行, 就换成 \ )
claude mcp add mcp_server_mysql npx @benborla29/mcp-server-mysql `
-e MYSQL_HOST="主机地址" `
-e MYSQL_PORT="端口" `
-e MYSQL_USER="用户名" `
-e MYSQL_PASS="密码" `
-e MYSQL_DB="数据库名" `
-e ALLOW_INSERT_OPERATION="true" `
-e ALLOW_UPDATE_OPERATION="true" `
-e ALLOW_DELETE_OPERATION="true"
推荐一个强大的免费 MCP 工具——context7:
https://context7.com/
https://github.com/upstash/context7
在 Claude Code 中进行导入:
claude mcp add-json -s user context7 '{ "command": "npx", "args": ["-y", "@upstash/context7-mcp"] }'
测试方法:
userMapper.selectOne 是怎么实现的?它返回了什么数据结构?请使用 context7
Deep Graph MCP集成
Deep Graph 是一款MCP(模块化协作程序),可为 Claude Code 提供用于理解完整代码库的高级工具。它为 Claude Code 新增了6款工具,使其能够以更高级的方式读取代码、执行语义搜索和节点搜索,极大增强Claude对项目整体上下文的理解能力。
安装方法:
claude mcp add "Deep-Graph-MCP" npx -- -y mcp-code-graph@latest YOUR_CODEGPT_API_KEY CODEGPT_ORG_ID CODEGPT_GRAPH_ID
添加一个浏览器自动化操作的 MCP 服务器:
https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer
一般添加方法如下:
claude mcp add puppeteer npx -- -y @modelcontextprotocol/server-puppeteer
更多:参考:10个必备MCP服务器
https://docs.claude.com/zh-CN/docs/claude-code/mcp#插件提供的-mcp-服务器
流行的 MCP 服务器
流行的 MCP 服务器
以下是一些您可以连接到 Claude Code 的常用 MCP 服务器:
使用第三方 MCP 服务器需自担风险 - Anthropic 尚未验证所有这些服务器的正确性或安全性。 确保您信任要安装的 MCP 服务器。 使用可能获取不受信任内容的 MCP 服务器时要特别小心,因为这些可能会使您面临提示注入风险。
Development & Testing Tools
Sentry
Monitor errors, debug production issuesCommand
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Socket
Security analysis for dependenciesCommand
claude mcp add --transport http socket https://mcp.socket.dev/
Hugging Face
Provides access to Hugging Face Hub information and Gradio AI ApplicationsCommand
claude mcp add --transport http hugging-face https://huggingface.co/mcp
Jam
Debug faster with AI agents that can access Jam recordings like video, console logs, network requests, and errorsCommand
claude mcp add --transport http jam https://mcp.jam.dev/mcp
Project Management & Documentation
Asana
Interact with your Asana workspace to keep projects on trackCommand
claude mcp add --transport sse asana https://mcp.asana.com/sse
Atlassian
Manage your Jira tickets and Confluence docsCommand
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse
ClickUp
Task management, project trackingCommand
claude mcp add --transport stdio clickup --env CLICKUP_API_KEY=YOUR_KEY --env CLICKUP_TEAM_ID=YOUR_ID -- npx -y @hauptsache.net/clickup-mcp
Intercom
Access real-time customer conversations, tickets, and user dataCommand
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
Linear
Integrate with Linear's issue tracking and project managementCommand
claude mcp add --transport http linear https://mcp.linear.app/mcp
Notion
Read docs, update pages, manage tasksCommand
claude mcp add --transport http notion https://mcp.notion.com/mcp
Box
Ask questions about your enterprise content, get insights from unstructured data, automate content workflowsCommand
claude mcp add --transport http box https://mcp.box.com/
Fireflies
Extract valuable insights from meeting transcripts and summariesCommand
claude mcp add --transport http fireflies https://api.fireflies.ai/mcp
Monday
Manage monday.com boards by creating items, updating columns, assigning owners, setting timelines, adding CRM activities, and writing summariesCommand
claude mcp add --transport sse monday https://mcp.monday.com/sse
Databases & Data Management
Airtable
Read/write records, manage bases and tablesCommand
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server
Daloopa
Supplies high quality fundamental financial data sourced from SEC Filings, investor presentationsCommand
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcp
HubSpot
Access and manage HubSpot CRM data by fetching contacts, companies, and deals, and creating and updating recordsCommand
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic
Payments & Commerce
PayPal
Integrate PayPal commerce capabilities, payment processing, transaction managementCommand
claude mcp add --transport http paypal https://mcp.paypal.com/mcp
Plaid
Analyze, troubleshoot, and optimize Plaid integrations. Banking data, financial account linkingCommand
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sse
Square
Use an agent to build on Square APIs. Payments, inventory, orders, and moreCommand
claude mcp add --transport sse square https://mcp.squareup.com/sse
Stripe
Payment processing, subscription management, and financial transactionsCommand
claude mcp add --transport http stripe https://mcp.stripe.com
Design & Media
Figma
Generate better code by bringing in full Figma contextVisit developers.figma.com for local server setup.Command
claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp
Cloudinary
Upload, manage, transform, and analyze your media assetsMultiple services available. See documentation for specific server URLs.
invideo
Build video creation capabilities into your applicationsCommand
claude mcp add --transport sse invideo https://mcp.invideo.io/sse
Canva
Browse, summarize, autofill, and even generate new Canva designs directly from ClaudeCommand
claude mcp add --transport http canva https://mcp.canva.com/mcp
Infrastructure & DevOps
Cloudflare
Build applications, analyze traffic, monitor performance, and manage security settings through CloudflareMultiple services available. See documentation for specific server URLs. Claude Code can use the Cloudflare CLI if installed.
Netlify
Create, deploy, and manage websites on Netlify. Control all aspects of your site from creating secrets to enforcing access controls to aggregating form submissionsCommand
claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp
Stytch
Configure and manage Stytch authentication services, redirect URLs, email templates, and workspace settingsCommand
claude mcp add --transport http stytch http://mcp.stytch.dev/mcp
Vercel
Vercel's official MCP server, allowing you to search and navigate documentation, manage projects and deployments, and analyze deployment logs—all in one placeCommand
claude mcp add --transport http vercel https://mcp.vercel.com/
Automation & Integration
Workato
Access any application, workflows or data via Workato, made accessible for AIMCP servers are programmatically generated
Zapier
Connect to nearly 8,000 apps through Zapier's automation platformGenerate a user-specific URL at mcp.zapier.com
高级使用技巧
常见的工作流程
https://docs.claude.com/en/docs/claude-code/common-workflows
Claude Code 没有强加特定的工作流程,让您可以灵活地按照自己的意愿使用它。在这种灵活性所提供的空间内,我们的用户社区中出现了几种有效使用 Claude Code 的成功模式:
A,探索、计划、编码、提交
这种多功能工作流程适合许多问题:
要求 Claude 读取相关文件、图像或 URL,提供通用指针(“读取处理日志记录的文件”)或特定文件名(“读取 logging.py”),但明确告诉它暂时不要编写任何代码。
这是工作流程中应考虑大量使用子代理的部分,尤其是对于复杂问题。告诉 Claude 使用子代理来验证细节或调查它可能遇到的特定问题,尤其是在对话或任务的早期,往往会保留上下文可用性,而不会在效率损失方面产生太大不利影响。
让克劳德制定一个如何解决特定问题的计划。我们建议使用“思考”一词来触发扩展思维模式,这为 Claude 提供了额外的计算时间来更彻底地评估替代方案。这些特定短语直接映射到系统中不断提高的思维预算水平:“思考”<“努力思考”<“努力思考”<“超思考”。每个级别都会逐渐分配更多的思考预算供 Claude 使用。
如果此步骤的结果看起来合理,您可以让 Claude 创建一个文档或带有其计划的 GitHub 问题,以便在实现(步骤 3)不是您想要的时可以重置到这个位置。
让 Claude 在代码中实现其解决方案。这也是要求它在实现解决方案片段时显式验证其解决方案的合理性的好地方。
要求 Claude 提交结果并创建一个拉取请求。如果相关,这也是让 Claude 更新任何自述文件或变更日志并解释它刚刚做了什么的好时机。
步骤 #1-#2 至关重要——没有它们,Claude 往往会直接开始编写解决方案。虽然有时这是你想要的,但要求 Claude 先研究和计划可以显着提高需要预先深入思考的问题的性能。
B.编写测试,提交;代码、迭代、提交
这是一个 Anthropic 最喜欢的工作流程,用于通过单元测试、集成测试或端到端测试轻松验证的更改。测试驱动开发 (TDD) 通过代理编码变得更加强大:
要求 Claude 根据预期的输入/输出对编写测试。明确你正在进行测试驱动开发的事实,这样它就可以避免创建模拟实现,即使是代码库中尚不存在的功能也是如此。
告诉 Claude 运行测试并确认它们失败。显式告诉它不要在此阶段编写任何实现代码通常很有帮助。
当你对测试感到满意时,请 Claude 提交测试。
让 Claude 编写通过测试的代码,指示它不要修改测试。告诉克劳德继续前进,直到所有测试都通过。Claude 通常需要几次迭代来编写代码、运行测试、调整代码并再次运行测试。
在此阶段,要求它与独立的子代理一起验证实现是否与测试过度拟合会有所帮助
一旦您对更改感到满意,请 Claude 提交代码。
当Claude有一个明确的目标可以迭代时,它的性能最好——可视化模拟、测试用例或其他类型的输出。通过提供测试等预期输出,Claude 可以进行更改、评估结果并逐步改进,直到成功。
C.编写代码、截图结果、迭代
与测试工作流程类似,您可以为 Claude 提供可视化目标:
给 Claude 一种截取浏览器屏幕截图的方法(例如,使用 Puppeteer MCP 服务器、iOS 模拟器 MCP 服务器,或手动将屏幕截图复制/粘贴到 Claude 中)。
通过复制/粘贴或拖放图像,或向 Claude 提供图像文件路径,为 Claude 提供视觉模拟。
让 Claude 在代码中实现设计,截取结果的屏幕截图,并迭代直到其结果与模拟匹配。
当你满意时,请 Claude Commit。
与人类一样,Claude 的输出往往会随着迭代而显着提高。虽然第一个版本可能不错,但经过 2-3 次迭代后,它通常看起来会好得多。为 Claude 提供查看其输出以获得最佳结果的工具。
双手互搏:一个 Claude 写代码,另一个 Claude 审查
这是一个简单高效的方法,类似多工程师协作,分开上下文有时更好:
用 Claude 写代码
用 /clear 或在另一个终端启动第二个 Claude
让第二个 Claude 审查第一个 Claude 的工作
再启动一个 Claude(或再次 /clear),读取代码和审查反馈
让这个 Claude 根据反馈修改代码
你也可以让一个 Claude 写测试,另一个写通过测试的代码。甚至可以让 Claude 实例间通过草稿本交流,指定谁写谁读。
这种分工往往比单 Claude 处理所有任务效果更好。
我写了另外一篇文章来记录这个用法:https://www.cnblogs.com/treasury-manager/p/19147588
Agent 子代理
子代理(Sub-agent):这些是各个领域的专家,比如“代码审查员”、“数据库专家”等。它们有自己的系统提示、独立的上下文记忆、甚至被授权使用不同的工具(比如读写文件、执行 shell 命令)。当总指挥把任务交给它时,它会“启动”并专注地完成这一项工作。
https://docs.claude.com/zh-CN/docs/claude-code/sub-agents
https://platform.iflow.cn/agents?type=agents
https://ctok.ai/claude-code-subagents-evolution (详细)
四大核心优势
- 上下文保护(Context Preservation)
每个子代理都在独立的上下文中运行,这意味着处理复杂任务时不会污染主对话。主线程可以保持专注于高层次的目标,而具体的实现细节由子代理在各自的"工作空间"中完成。 - 专业化能力(Specialized Expertise)
通过为特定领域定制详细的指令,子代理能够在其专长领域达到更高的成功率。比如,一个专门的"代码审查"子代理可以包含详细的代码规范检查清单。 - 可重用性(Reusability)
一旦创建,子代理可以在不同项目间复用,甚至可以与团队成员共享。这意味着团队可以逐步积累一个强大的AI工具库,实现工作流程的一致性。 - 灵活的权限管理(Flexible Permissions)
每个子代理可以配置不同的工具访问级别。例如,你可以让"数据分析"子代理访问文件系统和数据处理工具,而限制"代码格式化"子代理只能访问代码编辑工具。
Sub-agent 实现方式
在 Claude Code 中创建和使用子代理非常直观,它依赖于配置文件,而不是复杂的代码。主要有两种方式。
方式一:使用 /agents 命令(推荐)
最简单的方式,是在 Claude Code 的交互界面中,输入斜杠命令:
/agents
这会弹出一个管理菜单,你可以根据引导,可视化地创建新的子代理,定义它的能力,并管理它可以使用的工具。对于新手来说,这是最不容易出错的方式。
方式二:直接创建配置文件
子代理的本质,就是一个带有 YAML 头信息的 Markdown 文件。我们可以手动创建这些文件。
它们存放在两个地方:
项目级:.claude/agents/ (仅在当前项目生效,优先级更高)
用户级:~/.claude/agents/ (在你的所有项目中都可用)
一个子代理的配置文件结构如下:
---
name: your-sub-agent-name
description: 描述何时应该调用此子代理
tools: tool1, tool2, tool3 # 可选 - 如果省略则继承所有工具
model: sonnet # 可选 - 指定模型别名或 'inherit'
---
您的子代理的系统提示在这里。这可以是多个段落
并且应该清楚地定义子代理的角色、能力和解决
问题的方法。
包括具体的指令、最佳实践和子代理应该
遵循的任何约束。
这里是这个子代理的系统提示(System Prompt)。你可以详细地描述它的角色、能力、行事风格和所有必须遵守的规则。
写得越详细、越清晰,它被激活时表现得就越好。
让我们以前文提到的“数据分析”任务为例,创建一个专门的 echarts-expert 子代理。
首先,在你的项目根目录下创建文件 .claude/agents/echarts-expert.md:
mkdir -p .claude/agents
touch .claude/agents/echarts-expert.md
然后,编辑这个文件,写入以下内容:
name: echarts-expert
description: Echarts 可视化专家。当用户需要使用 JavaScript 和 Echarts 库创建图表时,应使用此代理。
tools: Read, Write
你是一位数据可视化专家,尤其精通 Apache Echarts 库。
你的任务是:
- 接收用户提供的数据或数据结构。
- 编写高质量、可直接运行的 Echarts JavaScript 代码。
- 确保代码遵循 Echarts 的最新最佳实践。
- 代码中必须包含清晰的注释,解释
option配置中的关键部分。 - 如果用户的数据不适合所选图表,要给出建议。
这样,一个“Echarts 专家”就被创造出来了。同理,你还可以创建一个 sql-expert。
1. code-reviewer
---
name: code-reviewer
description: 专门进行代码质量审查,检查代码规范、潜在bug和性能问题。使用时请主动调用。
tools: read_file, str_replace_editor, run_command
---
# 代码审查专家
你是一个经验丰富的代码审查专家,专注于:
1. **代码质量检查**
- 遵循项目的编码规范
- 识别潜在的bug和安全问题
- 提出性能优化建议
2. **最佳实践**
- 确保代码可读性和可维护性
- 检查错误处理是否完善
- 验证测试覆盖率
3. **审查流程**
- 首先理解代码的整体结构
- 逐个检查每个函数和模块
- 提供具体的改进建议
2. debugger
---
name: debugger
description: 专门处理错误、测试失败和异常行为的调试专家。遇到任何问题时主动使用。
tools: Read, Edit, Bash, Grep, Glob
---
# 调试专家
你是一个专精于根因分析的调试专家。被调用时的工作流程:
1. 捕获错误信息和堆栈跟踪
2. 识别复现步骤
3. 定位故障位置
4. 实施最小化修复
5. 验证解决方案有效性
调试过程:
- 分析错误信息和日志
- 检查最近的代码变更
- 形成并测试假设
- 添加策略性调试日志
- 检查变量状态
对于每个问题,需要提供:
- 根本原因解释
- 支持诊断的证据
- 具体的代码修复方案
- 测试方法
- 预防建议
专注于修复根本问题,而不仅仅是处理表面症状。
3. data-scientist
---
name: data-scientist
description: 数据分析专家,专精于SQL查询、BigQuery操作和数据洞察。处理数据分析任务和查询时主动使用。
tools: Bash, Read, Write
---
# 数据科学家
你是一个专精于SQL和BigQuery分析的数据科学家。被调用时的工作流程:
1. 理解数据分析需求
2. 编写高效的SQL查询
3. 适时使用BigQuery命令行工具(bq)
4. 分析并总结结果
5. 清晰地呈现发现
关键实践:
- 编写带有适当过滤条件的优化SQL查询
- 使用合适的聚合和连接操作
- 为复杂逻辑添加注释说明
- 格式化结果以提高可读性
- 提供数据驱动的建议
对于每项分析:
- 解释查询方法
- 记录所有假设
- 突出关键发现
- 基于数据提出后续步骤建议
始终确保查询高效且成本可控。
Claude Code 在收到更具体指令时成功率显著提升,尤其是首次尝试。明确指令能减少后续修正。
例如:

用 /clear 保持上下文聚焦
长会话中,Claude 的上下文窗口可能被无关对话、文件内容和命令填满,影响性能甚至分散注意力。每完成一个任务,建议用 /clear 重置上下文窗口。
给 Claude URL
在提示中粘贴具体 URL,Claude 会自动拉取和阅读。为避免同一域名反复请求权限(如 docs.foo.com),用 /permissions 添加域名到允许列表。
权限管理
Claude Code默认采用保守的权限策略。你可以通过以下方式管理权限:
# 使用/permissions命令管理权限
> /permissions
# 或者通过命令行参数
claude --allowedTools Edit,Bash(git commit:*)
用 Claude 操作 git
Claude 能高效处理许多 git 操作。许多 Anthropic 工程师 90% 以上的 git 操作都交给 Claude:
• 搜索 git 历史,回答“v1.2.3 包含了哪些更改?”、“谁负责这个功能?”、“这个 API 为什么这样设计?”等问题。建议明确让 Claude 查 git 历史。
• 编写提交信息。Claude 会自动查看你的更改和最近历史,生成包含所有相关上下文的提交信息。
• 处理复杂 git 操作,如回滚文件、解决 rebase 冲突、比较和移植补丁。
上下文管理策略
由于Claude Code的上下文窗口有限,且上下文过长会导致幻觉严重,需要合理管理上下文信息:
使用 @ 引用文件:请参考@PRD.MD 的结构
在任务切换时使用 /clear 清空上次任务信息
长时间会话定期压缩上下文:/compact
必要时从历史会话恢复:/resume
将重要信息通过 #
用清单和草稿本处理复杂工作流
对于多步骤或需穷举解决方案的大型任务(如代码迁移、修复大量 lint 错误、运行复杂构建脚本),建议让 Claude 用 Markdown 文件(甚至 GitHub issue)做清单和草稿本:
lint(代码检查)是指通过工具(称为 linter)对代码进行静态分析,检测潜在的语法错误、风格问题、不符合编码规范的写法、可能的逻辑漏洞等,而不实际执行代码的过程。简单来说,lint 问题 就是 linter 工具在检查代码时发现的 “不规范”“有风险” 或 “不符合约定” 的代码片段。
例如,修复大量 lint 问题时:
让 Claude 运行 lint 命令,将所有错误(含文件名和行号)写入 Markdown 清单
让 Claude 逐条处理,每修复并验证一个就勾选,再处理下一个
用 Claude 做 linter
工具:强自动修复:Prettier(格式问题)、Black(Python)、RuboCop(Ruby)—— 几乎能处理所有负责的问题类型。
Claude Code 可做主观代码审查,发现传统 linter 检查不到的问题,如拼写错误、过时注释、误导性函数或变量名等。
成本控制和提醒设置
# 查看token使用统计
/cost
# 设置使用提醒
claude config set --global preferredNotifChannel terminal_bell
#声音提示设置
启用任务完成时的声音提示:
claude config set --global preferredNotifChannel terminal_bell
安装塞尔达音效提示(任务完成时有特别提示):
npm install -g zelda-claude-code@latest
Mark:
- 自定义您的设置
Claude Code是一个智能体编程助手,会自动将上下文拉入提示中。这种上下文收集会消耗时间和令牌,但您可以通过环境调优来优化它。
a. 创建CLAUDE.md文件
CLAUDE.md 是Claude Code的核心配置文件,它会被自动读取并加入到上下文中。这个文件应该包含:
*项目基础信息和架构说明(核心文件)
*常用命令和构建脚本(如常用bash命令)
*代码规范和约定(实用函数,代码风格指南,代码库规范(例如,分支命名、合并与变基等),以及分支命名、合并与变基等)
*测试指南(测试说明)
*开发环境配置(例如,pyenv使用、哪些编译器有效)
*其他必要的上下文信息(项目特有的任何意外行为或警告,您希望Claude记住的其他信息)
CLAUDE.md文件没有要求的格式。建议保持简洁且人类可读。例如:
# Bash命令
- npm run build: 构建项目
- npm run typecheck: 运行类型检查器
# 代码风格
- 使用ES模块 (import/export) 语法,而不是CommonJS (require)
- 尽可能使用解构导入 (例如 import { foo } from 'bar')
# 工作流程
- 在完成一系列代码更改后务必进行类型检查
- 为了性能考虑,优先运行单个测试,而不是整个测试套件
您可以将CLAUDE.md文件放置在几个位置:
- 项目根目录:./CLAUDE.md(推荐,可提交到git)
- 项目本地:./CLAUDE.local.md(不提交到git)
- 全局配置:~/.claude/CLAUDE.md
- 父目录和子目录中也会被自动读取
代码库的根目录,或您运行claude的任何地方(最常见的用法)。将其命名为CLAUDE.md并将其检入git,这样您就可以在会话间和团队成员间共享(推荐),或将其命名为CLAUDE.local.md并将其添加到.gitignore中
您运行claude的目录的任何父目录。这对于monorepo最有用,您可能从root/foo运行claude,并在root/CLAUDE.md和root/foo/CLAUDE.md中都有CLAUDE.md文件。这两个文件都会自动拉入上下文
您运行claude的目录的任何子目录。这与上述相反,在这种情况下,当您处理子目录中的文件时,Claude会按需拉入CLAUDE.md文件
您的主文件夹(~/.claude/CLAUDE.md),这会将其应用到所有您的claude会话
当您运行/init命令时,Claude会自动为您生成一个CLAUDE.md文件。
b. 调优您的CLAUDE.md文件
您的CLAUDE.md文件会成为Claude提示的一部分,因此应该像任何经常使用的提示一样进行精心完善。一个常见的错误是添加大量内容而不迭代其有效性。请花时间实验并确定什么能产生模型最佳的指令遵循效果。
您可以手动向CLAUDE.md添加内容,或按#键给Claude一个指令,它会自动将其纳入相关的CLAUDE.md中。许多工程师在编码时频繁使用#来记录命令、文件和风格指南,然后在提交中包含CLAUDE.md的更改,以便团队成员也能受益。
在Anthropic,我们偶尔会通过提示词改进器运行CLAUDE.md文件,并经常调优指令(例如,添加"重要"或"您必须"的强调)以提高遵循度。
典型工作流程
探索阶段 - 了解现有代码
计划阶段 - 使用扩展思考
编码阶段 - 实现功能
提交阶段 - 代码审查与提交
测试驱动开发流程
# 1. 编写测试
"请基于期望的输入输出编写测试,确保测试会失败"
# 2. 运行测试确认失败
"运行测试确认失败,不要编写实现代码"
# 3. 提交测试
"请提交测试代码"
# 4. 实现功能
"请编写代码使测试通过,不要修改测试"
# 5. 提交实现
"请提交实现代码"
10.3 UI开发流程
# 1. 提供设计图
# 拖拽图片到Claude Code界面
# 2. 实现UI
"请按照设计图实现界面"
# 3. 截图对比
"请截图当前实现,与设计图对比并改进"
# 4. 迭代优化
"请继续优化,直到效果满意"
这个人的这篇文章讨论了Claude以下几个功能,可以学习一下,
一、核心开关 & 行为约束
二、并行调度与任务分片
三、长程任务“不断点”运行策略(自我复位 + 断点续跑)
四、质量闸口(构建/测试/验收定义)
五、权限与“自动批准”实践(减少打断)
六、组织你的仓库(方便 Agent 自管理)
https://zhuanlan.zhihu.com/p/1958944640314111356
https://zhuanlan.zhihu.com/p/1959040296479339345
https://zhuanlan.zhihu.com/p/1924586239664817970
❓FAQ
- AnyRouter直接接入官方 Claude Code 转发,无法转发非 Claude Code 的 API 流量
- 如遇 API 报错,可能是转发代理不稳定导致,可以考虑退出 Claude Code 重试几次
- 如果网页遇到登录错误可以尝试清除本站的 Cookie,重新登录
- Invalid API Key · Please run /login 怎么解决?这表明 Claude Code 没有检测到 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量,检查环境变量是否配好。
- 显示 offline 是什么原因?Claude Code 会通过检查是否能连接到 Google 来对网络进行判断。显示 offline 并不影响正常使用 Claude Code,只是表明 Claude Code 未能连接 Google。
- 为什么浏览网页的 Fetch 会失败?这是因为 Claude Code 在访问网页前会调用 Claude 的服务来判断网页是否可以访问。需要保持国际互联网连接并进行全局代理,才可以访问 Claude 判断网页是否可以访问的服务。
- 为什么请求总是显示 fetch failed?可能是因为所在地区的网络环境导致的,可以尝试使用代理工具或者使用备用 API 端点 ANTHROPIC_BASE_URL=https://pmpjfbhq.cn-nb1.rainapp.top
- 使用 Opus 模型时: 请将 CLAUDE_CODE_MAX_OUTPUT_TOKENS 设置为 32000,以确保最佳性能。
- 重启 Claude Code: 修改配置后,请重启 Claude Code 以使配置生效。
VS Code集成Claude code方法
打开VS Code 客户端在扩展商店里搜索WSL(注意该插件有些地区需要梯子才能安装),之后打开终端,新建 Ubuntu(WSL) 命令窗口

输入命令 claude
如果发现请求无效,ctrl+c退出先,执行下列命令(其中替换 sk-... 为您生成的 API 令牌)
# 设置api中转接入
export ANTHROPIC_BASE_URL="https://wolfai.top"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
claude
至此安装完毕!!!当你使用Claude code之前,需要先创建或打开项目目录!!!

验证您的安装,在打开Claude Code后输入以下命令将会为当前目录下的项目生成Claude.md
/init
AI聚合/中转平台
https://wolfai.top/
https://aicodeditor.com/
https://openrouter.ai/
https://www.moonshot.cn/
https://open.bigmodel.cn/
https://anyrouter.top
其他 Claude 教程
原文:https://www.anthropic.com/engineering/claude-code-best-practices
https://www.cnblogs.com/wzzkaifa/p/19079594
https://blog.csdn.net/weixin_52136627/article/details/149719262
购买claude code套餐
https://docs.bigmodel.cn/cn/coding-plan/tool/claude
🚀 速来拼好模,智谱 GLM Coding 超值订阅,邀你一起薅羊毛!Claude Code、Cline 等 10+ 大编程工具无缝支持,“码力”全开,越拼越爽!立即开拼,享限时惊喜价!
链接:https://www.bigmodel.cn/claude-code?ic=B6T4CVQPE2
若之前有配置过 Claude code 的环境变量,可按以下方式手动配置
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your Zhipu API key"
cd your-project-directory
claude

浙公网安备 33010602011771号