Claude 与 Claude Code

开始前准备

Claude 是模型系列，Claude Code 是本机编程工具。本教程使用 ASIORB API Key 和账户余额，先在独立测试文件夹中验证。

按顺序完成：安装 → 输入 Key → 选择模型 → 配置连接 → 文件实测 → 核对消费。ASIORB Key 不会开通 claude.ai 订阅，本教程从本站余额按模型用量扣费。

查询可用模型不产生模型推理费用；向 Claude Code 发送任务后会计费。先测试小文件，再进入自己的项目。

1. 安装 Claude Code

macOS 打开“终端”，使用默认 zsh；Windows 打开 PowerShell。选择下面对应的系统，从官方地址安装。

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

安装结束后重新打开一个终端窗口，再执行下面的检查。已有 Claude Code 时，可先跳过安装，直接查看版本。

claude --version

显示版本号表示安装成功，请记下版本，再继续第 2 步。提示找不到命令时，请先按下面的说明修复。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

macOS 需 13 或更高版本。Windows 的 Git for Windows用于提供 Bash 工具；当前官方版本未安装 Git 时可使用 PowerShell。WSL 需在 WSL 内按官方 Linux 说明安装，本页 Windows 示例请在 PowerShell 中执行。

安装方式核对于 2026-10-12。官方原生安装会自动更新，实际版本以本机为准；本页说明不代表每个版本和全部高级功能都已在本站实测。查看官方安装说明

2. 设置 Key，查询模型

创建专用于这台电脑的 Key，确认账户有可用余额，且 Key 允许使用要测试的 Claude 模型。

read -rs "ASIORB_API_KEY?请粘贴你的 ASIORB API Key，然后按回车（输入不显示）："

echo
export ASIORB_API_KEY
if [ -n "$ASIORB_API_KEY" ]; then
  printf '%s\n' 'Key 已设置，可以继续查询模型。'
else
  printf '%s\n' '没有输入 Key，请回到上一步重新输入。'
fi

curl --fail-with-body --max-time 30 "https://api.asiorb.com:8443/v1/models" \
  -H "Authorization: Bearer $ASIORB_API_KEY"

找到并复制一个完整的 anthropic/… 模型 ID。页面的模型下拉框用于生成示例，具体调用权限以你自己的 Key 查询结果为准。

3. 配置 ASIORB

在输入 Key 的同一个窗口继续操作。Claude Code 使用 Messages 接口，本页 Base URL 不带 /v1。

选择模型后，原样复制整段代码到普通终端执行，不需要修改代码中的任何文字。如果当前窗口还没有设置 Key，终端会停下来提示输入：这时再粘贴 Key 并按回车，输入时不显示字符。不要把 Key 填进代码中的中文提示，也不要发送到助手的对话框。

看到 “ASIORB 配置已设置，请继续第 4 步创建测试文件夹。” 后再继续；如果提示未输入 Key，请重新执行本步骤并按提示输入。这个提示表示参数已设置，真实连接还需完成后面的测试。

配置不会显示 Key，也不会将它保存到文件。初次测试把主会话和辅助任务固定到同一个模型，并关闭实验功能、工具搜索和显式缓存。这里的 sonnet、opus、haiku、fable 别名都会指向上面所选的同一个模型；更换型号请回到本步骤重新选择、配置并重启。

先确认费用：每次模型请求可能包含系统说明、工具定义、历史和工具返回内容；一个小任务也可能发起多次请求。本教程的兼容配置关闭了显式提示缓存，不能按缓存优惠价估算整段输入。先选适合预算的模型、使用新会话，并在消费记录核对第一项任务的实际费用。8192 是输出上限，不是整个任务的固定用量。已通过测试后无需反复重测。

如果已有 Claude 配置，settings.json 中的环境变量可能覆盖终端设置。下一步必须通过 /status 检查实际连接；不要删除已有登录资料。

4. 创建测试文件夹

下面的命令会新建独立测试文件夹，并创建包含三行数字的 test.txt，不需要准备已有项目。

ASIORB_TEST_DIR="$(mktemp -d "$HOME/asiorb-claude-test.XXXXXX")" &&
  cd "$ASIORB_TEST_DIR" &&
  printf '17\n28\n35\n' > test.txt &&
  pwd

python3 --version

记下文件夹路径。test.txt 中每行一个数字，内容为 17、28、35。Python 检查应显示 Python 3.x；Windows 如果使用启动器，可改用 py -3 --version。

没有 Python 3 时，可先从 Python 官网安装，重新打开终端后重新输入 Key 和必要的连接配置，再回到测试文件夹。不要让助手为本测试自动安装软件。

5. 启动并确认连接

在测试文件夹中启动 Claude Code，再检查地址、凭据来源、模型和当前目录。

claude --permission-mode manual --tools Read,Bash,Edit,Write --strict-mcp-config

首次测试使用手动权限模式，只启用读取、编辑、写入和终端工具，不加载其他 MCP 配置。遇到文件夹信任界面，先核对路径确实是刚才创建的 asiorb-claude-test…，按方向键 ↓ 选中 Yes, I trust this folder，再按回车。选中 No, exit 会退出程序。

进入 Claude Code 的对话界面后才能输入下面的指令；普通终端的 % 或 $ 提示符下不能执行 /status。请求写入脚本或运行命令时，核对当前测试目录与操作内容，再选择允许本次执行。界面底部应显示 manual mode。

/status

• Anthropic base URL：https://api.asiorb.com:8443。
• Auth token：凭据来源应为 ANTHROPIC_AUTH_TOKEN，不要展示完整密钥。
• 模型：应对应第 3 步选择的模型；最终请求 ID 和型号在本站消费记录核对。
• 目录：当前测试文件夹，不能误入其他项目。

核对后按 Esc 返回对话，再发送下一步任务。如果仍要求登录官方账户，先退出并检查 Key、同一窗口的环境变量和已有 settings.json，不要继续按订阅账户测试。

状态页只证明配置已加载；收到真实回复并完成工具测试，才能确认本次接入成功。不要用“你是什么模型”的回答作为模型证明。

6. 测试读取文件

把下面的任务粘贴到 Claude Code 的对话输入框。发送后会按模型实际用量扣费。

请使用本机文件工具读取当前测试文件夹的 test.txt。
告诉我实际读取到的数字及它们的总和，暂时不要修改文件。
只操作当前测试文件夹，不调用 Computer Use，不操作其他应用。

预期：工具记录显示实际读取了 test.txt，数字为 17、28、35，总和为 80。只收到一句“80”，还不能证明文件工具执行成功。

7. 测试写入、运行与读回

读取成功后继续发送任务，检查它能否创建脚本、实际执行，并读回保存的结果。

请继续完成本机文件测试，只操作当前测试文件夹：
1. 重新读取 test.txt，创建 sum_numbers.py。使用 Python 标准库，以脚本所在目录定位 test.txt，计算所有数字的总和，将总和写入同目录的 result.txt，并打印总和。
2. 实际运行 python3 sum_numbers.py。
3. 再使用文件工具读取 result.txt，核对实际保存的内容。
不要修改 test.txt，不安装软件，不调用 Computer Use，不操作其他应用或目录。请实际执行，不要只提供代码；如有错误请如实报告。

预期：工具记录显示创建 sum_numbers.py、实际运行脚本，终端输出 80，随后读取 result.txt 也是 80。原始 test.txt 应保持不变。

完成后按 Ctrl + C，按界面提示退出；如果只中断了操作，再按一次。回到普通终端提示符后，独立检查实际文件。

cat test.txt
cat sum_numbers.py
cat result.txt

依次应看到三行原始数字、Python 脚本内容和结果 80。发生错误就停在当前步骤，保留报错与请求编号，不要把助手的文字说明当成执行结果。

8. 核对消费与验收

按测试时间核对 ASIORB 消费记录。一次任务可能包含多轮模型请求，对应多条记录。

1. 打开本站消费记录，按刚才测试的时间查找请求，核对模型 ID、用量、人民币费用与结算状态。
2. 一项任务可能多次请求模型，因此允许出现多条记录；读取本机文件本身不单独产生模型费用，模型处理工具结果会产生新的用量。
3. 如遇超时、回复不完整或正在对账，先检查原请求状态，记录 request_id，再决定是否继续，避免反复发送同一任务。

通过后即可结束测试，再用于日常任务。这个结果只覆盖本次电脑、Key、模型和基础流程，不代表所有模型或高级功能都已验收。

下次使用与问题排查

临时配置只对当前终端窗口有效。下面说明重新启动、更换模型及处理常见错误的方法。

1. 打开新终端，重新执行第 2 步输入 Key 的命令。
2. 回到第 3 步选择模型并执行配置；这些环境变量不会跨终端自动保存。
3. 进入自己的项目文件夹，运行 claude --permission-mode manual，再用 /status 核对。

cd "/你的项目路径" && claude --permission-mode manual

更换模型时，退出 Claude Code，重新执行第 3 步对应模型的配置，再启动。这样主会话和辅助任务会保持一致。