# Claude Code (/docs/cookbook/coding-agents/claude-code)











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

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

## 你将完成 [#你将完成]

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

## 前提 [#前提]

开始前逐项确认：

* **一个 Praxis API Key**（`sk-praxis-` 开头）。没有就到 [控制台 → API Keys](https://console.deepraxis.ai/keys) 创建：点「创建 Key」，弹窗中**名称必填**，有效期默认 90 天（可改永久），点创建后立即复制保存；之后也随时可在 Key 列表行点「复制」重新获取完整 Key。新账号自带 **$1 免费额度**。完整流程见[快速开始](/docs/cloud/services/model/quickstart)。
* **Node.js 18 或更高**。终端运行 `node --version` 检查；没有就到 [nodejs.org](https://nodejs.org) 装 LTS 版。
* **安装 Claude Code**：

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

  期望：`claude --version` 输出版本号（本页以 2.1.211 为准）。

## 配置 [#配置]

**第 1 步：写入配置文件**

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

```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`——后者是官方直连时用的，配网关时无效。

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

<img alt="终端里查看 ~/.claude/settings.json 的实际内容" src="__img0" />

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

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

```bash
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` 的上下文口吻，属正常。

## 验证 [#验证]

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

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

<img alt="终端运行 claude -p 的真实输出" src="__img1" />

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

<img alt="claude 交互模式欢迎屏" src="__img2" />

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

```bash
export PRAXIS_API_KEY=sk-praxis-你的Key
```

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

```bash
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` 块，属正常。

最后看一眼 [控制台 → 用量与费用](https://console.deepraxis.ai/usage)：刚才的调用已经记在账上——每一次调用都有账、可追溯。

<img alt="控制台用量与费用页：deepseek-flash 的调用已逐笔记账" src="__img3" />

## 常见问题 [#常见问题]

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

官方安装脚本：

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

## 进阶 [#进阶]

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

## 相关食谱 [#相关食谱]

* [Codex](/docs/cookbook/coding-agents/codex) · [Cline](/docs/cookbook/coding-agents/cline) · [OpenCode](/docs/cookbook/coding-agents/opencode)
* 偏好图形界面？看 [Cherry Studio](/docs/cookbook/chat-clients/cherry-studio) · [Chatbox](/docs/cookbook/chat-clients/chatbox)