← Retour aux guides

Claude Code终端实战：从零配好iTerm2、换行与59API接入

先确定目标：好读、好输入、费用可控

配置Claude Code终端，不必从复杂主题和插件开始。更实用的顺序是：确认命令可用，解决中文显示和多行输入，再接入API，最后用一个小任务验证。下面以macOS、iTerm2和默认zsh为例，搭建适合日常改代码的工作环境。

第一步：安装工具，确认运行环境

如果已经安装Homebrew，可执行brew install --cask iterm2安装iTerm2。启动后，在已有当前Node.js LTS的环境中执行npm install -g @anthropic-ai/claude-code。也可以按照Claude Code官方安装说明选择原生安装方式，不必同时安装两套。

随后运行claude --version和claude doctor。前者确认命令存在，后者检查安装状态。若出现权限错误，不要直接给全局安装命令加sudo；先检查Node.js安装位置和当前用户的目录权限。

第二步：只调整真正影响体验的iTerm2设置

• 字体：在设置的配置文件文字页选择等宽字体，例如Menlo，字号先用14至16。检查中文、英文路径与代码缩进是否清楚；没有特殊图标需求，就不必额外安装图标字体。
• 配色：选择对比清晰的主题，先关闭透明背景。长时间阅读工具输出时，稳定的背景通常比视觉特效更重要。
• 滚动缓冲：在配置文件的终端设置中，将缓冲行数设为10000左右，方便回看输出，不必一开始就启用无限历史。
• 按词移动：需要时，在按键设置中把左侧Option配置为Esc+，再测试Option加方向键。若影响特殊字符输入，保留另一侧Option的默认行为。

先不要导入整套快捷键预设。每改一项就测试一次，能避免终端快捷键、系统输入法和Claude Code按键互相冲突。

第三步：解决多行提示与分屏操作

进入项目目录后运行claude，在交互界面执行/terminal-setup，按照提示完成终端配置；如有要求，重新打开会话。然后测试Shift加回车能否换行。不同终端版本可能存在差异，若仍不生效，可使用Claude Code支持的反斜杠加回车输入多行内容。

把任务写成三段：目标、允许修改的范围、验收方式，比一整段长指令更容易检查。使用Command加D左右分屏，让Claude Code占一侧，另一侧保留普通终端，用于查看差异和运行测试。两个窗格不要同时启动修改同一批文件的自动任务。

第四步：接入59API，但不要把密钥写进项目

对希望控制试用成本的开发者，59API提供按量付费入口，API基础地址为https://api.59api.com。先查看控制台的Claude Code接入说明，确认Anthropic兼容入口和认证方式；不要把其他工具使用的OpenAI兼容路径直接照搬过来。

如果控制台采用该基础地址与令牌认证，可在当前zsh会话依次执行export ANTHROPIC_BASE_URL='https://api.59api.com'、read -rs 'ANTHROPIC_AUTH_TOKEN?请输入59API密钥：'，输入密钥并回车，再执行export ANTHROPIC_AUTH_TOKEN。这种读取方式不会回显密钥，也避免把密钥文本直接写进命令历史。

若平台指定专用路径或不同认证变量，以接入说明为准。不要同时保留相互冲突的旧配置，也不要把真实密钥放进仓库、截图或共享配置。当前会话变量适合先验证，长期使用再配置受保护的凭据存储。

第五步：用小任务验证模型、连接与账单

重新启动Claude Code，运行/status检查可见的连接信息，再提交一个范围很小的任务，例如“只阅读README，概述项目启动步骤，不修改文件”。随后到59API控制台检查请求是否成功、使用了什么模型以及实际费用。

选择模型时，可以比较Claude Sonnet 5.5与Claude Opus 5.5的报价和任务表现；配置时使用平台给出的实际模型标识，不要假设展示名称就是API参数。先完成一次小请求，再逐步增加上下文，比直接扫描整个仓库更容易定位成本来源。

按59API提供的服务信息，平台主打低价、原生官方品质模型且不降级，并提供推荐返利。实际是否划算，仍应结合输入输出单价、缓存计费和任务总费用判断，而不是只看一次请求的标价。

最后：把配置变成可重复的工作流

每天开工先确认项目目录与Git状态，再启动Claude Code；完成任务后查看差异并运行相关测试。如果出现401，优先检查认证；404先核对接口路径和模型标识；连接超时则检查网络。排查时只记录错误信息，不打印完整密钥。

这套配置的重点不是让终端更花哨，而是让输入、验证和费用检查形成闭环。如果想低成本试跑，可以先注册59API，用小预算完成上述验证，再决定是否扩大使用。

Tarifs · Docs