Claude Code

把 Praxis 接入 Claude Code，在终端里用你的 Key 驱动编程智能体——改代码、跑命令、答问题。

每一步都标了期望结果：照做即可，也可以把本页直接交给能操作电脑的 AI 助手，让它替你完成安装、配置与验证。

你将完成

在终端用 claude 命令调用 Praxis 的模型
完成标志：claude -p "…" 收到模型回复
预计耗时：3 分钟（不含 Node.js 安装）
支持协议：Anthropic 兼容（Claude Code 原生协议）

前提

开始前逐项确认：

一个 Praxis API Key（sk-praxis- 开头）。没有就到控制台 → API Keys 创建：点「创建 Key」，弹窗中名称必填，有效期默认 90 天（可改永久），点创建后立即复制保存；之后也随时可在 Key 列表行点「复制」重新获取完整 Key。新账号自带 $1 免费额度。完整流程见快速开始。
Node.js 18 或更高。终端运行 node --version 检查；没有就到 nodejs.org 装 LTS 版。
安装 Claude Code：
```
npm install -g @anthropic-ai/claude-code
```
期望：claude --version 输出版本号（本页以 2.1.211 为准）。

配置

第 1 步：写入配置文件

创建 ~/.claude/settings.json（Windows 原生版为 %USERPROFILE%\.claude\settings.json），填入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepraxis.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-praxis-你的Key"
  },
  "model": "deepseek-flash"
}

两处说明：

model 必须指定。Claude Code 默认请求的模型不在 Praxis 目录里，不指定会在首次对话时报「Model does not exist」。deepseek-flash 是平台示例模型——便宜、快、中英文都好；目录里的其他模型同样可填。
密钥写在 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY——后者是官方直连时用的，配网关时无效。

期望：文件保存即生效，无需重启任何服务。

终端里查看 ~/.claude/settings.json 的实际内容

第 2 步（可选）：临时会话不落盘

不想把 Key 写进文件时，可以用一次性环境变量：

ANTHROPIC_BASE_URL=https://api.deepraxis.ai/anthropic \
ANTHROPIC_AUTH_TOKEN=sk-praxis-你的Key \
claude --model deepseek-flash -p "你好"

期望：收到中文回复。Windows PowerShell 用户不必用此方式，直接按第 1 步写入配置文件即可。在代码项目目录里运行时，回复可能带上该项目 AGENTS.md / CLAUDE.md 的上下文口吻，属正常。

验证

claude -p "用中文回复四个字：连接成功"

期望：终端直接输出 连接成功——收到回复即接入成功。

终端运行 claude -p 的真实输出

去掉 -p 进入交互模式，就是完整的编程智能体工作台。首次启动会先让你选界面主题，选完即进入主界面：

claude 交互模式欢迎屏

也可以在命令行完成等价验证。先设置变量（不然照抄 curl 会得到 401）：

export PRAXIS_API_KEY=sk-praxis-你的Key

以下命令为 macOS / Linux / WSL（bash）写法。Windows PowerShell 用户：上面 claude -p 已收到回复即接入成功，可跳过；如需命令行验证，先执行 $env:PRAXIS_API_KEY="你的Key"，再把 curl 写成一行（去掉每行末尾的 \）。

curl https://api.deepraxis.ai/anthropic/v1/messages \
  -H "x-api-key: $PRAXIS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-flash", "max_tokens": 256, "messages": [{"role": "user", "content": "你好"}]}'

期望：HTTP 200 即接入成功。content 中 type 为 text 的块是回复文本——deepseek-flash 是推理模型，前面可能先带一段 thinking 块，属正常。

最后看一眼控制台 → 用量与费用：刚才的调用已经记在账上——每一次调用都有账、可追溯。

控制台用量与费用页：deepseek-flash 的调用已逐笔记账

常见问题

症状	原因	解法
首次对话报「issue with the selected model … may not exist」或 `Model … does not exist`	没有指定 `model`，Claude Code 用了它的默认模型，而它不在 Praxis 目录里	在 `settings.json` 加 `"model"`，或命令加 `--model`，填目录内的模型（如 `deepseek-flash`）
提示无效令牌 / 401	Key 复制不完整或已吊销；或把 Key 写进了 `ANTHROPIC_API_KEY`	重新完整复制（注意 `sk-praxis-` 前缀）；确认写在 `ANTHROPIC_AUTH_TOKEN`；仍失败到控制台重建一个
`Connection closed mid-response`	网络瞬断	直接重试一次即可
`npm install -g` 报权限错误	系统 npm 全局目录不可写	设用户级前缀重装，或改用官方脚本安装（命令见下）；两法细节见 npm 官方指南

官方安装脚本：

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

进阶

查这段对话花了多少钱：控制台 → 用量与费用，按次计费、无闲置费
换模型：改 settings.json 的 model（或临时用 --model）。要 Claude 系旗舰就填 claude-opus-5；要固定版本快照用 deepseek-v4-flash，deepseek-flash 则始终指向最新一代 Flash
在项目里用：进入代码目录直接运行 claude，它能读文件、改代码、执行命令——每一项动作都会先征求你的确认

Claude Code

你将完成

前提

配置

验证

常见问题

进阶

相关食谱

本页内容