1. 为什么我最终把 Claude Code 装进了终端Claude Code 是 Anthropic 官方推出的 CLI 编程助手它直接跑在你的终端里能读整个项目、改文件、跑命令、做 Git 操作。和网页版聊天最大的区别是它理解的是你本地真实的代码库而不是你粘贴进去的片段。适合谁适合每天在终端里敲命令、用 Git 管版本、希望 AI 直接动手改代码而不是只给建议的开发者。我一开始也用过 Cursor 这类 AI 编辑器补全确实爽但计费规则经常变、额度黑箱、用着用着就提示要升级心里没底。Claude Code 的计费逻辑是按 token 走问多问少自己控制而且它本质是个 CLI可以接符合 Anthropic 接口规范的模型服务这一点对国内开发者特别关键——你可以把请求指向兼容 Anthropic 协议的网关用国内可直连的模型成本和延迟都可控。这篇就聚焦一件事从零把 Claude Code 装好、配好、跑通。全程只需要 Node.js、Git 和一个 API Key。我会给出可复制的 npm 命令、settings.json 配置骨架、环境变量设置以及验证 CLI 是否真的能调通模型的具体动作。跟着做十分钟内你应该能在终端里让 Claude Code 帮你改第一个文件。2. 装之前先把 TaoToken 的 Key 和地址准备好Claude Code 默认连 Anthropic 官方 API但国内网络环境下直连体验不稳定而且官方账号和支付门槛也不低。更实际的做法是用一个兼容 Anthropic 接口规范的网关来承接请求Claude Code 这边只改一个环境变量就能切换。TaoToken 就是这样一个入口它提供 Anthropic 兼容的 API 地址和 KeyClaude Code 不需要改源码只要把ANTHROPIC_BASE_URL指向它、把ANTHROPIC_API_KEY换成它发的 Key 就行。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。你需要提前做两件事第一注册并拿到 API Key。登录后进控制台在 API Keys 页面创建一个新 Key复制出来先存到记事本后面配置要用。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。第二确认你要用的模型名。Claude Code 启动时会带一个默认模型参数如果你走网关需要在配置里显式指定网关支持的模型标识否则可能报模型不存在。具体支持哪些模型看接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意Key 只显示一次创建后立刻复制。丢了就重新建一个别去猜。3. 从 npm 安装到 settings.json 的完整配置3.1 确认 Node.js 和 Git 就绪Claude Code 是 npm 包先确认环境。打开终端Windows 用 PowerShellmacOS/Linux 用默认终端执行node -v npm -v git --versionNode.js 建议 18 以上npm 随 Node 一起装。Git 在 Windows 上尤其重要因为 Claude Code 内部会调用 bash需要指定 Git Bash 的路径。如果git --version没输出先去装 Git for Windows。3.2 全局安装 Claude Code一条命令搞定npm install -g anthropic-ai/claude-code装完验证版本claude --version能打印出版本号就说明 CLI 本体装好了。如果提示claude: command not found多半是 npm 全局 bin 目录没进 PATH用npm config get prefix看一下路径把它加到环境变量里。3.3 配置 API Key 和网关地址Claude Code 读两个关键环境变量ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL。Windows 上用setx写入用户级环境变量setx ANTHROPIC_API_KEY 你的TaoToken Key setx ANTHROPIC_BASE_URL https://taotoken.net/apimacOS/Linux 写进 shell 配置文件echo export ANTHROPIC_API_KEY你的TaoToken Key ~/.zshrc echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc source ~/.zshrcWindows 上还要补一个 Git Bash 路径否则 Claude Code 调 bash 会失败setx CLAUDE_CODE_GIT_BASH_PATH D:\Program Files\Git\bin\bash.exe路径按你实际安装位置改。设完环境变量要重开终端才生效。3.4 settings.json 配置骨架除了环境变量Claude Code 还支持项目级或用户级的settings.json。用户级配置放在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。一个可用的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, ANTHROPIC_MODEL: 你选用的模型标识 }, permissions: { allow: [], deny: [] } }env块里的变量会注入到 Claude Code 运行时优先级高于系统环境变量适合把配置固定在项目里。ANTHROPIC_MODEL填网关支持的模型名不填会用默认值可能对不上。permissions用来控制哪些命令允许自动执行初次使用建议留空让 Claude Code 每次操作前问你。提示如果你在多个项目里用不同模型可以把 settings.json 放在项目根目录的.claude/下做项目级覆盖。4. 验证 CLI 是否真的调通了模型配置写完别急着写代码先做一次最小验证。在任意目录打开终端输入claude第一次启动会进入交互界面可能提示你选择主题或确认目录。直接输入一句简单的话比如帮我看看当前目录下有哪些文件并解释 package.json 的作用如果配置正确Claude Code 会读取目录、列出文件、给出解释。这一步能跑通说明 Key、Base URL、模型名三者都对上了。再做一个更硬的验证——让它实际改一个文件。新建一个测试目录mkdir claude-test cd claude-test echo console.log(hello) index.js claude在交互界面里输入把 index.js 里的 hello 改成 hello claude codeClaude Code 会展示它打算执行的修改你确认后它写入文件。然后cat index.js看结果。文件真的被改了就证明整条链路——CLI、网关、模型、文件操作——全部打通。如果你更想先在网页里确认模型可用性可以打开模型对话页面 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息试试确认 Key 本身没问题再回到终端排查。5. 装完跑不通这几个坑我踩过报 401 或 invalid api key九成是 Key 复制时带了空格或者环境变量没生效。重开终端用echo $ANTHROPIC_API_KEYWindows 用echo %ANTHROPIC_API_KEY%确认值对不对。settings.json 和环境变量同时存在时检查有没有互相覆盖。报 model not foundANTHROPIC_MODEL填的模型名网关不认。去接入文档核对可用模型标识别凭记忆填。Windows 上提示 bash 找不到CLAUDE_CODE_GIT_BASH_PATH没设或路径写错。确认bash.exe真实存在路径用反斜杠别加引号以外的多余字符。npm 安装卡住或超时换 npm 镜像源npm config set registry https://registry.npmmirror.com再重装。启动后一直转圈没响应多半是 Base URL 写错比如漏了/api或多了斜杠。正确值是https://taotoken.net/api不要在后面再加/v1之类。权限被拒Claude Code 默认对文件写入和命令执行要确认。如果你在 settings.json 的deny里误加了规则会直接拦掉。清空deny数组再试。排查顺序建议先确认 Key 有效网页对话验证再确认 Base URL 正确最后确认模型名匹配。三步里哪步断了报错信息都会指向对应环节。6. 接下来怎么用得更顺装好只是起点。日常编码里Claude Code 最舒服的用法是把它当成一个能动手的结对伙伴让它读报错、定位文件、改完跑测试。如果你打算长期在项目里用它做重构、写测试、处理 Git 历史建议了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按用量规划比零散调用更省心。Key 管理和额度查看都在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入细节和模型清单看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后给一个实用习惯每次开新项目先在项目根目录建.claude/settings.json把模型和权限固定下来这样换机器或换终端都不用重新配环境变量。配置一次后面只管写代码。
【Claude Code】Claude Code 安装指南：从 npm 到 API Key 配置的完整流程
1. 为什么我最终把 Claude Code 装进了终端Claude Code 是 Anthropic 官方推出的 CLI 编程助手它直接跑在你的终端里能读整个项目、改文件、跑命令、做 Git 操作。和网页版聊天最大的区别是它理解的是你本地真实的代码库而不是你粘贴进去的片段。适合谁适合每天在终端里敲命令、用 Git 管版本、希望 AI 直接动手改代码而不是只给建议的开发者。我一开始也用过 Cursor 这类 AI 编辑器补全确实爽但计费规则经常变、额度黑箱、用着用着就提示要升级心里没底。Claude Code 的计费逻辑是按 token 走问多问少自己控制而且它本质是个 CLI可以接符合 Anthropic 接口规范的模型服务这一点对国内开发者特别关键——你可以把请求指向兼容 Anthropic 协议的网关用国内可直连的模型成本和延迟都可控。这篇就聚焦一件事从零把 Claude Code 装好、配好、跑通。全程只需要 Node.js、Git 和一个 API Key。我会给出可复制的 npm 命令、settings.json 配置骨架、环境变量设置以及验证 CLI 是否真的能调通模型的具体动作。跟着做十分钟内你应该能在终端里让 Claude Code 帮你改第一个文件。2. 装之前先把 TaoToken 的 Key 和地址准备好Claude Code 默认连 Anthropic 官方 API但国内网络环境下直连体验不稳定而且官方账号和支付门槛也不低。更实际的做法是用一个兼容 Anthropic 接口规范的网关来承接请求Claude Code 这边只改一个环境变量就能切换。TaoToken 就是这样一个入口它提供 Anthropic 兼容的 API 地址和 KeyClaude Code 不需要改源码只要把ANTHROPIC_BASE_URL指向它、把ANTHROPIC_API_KEY换成它发的 Key 就行。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 。你需要提前做两件事第一注册并拿到 API Key。登录后进控制台在 API Keys 页面创建一个新 Key复制出来先存到记事本后面配置要用。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。第二确认你要用的模型名。Claude Code 启动时会带一个默认模型参数如果你走网关需要在配置里显式指定网关支持的模型标识否则可能报模型不存在。具体支持哪些模型看接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意Key 只显示一次创建后立刻复制。丢了就重新建一个别去猜。3. 从 npm 安装到 settings.json 的完整配置3.1 确认 Node.js 和 Git 就绪Claude Code 是 npm 包先确认环境。打开终端Windows 用 PowerShellmacOS/Linux 用默认终端执行node -v npm -v git --versionNode.js 建议 18 以上npm 随 Node 一起装。Git 在 Windows 上尤其重要因为 Claude Code 内部会调用 bash需要指定 Git Bash 的路径。如果git --version没输出先去装 Git for Windows。3.2 全局安装 Claude Code一条命令搞定npm install -g anthropic-ai/claude-code装完验证版本claude --version能打印出版本号就说明 CLI 本体装好了。如果提示claude: command not found多半是 npm 全局 bin 目录没进 PATH用npm config get prefix看一下路径把它加到环境变量里。3.3 配置 API Key 和网关地址Claude Code 读两个关键环境变量ANTHROPIC_API_KEY和ANTHROPIC_BASE_URL。Windows 上用setx写入用户级环境变量setx ANTHROPIC_API_KEY 你的TaoToken Key setx ANTHROPIC_BASE_URL https://taotoken.net/apimacOS/Linux 写进 shell 配置文件echo export ANTHROPIC_API_KEY你的TaoToken Key ~/.zshrc echo export ANTHROPIC_BASE_URLhttps://taotoken.net/api ~/.zshrc source ~/.zshrcWindows 上还要补一个 Git Bash 路径否则 Claude Code 调 bash 会失败setx CLAUDE_CODE_GIT_BASH_PATH D:\Program Files\Git\bin\bash.exe路径按你实际安装位置改。设完环境变量要重开终端才生效。3.4 settings.json 配置骨架除了环境变量Claude Code 还支持项目级或用户级的settings.json。用户级配置放在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。一个可用的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, ANTHROPIC_MODEL: 你选用的模型标识 }, permissions: { allow: [], deny: [] } }env块里的变量会注入到 Claude Code 运行时优先级高于系统环境变量适合把配置固定在项目里。ANTHROPIC_MODEL填网关支持的模型名不填会用默认值可能对不上。permissions用来控制哪些命令允许自动执行初次使用建议留空让 Claude Code 每次操作前问你。提示如果你在多个项目里用不同模型可以把 settings.json 放在项目根目录的.claude/下做项目级覆盖。4. 验证 CLI 是否真的调通了模型配置写完别急着写代码先做一次最小验证。在任意目录打开终端输入claude第一次启动会进入交互界面可能提示你选择主题或确认目录。直接输入一句简单的话比如帮我看看当前目录下有哪些文件并解释 package.json 的作用如果配置正确Claude Code 会读取目录、列出文件、给出解释。这一步能跑通说明 Key、Base URL、模型名三者都对上了。再做一个更硬的验证——让它实际改一个文件。新建一个测试目录mkdir claude-test cd claude-test echo console.log(hello) index.js claude在交互界面里输入把 index.js 里的 hello 改成 hello claude codeClaude Code 会展示它打算执行的修改你确认后它写入文件。然后cat index.js看结果。文件真的被改了就证明整条链路——CLI、网关、模型、文件操作——全部打通。如果你更想先在网页里确认模型可用性可以打开模型对话页面 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息试试确认 Key 本身没问题再回到终端排查。5. 装完跑不通这几个坑我踩过报 401 或 invalid api key九成是 Key 复制时带了空格或者环境变量没生效。重开终端用echo $ANTHROPIC_API_KEYWindows 用echo %ANTHROPIC_API_KEY%确认值对不对。settings.json 和环境变量同时存在时检查有没有互相覆盖。报 model not foundANTHROPIC_MODEL填的模型名网关不认。去接入文档核对可用模型标识别凭记忆填。Windows 上提示 bash 找不到CLAUDE_CODE_GIT_BASH_PATH没设或路径写错。确认bash.exe真实存在路径用反斜杠别加引号以外的多余字符。npm 安装卡住或超时换 npm 镜像源npm config set registry https://registry.npmmirror.com再重装。启动后一直转圈没响应多半是 Base URL 写错比如漏了/api或多了斜杠。正确值是https://taotoken.net/api不要在后面再加/v1之类。权限被拒Claude Code 默认对文件写入和命令执行要确认。如果你在 settings.json 的deny里误加了规则会直接拦掉。清空deny数组再试。排查顺序建议先确认 Key 有效网页对话验证再确认 Base URL 正确最后确认模型名匹配。三步里哪步断了报错信息都会指向对应环节。6. 接下来怎么用得更顺装好只是起点。日常编码里Claude Code 最舒服的用法是把它当成一个能动手的结对伙伴让它读报错、定位文件、改完跑测试。如果你打算长期在项目里用它做重构、写测试、处理 Git 历史建议了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按用量规划比零散调用更省心。Key 管理和额度查看都在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入细节和模型清单看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后给一个实用习惯每次开新项目先在项目根目录建.claude/settings.json把模型和权限固定下来这样换机器或换终端都不用重新配环境变量。配置一次后面只管写代码。
