预计时间
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
确认你的电脑能跑 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 以上都行。v16.x.x原因： Node.js 版本太老（Claude Code 至少要 18）
解决： 去 nodejs.org 下载最新 LTS 版本覆盖安装。
2
安装 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 里
解决： 跑
偷懒办法：关闭重开所有终端窗口，90% 情况下能自动找到。
npm config get prefix 看 npm 全局目录，把里面的 bin/（macOS/Linux）或根目录（Windows）加进系统 PATH。偷懒办法：关闭重开所有终端窗口，90% 情况下能自动找到。
3
拿你的 LinksAPI 令牌
需要先有一把 sk- 开头的 LinksAPI API Key。如果还没创建：
- 登录 api.linksapi.cn/keys
- 右上角点 「+ 创建 API 密钥」
- 分组选 default（含 Claude 全系列），模型限制留空
- 创建后点令牌行的复制图标，sk- 开头那一长串就是你的 token
建议：给令牌起个有意义的名字（如
claude-code），方便后续在「API 密钥」页区分。4
配置环境变量（关键一步）
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。5
跑起来！
关闭并重新打开终端（这步必须！让上一步的环境变量生效），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 了。 试发一句：> 你好，请回复『连接成功』能收到回复就大功告成。6
日常使用 5 个核心命令
Claude Code 是自然语言交互，你可以直接说人话：
text
# 询问代码相关问题
> 这个项目用了什么框架？
# 让 Claude 修改代码（它会先 diff 给你看再问要不要执行）
> 给 src/api.ts 加上错误处理
# 跑命令并让 Claude 看结果
> 运行 npm test，根据失败的用例帮我修
# 创建新文件
> 写一个 Python 脚本，把 logs/ 目录下所有 .log 文件按日期归档
# 切换模型（临时）
> /model claude-opus-4-6会话内输入
/help 看所有快捷命令，/cost 看当前会话花了多少钱。7
模型怎么选 / 怎么省钱
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 价。8
常见报错速查
401 Unauthorized: Invalid token原因： ANTHROPIC_AUTH_TOKEN 没设对 / token 已禁用 / 字段名写错（Claude Code 用 AUTH_TOKEN 不是 API_KEY）
解决：
- 确认环境变量名是
ANTHROPIC_AUTH_TOKEN，不是ANTHROPIC_API_KEY - 跑
echo $ANTHROPIC_AUTH_TOKEN（Windows:echo %ANTHROPIC_AUTH_TOKEN%）看 token 是不是真的设进去了 - 登录 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。
该令牌无权访问模型 claude-sonnet-4-5原因： 令牌设了「模型限制」白名单且没包含 Claude
解决： 编辑令牌 → 「模型限制」开关关掉，或在白名单里加上
claude-sonnet-4-5 等。9
进阶：用 CC Switch 一键切换多家上游
如果你经常在多家 API 上游切换（比如 LinksAPI / 官方 / 别家中转）：
推荐使用 CC Switch — 官方 GUI 工具，一键切换 Claude Code 配置，不用每次手动改环境变量。详见 CC Switch 教程。
在 LinksAPI 控制台「API 密钥」页，每个令牌行都有「CC Switch」蓝色按钮，点一下就能一键导入到 CC Switch。
遇到本文档没覆盖的问题？联系客服微信 宇智波可乐 或 QQ 2981356048， 通常 10 分钟内回复。