跳到主要内容

Claude Code

Claude Code 接入 菜ai 教程

Claude Code 是 Anthropic 官方出品的终端智能编码工具，可以通过自然语言命令直接在命令行中帮你完成代码生成、读取本地文件、调试和重构等任务。

通过接入 菜ai ，修改环境变量，您可以将 Claude Code 的默认官方接口替换为 菜ai，从而享受更稳定、高性价比的 API 服务。

一、接入前准备​

开始前，请先准备好以下 2 个核心配置信息。请登录 菜ai 控制台获取你的专属密钥：

配置项推荐填写内容注意事项
API Keysk-xxxxxxxxxxxxxxxx填写控制台 Key
Base URLhttps://cloud.ai.liandxu.cn不要 /v1 后缀

二、安装 Claude Code​

请确保你的电脑已安装 Node.js (18 或更高版本)。打开终端（Windows 用户请务必使用 PowerShell），你可以先运行 node --version检查当前环境。

node --version

然后依次运行以下命令：​

1. 基础安装​

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

2. 升级为原生安装包（极其重要）​

Claude Code 官方目前已切换为 Native 安装模式。为了避免后续报错，请在基础安装完成后，紧接着运行以下命令：

claude install
  • 提示：安装成功后，系统会绿色字体提示 Claude Code successfully installed!。

三、Windows 用户专属避坑指南​

Windows 系统的严格安全策略通常会拦截 Claude Code 的运行。如果你是 Windows 用户，请务必在配置前执行以下操作（Mac/Linux 用户可直接跳过此步）：

1. 解除脚本运行限制​

在 PowerShell 中运行以下命令。如果系统提示是否更改执行策略，请输入 Y 并回车确认：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 防坑说明：如果不执行此步，运行 claude 时会报红字错误，在此系统上禁止运行脚本。

2. 解决“无法识别 claude”报错​

如果你输入claude提示找不到命令，说明安装路径没有自动加入环境变量。

  • 按 Win 键搜索“环境变量”，将 C:\Users\你的用户名\.local\bin 路径添加到当前用户的 Path 变量中，然后重启 PowerShell。

四、配置 菜ai 并启动​

Claude Code 严格依赖环境变量来识别自定义代理。请务必确保设置变量和运行命令在同一个终端窗口中进行。

方式一：临时配置（推荐首次测试使用）​

打开终端（Windows 需打开 PowerShell），按顺序逐行粘贴以下代码并回车：

Windows (PowerShell):

$env:ANTHROPIC_AUTH_TOKEN="sk-你的菜ai密钥"
$env:ANTHROPIC_BASE_URL="https://cloud.ai.liandxu.cn
claude

macOS / Linux:

export ANTHROPIC_AUTH_TOKEN="sk-你的菜ai密钥"
export ANTHROPIC_BASE_URL=https://cloud.ai.liandxu.cn
claude

方式二：长期配置（永久生效，推荐）​

如果你希望以后每次打开终端直接输入 claude 就能用，无需每次敲代码设置变量，请配置系统的全局环境变量：

  • Windows: 在系统"环境变量" -> "用户变量"中，新建两个变量：变量名 ANTHROPIC_AUTH_TOKEN 对应你的 Key；变量名 ANTHROPIC_BASE_URL 对应 https://cloud.ai.liandxu.cn ，配置后重启终端

  • Mac/Linux: 将 export 语句写入你的~/.zshrc或 ~/.bashrc 文件中，并执行 source ~/.zshrc。

五、如何测试是否成功？​

当你在设置了环境变量的终端中输入 claude 并回车后：

  1. 系统不会再提示红色的 Not logged in · Please run /login。

  2. 你将直接进入带有 > 提示符的交互界面。

  3. 输入一个简单的测试问题，例如：请帮我用 Python 写一个 Hello World。

  4. 如果 Claude 能够正常输出代码，恭喜你，菜ai 接入彻底成功！

六、常见问题 (FAQ)​

Q1：报错信息：Your credit balance is too low to access the Anthropic API.

  1. 可能菜ai 账号没有余额了：你填入的这个 sk-... 的 Key，里面对应的 Token 额度可能已经耗尽了，充值即可。

  2. 如果菜ai 账号有余额，那么可以尝试换分组或者换模型。

  • 换分组：在控制台token页面点击编辑，切换令牌分组，然后提交即可。
  • 换模型：在claudecode界面输入 ：
/model gpt5.4
  • （可以把gpt5.4换成控制台里面支持的海量模型）

Q2：为什么还是提示 Not logged in / Please run /login？

  • 检查变量名是否是 ANTHROPIC_AUTH_TOKEN。

  • 最常见原因：环境变量是单窗口生效的。你可能在窗口 A 设置了变量，却在新开的窗口 B 运行了 Claude。请务必在同一个窗口内操作。

Q3：Base URL 加不加 /v1？

Q4：不小心输入了 /login 怎么办？

  • /login 是用来登录 Anthropic 官方账号的。如果你接入的是 菜ai，请不要使用此命令。如果不小心进入了登录界面，一直按 Esc 键退出即可，系统会自动退回并读取你的环境变量。