Claude Code 安装使用教程

Claude Code 是一个强大的 AI 编程助手，让您可以直接在终端中与 AI 协作编程。本教程将指导您完成安装和配置过程。

📋 系统要求

Node.js 版本 ≥ 18.0

支持的操作系统：macOS、Linux、Windows (WSL)

🚀 快速开始

1. 安装 Node.js

💡 提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Ubuntu / Debian 用户

macOS 用户

2. 安装 Claude Code

使用 npm 全局安装 Claude Code：

3. 配置并开始使用

获取必要的配置信息

您需要准备两个重要的配置项：

配置项	说明	获取方式
ANTHROPIC_AUTH_TOKEN	API 认证令牌	注册后在 `API令牌` 页面点击 `添加令牌` 获得（以 `sk-` 开头）
ANTHROPIC_BASE_URL	API 服务地址	使用 `https://wellapi.ai`

📝 创建令牌时的建议设置：
名称：随意命名
额度：设为无限额度
分组：选择Claude code专属或者官转克劳德3及以上
其他选项：保持默认设置

启动 Claude Code

在您的项目目录下运行：

Linux/Unix/MacOS系统：

Windows系统：

初次运行配置

启动后，您将看到以下配置步骤：

选择主题 → 选择您喜欢的主题 + 按 Enter

安全须知 → 确认安全须知 + 按 Enter

Terminal 配置 → 使用默认配置 + 按 Enter

工作目录信任 → 信任当前目录 + 按 Enter

✨ 恭喜！ 现在您可以开始与您的 AI 编程搭档一起写代码了！

通过直接修改claude配置的方式：

配置文件的方式

Windows系统找到claude code的配置文件settings.json，如果是Windows，路径在：C:\Users\Administrator.claude，其中Administrator是你的操作系统登录的用户名，如果你使用abc登录的，那么路径是：C:\Users\abc.claude。打开settings.json，把如下内容拷贝进去后重启Claude Code 即可：

注意看“ANTHROPIC_API_KEY”不要写错了，不是“ANTHROPIC_AUTH_TOKEN”，同时把你自己的API KEY填上。
如果是MacOS,找到对应的目录下的文件修改settings.json

❓ 常见问题解答

A: 这表明 Claude Code 未检测到环境变量。请检查：

是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL

环境变量值是否正确（令牌以 sk- 开头）

如果使用了永久配置，是否重启了终端

Q: 为什么显示 "offline" 状态？

A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。

Q: 为什么浏览网页的 Fetch 会失败？

A: Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：

保持稳定的国际互联网连接

必要时使用全局代理

Q: 请求总是显示 "fetch failed"？

A: 可能是网络环境导致的问题。解决方案：

尝试使用代理工具

Q: API 报错如何处理？

A: 可能是转发代理不稳定导致的，建议：

退出 Claude Code（Ctrl+C）

重新运行 claude 命令

如果问题持续，请稍后再试

Q: 网页登录错误？

A: 尝试清除本站的 Cookie，然后重新登录。

📌 注意事项

本站直接接入官方 Claude Code 转发服务

仅支持 Claude Code 的 API 流量，不支持其他 API 调用

请妥善保管您的 API 令牌，避免泄露

🔗 相关链接

Claude Code 官方文档

Node.js 官方网站

💡 提示：如遇到其他问题，请查看官方文档或联系技术支持。

📋 系统要求#

🚀 快速开始#

1. 安装 Node.js#

Ubuntu / Debian 用户#

macOS 用户#

2. 安装 Claude Code#

3. 配置并开始使用#

获取必要的配置信息#

启动 Claude Code#

Linux/Unix/MacOS系统：#

Windows系统：#

初次运行配置#

通过直接修改claude配置的方式：#

配置文件的方式#

❓ 常见问题解答#

Q: 遇到 "Invalid API Key · Please run /login" 错误？#

Q: 为什么显示 "offline" 状态？#

Q: 为什么浏览网页的 Fetch 会失败？#

Q: 请求总是显示 "fetch failed"？#

Q: API 报错如何处理？#

Q: 网页登录错误？#

📌 注意事项#

🔗 相关链接#