クイックスタート
3 ステップでエージェント用ワークスペースを起動します。
前提条件
- ウェイトリストに登録 — NanoTerm はクローズドベータ中です。メールアドレスを入れて登録、順次承認します。
- 承認メールを待つ — 順番が来たら「You're in — finish sign-up」というメールが届きます。リンクからパスワードを設定してください。
- nanoterm.dev/signin にサインイン → API Keys ページで API キーを発行。
既にあなたの組織の管理者が NanoTerm を利用している場合、招待リンクはウェイトリストを迂回します。管理者に招待してもらえれば、招待メールからそのままサインアップできます。
ステップ 1: インストール
- CLI
- TypeScript SDK
- curl
npm install -g @nanoterm/cli
nanoterm auth set-key nt_your_api_key
npm install @nanoterm/sdk
インストール不要。API キーを Authorization ヘッダーに付けるだけです。
ステップ 2: ワークスペースを作成
- CLI
- TypeScript
- curl
nanoterm ws create --name my-agent --image ubuntu:22.04
# ✓ Workspace created: ws_a1b2c3d4
import { NanoTermClient } from '@nanoterm/sdk'
const client = new NanoTermClient({
apiKey: 'nt_your_api_key'
})
const ws = await client.createWorkspace({
name: 'my-agent',
image: 'ubuntu:22.04'
})
console.log(ws.id) // ws_a1b2c3d4
curl -X POST https://api.nanoterm.dev/api/workspaces \
-H 'Authorization: Bearer nt_your_api_key' \
-H 'Content-Type: application/json' \
-d '{"name": "my-agent", "image": "ubuntu:22.04"}'
ステップ 3: コマンドを実行
- CLI
- TypeScript
- curl
# ワンショット実行
nanoterm exec ws_a1b2c3d4 -- uname -a
# Linux nanoterm 5.15.0 x86_64 GNU/Linux
# 対話型ターミナル
nanoterm attach ws_a1b2c3d4
const result = await client.exec(ws.id, ['uname', '-a'])
console.log(result.stdout)
// Linux nanoterm 5.15.0 x86_64 GNU/Linux
console.log(result.exitCode)
// 0
curl -X POST https://api.nanoterm.dev/api/workspaces/ws_a1b2c3d4/exec \
-H 'Authorization: Bearer nt_your_api_key' \
-H 'Content-Type: application/json' \
-d '{"command": ["uname", "-a"]}'
ステップ 4（任意）: コーディングエージェントを動かす
NanoTerm の主な用途は、Claude Code や Codex CLI のエージェントを
ワークスペース 内 で動かすことです。エージェントには認証情報が
必要なので、組織シークレットとして 1 度保存しておけば、claude-code
/ codex イメージから作成された全ワークスペースに自動注入されます。
- Claude（サブスクリプション）
- Claude（API キー）
- Codex
nanoterm secrets auth-claude
# ブラウザが開きます。完了するとあなたの組織に認証情報が保存され、
# 以後すべてのワークスペースに自動注入されます。
nanoterm ws create --image ghcr.io/momenntal/nanoterm-claude-code
nanoterm shell <ws-id>
# agent@ws-…:/workspace$ claude
nanoterm secrets set ANTHROPIC_API_KEY \
--from-env ANTHROPIC_API_KEY
nanoterm ws create --image ghcr.io/momenntal/nanoterm-claude-code
nanoterm secrets auth-codex --api-key sk-...
nanoterm ws create --image ghcr.io/momenntal/nanoterm-codex
nanoterm secrets status で各プロバイダーの認証状況を確認できます。