LinksAPI
免费开始
返回文档首页

AI 编程工具 · Anthropic 官方

Claude Code 配置教程

Anthropic 官方推出的终端 AI 编程助手。本教程从安装到第一句对话，全程命令对照，小白也能 3 分钟跑通。

预计时间
3-5 分钟
难度
⭐ 入门
前置要求
Node.js 18+ · 终端基础

📌 30 秒速查（给资深用户）

已经装好 Claude Code？直接设这 3 个环境变量即可，Base URL 不带 /v1：

bash
export ANTHROPIC_BASE_URL="https://linksapi.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的_LinksAPI_令牌"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

完整教程往下看 ↓

1

注册并登录 LinksAPI

打开 api.linksapi.cn， 右上角点「登录」。没有账号就点「注册」，也可以用 GitHub / Google 一键登录。

看到这个就对了
新注册即送 $0.60 体验额度，够把本教程整篇跑通，不用先充值。
2

先搞清楚「分组」——90% 的接入失败都卡在这里

LinksAPI 把同一个模型放在不同分组里。分组决定三件事：能调哪些模型、价格倍率、线路来源与稳定性。

不要选 default 分组。default 里只有阿里云的生图 / 生视频模型（qwen-image、wan2.7 等），一个 Claude 模型都没有。选它跑 Claude Code，一定报「无可用渠道」。

用 Claude Code 的话，按下面挑一个：

分组适合
Claude-最低特价（性价比首选）首选，日常开发够用，价格最划算
Claude Kiro模型覆盖最全
CCMAXCCMAX 官方订阅线路
claudecode-企业专用企业对接，稳定性优先
直连claude来源最干净、模型最全，但倍率最高，预算充足再选
各分组的实时倍率和模型清单，在模型广场可按分组筛选查看；建密钥时的下拉框里也会标出倍率。
3

创建并复制 API 密钥

左侧菜单进「API 密钥」（或直接打开api.linksapi.cn/keys）， 点右上角 「+ 创建 API 密钥」，按下表填：

字段填什么
名称填 claude-code，方便以后区分
分组按上一步选，千万别留 default
额度留空 = 不限，走账户余额
过期时间留空 = 永不过期
模型限制留空，留空才能调该分组下全部模型
IP 白名单留空。家宽 IP 会变，填了容易把自己挡在外面

提交后在列表里点复制图标，拿到 sk- 开头的密钥。

密钥格式是 sk- 加 48 位字符，一共 51 个字符。 通过微信、邮件传这串时容易被折行截断 —— 这是「401 密钥无效」最常见的原因。
密钥等于你的钱包：不要发到群里，不要提交进 Git 仓库。
4

确认你的电脑能跑 Claude Code

Claude Code 是 Anthropic 官方的终端命令行工具，对环境的要求很简单：

  • Node.js 18+（必须）
  • npm 9+（跟着 Node.js 一起装）
  • Windows 10/11 / macOS / Linux 都可以

不知道有没有装？在终端跑：

bash
node --version
看到这个就对了
看到类似 v20.10.0 这样的输出就 OK。如果显示 v18.x 以上都行。
command not found: node
原因： 没装 Node.js
解决： 到 nodejs.org 下 LTS 版本一键装。装完关闭并重开终端再跑一次。
v16.x.x
原因： Node.js 版本太老（Claude Code 至少要 18）
解决： 去 nodejs.org 下载最新 LTS 版本覆盖安装。
5

安装 Claude Code

装好 Node.js 后，一行命令搞定：

bash
npm install -g @anthropic-ai/claude-code
提示：Windows 用户如果报权限错误（EACCES），用管理员身份运行 PowerShell 再装； macOS / Linux 用户可能需要 sudo npm install -g ...。

装好后验证：

bash
claude --version
看到这个就对了
看到类似 2.1.104 (Claude Code) 就装好了。
command not found: claude
原因： npm 全局路径不在 PATH 里
解决： 跑 npm config get prefix 看 npm 全局目录，把里面的 bin/（macOS/Linux）或根目录（Windows）加进系统 PATH。
偷懒办法：关闭重开所有终端窗口，90% 情况下能自动找到。
6

配置环境变量（关键一步）

Claude Code 通过 3 个环境变量读取 LinksAPI 配置：

  • ANTHROPIC_BASE_URL — LinksAPI 网关地址
  • ANTHROPIC_AUTH_TOKEN — 你的 sk- 令牌
  • ANTHROPIC_MODEL — 默认用的模型
⚠️ 最常见的坑：ANTHROPIC_BASE_URL 是 https://linksapi.cn（不带 /v1）。 Claude Code 内部会自动拼 /v1/messages，你再加一遍 /v1 会变成 /v1/v1/messages → 404。 90% 的「接入失败」都因为这个。

在 ~/.zshrc（zsh，macOS 默认）或 ~/.bashrc（bash）末尾追加：

bash
export ANTHROPIC_BASE_URL="https://linksapi.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的_LinksAPI_令牌"
export ANTHROPIC_MODEL="claude-sonnet-4-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"

保存后让配置生效：

bash
source ~/.zshrc   # bash 用户改成 source ~/.bashrc
什么是 ANTHROPIC_SMALL_FAST_MODEL？Claude Code 在做一些轻量任务（标题、Tab 补全、文件搜索）时会用这个快速模型，省钱省时间。 推荐填 claude-haiku-4-5。
7

跑起来！

关闭并重新打开终端（这步必须！让上一步的环境变量生效），cd 到你的项目目录，然后：

bash
cd 你的项目目录
claude

首次启动会要求确认权限策略（让 Claude 读文件 / 写文件 / 跑命令的权限），按提示选择：

终端 — 你应该看到
Welcome to Claude Code! ✨

I'll help you code, answer questions about your codebase,
and run commands for you.

Choose your approval policy:
> 1. on-request (推荐：每次都问你)
  2. on-failure (失败时才问)
  3. never (全自动，谨慎使用)

[ Enter to confirm ]

选 1 (on-request) 最安全，每次 Claude 要动你的文件都会先问你。

看到这个就对了
看到提示符 > 出现就代表已经连上 LinksAPI 了。 试发一句：> 你好，请回复『连接成功』能收到回复就大功告成。
8

日常使用 5 个核心命令

Claude Code 是自然语言交互，你可以直接说人话：

text
# 询问代码相关问题
> 这个项目用了什么框架？

# 让 Claude 修改代码（它会先 diff 给你看再问要不要执行）
> 给 src/api.ts 加上错误处理

# 跑命令并让 Claude 看结果
> 运行 npm test，根据失败的用例帮我修

# 创建新文件
> 写一个 Python 脚本，把 logs/ 目录下所有 .log 文件按日期归档

# 切换模型（临时）
> /model claude-opus-4-6
会话内输入 /help 看所有快捷命令，/cost 看当前会话花了多少钱。
9

模型怎么选 / 怎么省钱

LinksAPI 上 Claude 系列可用模型与售价（每 1M tokens）：

模型 ID速度质量售价 输入/输出什么时候用
claude-haiku-4-5⚡⚡⚡⭐⭐$1.4 / $7快速答疑、简单任务、SMALL_FAST_MODEL
claude-sonnet-4-5 ⭐⚡⚡⭐⭐⭐$4.2 / $21日常编程主力，性价比最佳
claude-opus-4-6⚡⭐⭐⭐⭐$7 / $35大型重构、跨文件分析、疑难 bug
省钱策略：把默认模型 ANTHROPIC_MODEL 设成 claude-sonnet-4-5，ANTHROPIC_SMALL_FAST_MODEL 设成 claude-haiku-4-5。 只有真遇到难题时手动输入 /model claude-opus-4-6 切到 Opus，干完活再切回去。 这样大部分调用都是 Sonnet 价。
10

常见报错速查

401 Unauthorized: Invalid token
原因： ANTHROPIC_AUTH_TOKEN 没设对 / token 已禁用 / 字段名写错（Claude Code 用 AUTH_TOKEN 不是 API_KEY）
解决：
  1. 确认环境变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY
  2. 跑 echo $ANTHROPIC_AUTH_TOKEN（Windows: echo %ANTHROPIC_AUTH_TOKEN%）看 token 是不是真的设进去了
  3. 登录 LinksAPI 控制台确认 token 状态是「已启用」
404 Not Found: /v1/v1/messages
原因： ANTHROPIC_BASE_URL 多加了 /v1
解决： 把 ANTHROPIC_BASE_URL 改成 https://linksapi.cn（不带 /v1），再重启终端。
503 No available channel for model claude-sonnet-4-5
原因： 你的令牌所在分组下没有 Claude 渠道
解决： 到 LinksAPI 控制台 → API 密钥 → 编辑该令牌 → 分组改成 default。
timeout / 连接超时
原因： 网络问题、本地代理冲突
解决： 用浏览器开 https://linksapi.cn 看能不能通。 开了系统代理的关一下试。还是不行联系客服微信「宇智波可乐」。
该令牌无权访问模型 claude-sonnet-4-5
原因： 令牌设了「模型限制」白名单且没包含 Claude
解决： 编辑令牌 → 「模型限制」开关关掉，或在白名单里加上 claude-sonnet-4-5 等。

配客户端之前，先用这条确认密钥和分组本身是通的：

bash
curl https://linksapi.cn/v1/chat/completions   -H "Authorization: Bearer sk-你的密钥"   -H "Content-Type: application/json"   -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

返回的 JSON 里带 choices 就说明密钥和分组没问题。这条不通，问题就不在客户端配置上，别再折腾配置文件了。

11

进阶：用 CC Switch 一键切换多家上游

如果你经常在多家 API 上游切换（比如 LinksAPI / 官方 / 别家中转）：

推荐使用 CC Switch — 官方 GUI 工具，一键切换 Claude Code 配置，不用每次手动改环境变量。详见 CC Switch 教程。

在 LinksAPI 控制台「API 密钥」页，每个令牌行都有「CC Switch」蓝色按钮，点一下就能一键导入到 CC Switch。
遇到本文档没覆盖的问题？联系客服微信 宇智波可乐 或 QQ 2981356048， 通常 10 分钟内回复。

还没注册？立即获取 API Key 开始使用

免费注册创建令牌