跳转至

Claude Code 接入

Claude Code 是 Anthropic 官方推出的 CLI 编程助手，也是本平台 首选推荐 的 Agent 工具。它不是「终端里的聊天窗口」，而是可以进入本地项目、阅读代码、修改文件、运行命令的 AI Coding Agent。

接入方式：把 ANTHROPIC_BASE_URL 指向 LowCostAI、填入 Token，即可使用 Claude Sonnet / Opus——无需改动任何项目代码。

前置要求

  • macOS / Linux / Windows（推荐 WSL 或 Git Bash）
  • 有效的 LowCostAI API Key（前往创建）

第一步：安装 Claude Code

方式一：原生安装（官方推荐）

无需 Node.js，自动后台更新：

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

网络不畅可先设置代理再安装：

$env:https_proxy = "http://your-proxy:port"
irm https://claude.ai/install.ps1 | iex

方式二：npm 安装（备选）

需要 Node.js 18+（nodejs.org 下载 LTS 版，安装时一路下一步）：

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

# 国内网络下载慢可用镜像
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装

claude --version

Info

Windows 用户注意：

  • Claude Code 依赖 Git，请先安装 Git for Windows（安装时保持默认选项）；
  • 推荐在 WSL 或 Git Bash 中运行，兼容性最好；PowerShell 可能遇到文件锁定、写入失败等问题；
  • 推荐使用 Windows Terminal 替代自带的 cmd。

第二步：配置 Base URL 与 Token

Claude Code 需要两个环境变量来连接 LowCostAI：

变量 值
ANTHROPIC_BASE_URL https://api.lowcostaiapi.com
ANTHROPIC_AUTH_TOKEN 你的 API Key

编辑 ~/.zshrc（或 ~/.bashrc），添加：

export ANTHROPIC_BASE_URL="https://api.lowcostaiapi.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_TOKEN"

保存后重新加载：

source ~/.zshrc

设置永久环境变量：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.lowcostaiapi.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_TOKEN", "User")

设置后 重新打开终端 生效。

只在当前终端会话生效，适合先试一把：

export ANTHROPIC_BASE_URL="https://api.lowcostaiapi.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_TOKEN"
claude

验证配置：

echo $ANTHROPIC_BASE_URL
# 应输出：https://api.lowcostaiapi.com

第三步：开始使用

# 进入项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

首次在项目中启动时，Claude Code 会询问是否信任该目录：

Do you trust the files in this folder?

用方向键选择 Yes，回车确认即可。

试一个真实任务：

claude "阅读这个项目并总结它的结构"
claude "review 当前的 git diff"

切换模型

在 Claude Code 中用 /model 命令快速切换：

/model claude-sonnet-4-5    # Sonnet：日常 Coding（默认推荐）
/model claude-opus-4-5      # Opus：复杂任务、深度推理

模型 ID 以 模型列表 为准。

用好 Claude Code 的几个原则

核心原则：read first, plan second, edit third, verify last（先读、再计划、后改、最后验证）。

  • 把任务拆小：不要「自动接管整个项目」，一次让它做一件明确的事；
  • 控制上下文成本：会话越长消耗越多，任务完成后及时 /clear 或开新会话；
  • 按任务选模型：日常任务用 Sonnet，复杂重构再切 Opus；
  • 给团队 / 项目分别发 Key：消耗按 Key 记录，成本归因一目了然。

常见问题

提示 "API Key 无效" / 401

  • 确认 ANTHROPIC_AUTH_TOKEN 已正确设置，无多余空格；
  • 确认 Key 在 令牌管理 中为 启用 状态；
  • 用 echo $ANTHROPIC_AUTH_TOKEN 检查变量值。

环境变量设置后不生效

  • 确认改的是正确的配置文件（zsh 用 ~/.zshrc，bash 用 ~/.bashrc）；
  • 运行 source ~/.zshrc 重新加载，或完全重启终端；
  • Windows 用户设置后需重新打开终端窗口；
  • 注意：如果之前用 Claude 账号登录过，可运行 claude /logout 或检查 ~/.claude 配置，避免旧凭证覆盖环境变量。

安装时提示权限不足（npm 方式）

# 配置 npm 使用用户目录（推荐）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Windows 提示需要 git-bash

安装 Git for Windows 后，如仍提示找不到，设置：

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "Machine")

macOS 安全设置阻止运行

打开 系统设置 → 隐私与安全性，在「通用」中点击「仍要打开」。

相关阅读