把 KNA 接入 Claude Code

Claude Code 是 Anthropic 官方的命令行 / IDE AI 编码助手，由 Claude 驱动。GitHub: anthropics/claude-code

核心原理：Claude Code 通过环境变量 ANTHROPIC_BASE_URL 支持任意 Anthropic 兼容的端点。把 KNA 设为 base URL，所有 Claude 模型立刻可用，无需改一行代码、无需 VPN、无需 Anthropic 账号。

0TL;DR（60 秒版）

# 1. 安装 Claude Code（官方）
npm install -g @anthropic-ai/claude-code

# 2. 配置 KNA 端点（推荐写到 shell rc，每次自动加载）
export ANTHROPIC_BASE_URL=https://code.wearekna.com
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 3. 启动
cd your-project/
claude

第一次启动 Claude Code 会让你确认认证方式——选 Anthropic API（不是 OAuth 登录）。完成后即可正常用。

1前提条件

1.1 在 KNA 注册并拿 API Key

1. 打开 https://wearekna.com，点 立即注册
2. 邮箱注册（无需海外信用卡、无需手机号实名）
3. 登录 https://code.wearekna.com/dashboard
4. 左侧 API 密钥 → 创建 Key → 命名「claude-code」→ 复制以 sk- 开头的 token
5. 充值（最低 ¥10，赠送 20%；推荐先充 ¥30 验证完整工作流）

💡 ¥30 = 约 $5 余额 — 够你跑约 33 万 Sonnet input tokens 或 250 万 Haiku tokens，验证完整 Claude Code 工作流绰绰有余。

1.2 系统支持

需要 Node.js 18+（验证：node -v）。

2安装 Claude Code

2.1 用 npm 装（推荐）

npm install -g @anthropic-ai/claude-code
claude --version  # 应输出版本号

升级：npm update -g @anthropic-ai/claude-code

2.2 用 Homebrew 装（macOS）

brew install claude-code

2.3 用 native 安装脚本

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

3配置 KNA 三种方式

3.1 方式 A：环境变量（推荐）

把这两行加到 ~/.zshrc / ~/.bashrc：

export ANTHROPIC_BASE_URL=https://code.wearekna.com
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

source ~/.zshrc 重新加载。然后任意目录跑 claude 都生效。

⚠️ 环境变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY——后者会触发 Claude Code 走官方计费路径，KNA 的 key 会报 401。

3.2 方式 B：写到 Claude Code 配置文件

mkdir -p ~/.claude
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://code.wearekna.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
EOF

适合不想污染全局 env 的场景。

3.3 方式 C：项目级配置（多 key 切换）

在项目根目录创建 .claude/settings.local.json（被 gitignore）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://code.wearekna.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-this-project-uses-my-other-kna-key-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

适合给某些项目单独的 key 计费。

4验证 & 第一次运行

cd ~/some-test-project/
claude

第一次启动应看到：

1. 欢迎引导（确认信任目录）
2. 简洁的 TUI 命令行界面
3. 输入框提示

测试请求：

> 你好，请告诉我现在的日期

正常响应延迟约 1-2 秒首字节，输出逐字流式。如果看到 Error: 400 或卡 5+ 秒后一次性吐字，往下看 故障排查。

5推荐模型

KNA 已对接以下模型（实测可用）：

不推荐用旧模型 ID（如 claude-3-5-haiku-20241022）——KNA 没接对应的 key，会返回 upstream_error。

6故障排查

unset ANTHROPIC_API_KEY                              # 关掉错的
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxx...               # 用对的（67 字符）

curl -fsSL https://code.wearekna.com/kna-doctor.sh | bash

curl -sS https://code.wearekna.com/api/v1/billing/balance \
  -H "Authorization: Bearer sk-xxxxxxxxxx..."

7进阶用法

7.1 多 key 切换

如果你有多个 key（比如个人 + 公司项目），写一个简单的别名：

# ~/.zshrc
alias claude-personal='ANTHROPIC_AUTH_TOKEN=sk-personalkeyhexhexhexhexhexhexhexhexhexhexhexhexhexhexhexhex01 claude'
alias claude-work='ANTHROPIC_AUTH_TOKEN=sk-workkeyhexhexhexhexhexhexhexhexhexhexhexhexhexhexhexhexhex02 claude'

7.2 限制每会话 token 上限（防止跑飞）

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=8000  # 单次响应最大输出

7.3 关闭遥测（隐私）

export DISABLE_TELEMETRY=1
export DISABLE_ERROR_REPORTING=1

7.4 用 KNA 跑 Agent SDK / 自动化

如果你写 Python/Node 脚本调 Anthropic SDK，同样改 base URL：

Python (anthropic SDK)

from anthropic import Anthropic
client = Anthropic(
    base_url="https://code.wearekna.com",
    api_key="sk-xxxxxxxxxx..."
)

Node (anthropic SDK)

import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic({
  baseURL: 'https://code.wearekna.com',
  apiKey: 'sk-xxxxxxxxxx...'
});

7.5 用 KNA 跑 Cline / Aider / Continue 等 IDE 插件

只要插件支持自定义 Anthropic base URL，配置方法都一样：

• Base URL: https://code.wearekna.com
• API Key: sk-xxxxxxxxxx...

8性价比建议

KNA 用量目前按 Anthropic 官方价 1.5 折引流价结算（实付 15%），相比直接走 Anthropic API：

• 省事：不用海外信用卡、不用 VPN
• 价格：引流期 1.5 折（实付官方 15%），是 PackyCode 等同类的几分之一 — 限时，先充先享
• 服务：中文客服、按 ¥ 充值、跨境电商场景化支持

如果你日均用量 > 50 万 tokens，建议直接申请 Anthropic API 账号自购走原价；如果是日常 < 10 万 tokens，KNA 是更划算的选择。